Desktop Material

Attention accommodations

Desktop Material provides five independently toggleable interface accommodations in Settings → Attention accommodations. They are all off by default, persist locally, and do not diagnose, assess, or make a medical claim about the person using the app.

Modes

Persistence and privacy

The versioned attention-accommodation-preferences record contains only the five booleans, the bounded next-action text, a defer timestamp, and the last settings-change timestamp. Invalid or future-shaped values are coerced to safe defaults. No network request is made and no activity text is exported or sent to diagnostics.

Accessibility and localization

Each mode is a keyboard-reachable checkbox with an accessible description. The next-action field and defer selector have labels and bounded native controls. Runtime facts use a polite status region; Momentum is dismissible and never blocks the workspace. English, playful Hong Kong Cantonese, and bilingual copy are selected through the existing language preference, with the existing per-language funny-level setting used only to choose framing copy. Facts, durations, and the user's next action remain unchanged by tone.

Failure boundaries

If local storage cannot be read, all modes resolve to their off-by-default values. If a next-action value is malformed or too long, it is trimmed or cleared rather than partially applied. A missing layout region is left fully usable; Focus never hides it. Momentum and Time awareness are non-blocking and can be unavailable without preventing the app from starting.

Verification status

The implementation, local persistence, English/Cantonese/bilingual copy, settings search, command-palette registration, and seven focused unit/UI tests are verified in app/test/unit/attention-accommodation-test.tsx. The focused test also removes one required mode from a copy of the hand-written five-mode inventory and verifies that the exact inventory check rejects it before validating the restored list. It also proves hidden overlays are excluded from Focus and focused descendants resolve to real top-level workspace regions.

The exact 74159be0d9d4da10254ad18873496bb9bd1f5928 production build was driven on a cheap-Lowlevel hidden Windows desktop with an isolated profile and disposable repository. Every mode was enabled, conditional controls were reached by keyboard, and a restart proved Focus kept the normally hidden repository-drop overlay invisible while Time awareness continued reporting live session and activity facts. Release packaging remains pending and is not implied by this unpackaged production-build evidence.

Current built captures

All five attention accommodations enabled in Settings

One thing at a time and Momentum conditional controls

Focus workspace with the hidden repository-drop overlay still hidden

Suggested articles

專注與節奏調節

Desktop Material 喺「設定 → 專注與節奏調節」提供五個可以獨立開關嘅介面 調節。全部預設關閉,資料只會留喺本機,亦都唔係診斷、評估或者醫療功能。

所有控制項都可以用鍵盤操作,狀態用 polite live region 宣布,語氣設定只改表達 方式,唔改事實、時間或者用戶輸入嘅下一步。