salvacybersec/CodeNomad
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Files
0ba1371348ea86daf55fcde694447de212a88702
CodeNomad/docs/features/wake-lock/SPECIFICATION.md
Shantur Rathore 4a1147788c fix(wake-lock): allow display sleep during active work 
Prevent idle system sleep on supported desktop runtimes without intentionally keeping the display awake. Narrow wake-lock activation to true active work states and drop the web screen-wake fallback where the platform cannot provide system-sleep-only behavior.
2026-04-21 20:58:40 +01:00

995 B
Raw Blame History

Wake Lock Behavior

Product Rule

CodeNomad only requests a wake lock for qualifying active work that is already running and can continue without continuous foreground interaction. The goal is to prevent idle system sleep where the platform supports that behavior without intentionally keeping the display awake.

Wake lock must not be held when work is idle, paused, completed, cancelled, failed, or waiting for new user input or permission before it can continue.

Platform Behavior

  • Electron: request system-sleep-only behavior with prevent-app-suspension.
  • Tauri: request the native keep-awake mode with display: false, idle: true, and sleep: false.
  • Web: do not fall back to navigator.wakeLock.request("screen"); if a true system-sleep-only primitive is unavailable, CodeNomad degrades to no wake lock.

Release Expectations

Wake lock should be released promptly when qualifying active work ends or when the app cleans up the active session lifecycle.