DeskRealm v0.5.9

DeskRealm v0.5.9

Added

• Added the main DeskRealm window, opened from the tray or tray icon double-click, while keeping the default runtime tray-first.
• Added first-run onboarding inside the main window so fresh installs explain DeskRealm before the first automatic Desktop switch.
• Added a safe first-run choice to associate the original Windows Desktop with one realm without moving files.
• Added a skip path that creates DeskRealm - Original Desktop.lnk shortcuts inside managed realms so the original Desktop remains easy to find.
• Added a modern dark/cyan DeskRealm UI shell with custom navigation, rounded cards, custom buttons, status pills and dark in-app window chrome.
• Added the DeskRealm DR logo as the compiled executable icon, tray notification icon and main window icon.
• Added UI access to the main tray actions: refresh, sync names, save/restore icon layout, restore original Desktop, startup toggle, open realms/config/logs and quit.
• Added capture-based hotkey fields in the Hotkeys tab. Click a field, hold one or two modifiers, then press the main key to record the shortcut.
• Added the dedicated Icon Layout tab with collapsible realm rows and child rows for saved display-topology layout variants.
• Added layout locks, realm locks and variant locks from the UI.
• Added locked-layout autosave merge mode: existing icon positions stay protected, while newly added icons can be captured once.
• Added confirmation-gated manual overwrite for locked layouts.
• Added confirmation-gated Delete for saved layout variants. Deleting a variant removes only DeskRealm layout metadata, never Desktop files or icons.

Changed

• Closing the DeskRealm window with the cross now hides it back to the tray. Quit DeskRealm is the explicit app exit.
• Default desktop hotkeys now avoid common Windows/app conflicts: desktop 1-4 use Win+Shift+X, Win+Shift+C, Win+Shift+B, Win+Shift+N.
• Existing customized hotkeys are preserved during migration; only untouched legacy defaults are replaced.
• enabled is now presented as Enable realm switching automation. When disabled, automatic realm switching and DeskRealm desktop hotkeys are paused without deleting data.
• Hotkey capture now stops immediately on the first non-modifier key. Releasing only modifier keys cancels capture and restores the previous value.
• The Icon Layout tab now shows saved variants from each layout JSON file instead of a single combined layout row.
• Variant rows show each persisted display working area separately using DisplayX.workingWidth / DisplayX.workingHeight, with ✅ marking the primary display.
• Config version is now 10, adding lock dictionaries for layouts, realms and exact layout variants.
• Realm locks are stored by normalized realm path so the lock applies to every desktop/layout assigned to that realm.
• Variant locks are stored as {virtual-desktop-guid}|{display-topology-key}.
• DeskRealm public UI strings remain English.
• The tray icon now loads the embedded application icon from the compiled executable instead of the generic Windows application icon.

Fixed

• Fixed ambiguous pause behavior where DeskRealm desktop hotkeys could still switch realms while DeskRealm was disabled.
• Fixed hotkey capture so later modifier keys cannot be appended after a main key has already been recorded.
• Fixed modifier-only capture attempts so they cancel cleanly when modifiers are released.
• Fixed visual artifacts around custom buttons by replacing native Button rendering with a pure owner-painted control.
• Fixed clipped text, clipped child-row borders and residual WinForms repaint artifacts in the modern UI.
• Fixed the bright native title bar by replacing it with custom dark in-app chrome.
• Fixed nullable WinForms font construction warnings in the Windows release build.

Safety

• The first automatic Desktop switch is delayed until the first-run decision is completed.
• First-run onboarding no longer moves Desktop files. Association points the selected realm to the original Desktop path.
• Shortcut creation failures are explicit and do not silently complete onboarding.
• Locked layouts refuse silent overwrite. Autosave can only merge new icons; full overwrite requires confirmation.
• Locked realms protect all child layout variants assigned to that realm and disable child destructive actions.
• Variant deletion is scoped to DeskRealm metadata and requires confirmation.

Documentation

• Updated README, CHANGELOG, release notes, patch notes, installation, configuration, architecture, safety, smoke test, TODO and technical audit for the full v0.5.8 -> v0.5.9 delta.
• Documented the branded executable/tray icon integration in the release documentation.

---

Generated from CHANGELOG.md by .local-tools/Publish-DeskRealmRelease.ps1.