Prox OS Internal Docs
PlatformArchitectureShell

Shortcut And Display Options

Display-related preferences are now split into product scopes:

Display Options Boundary

Display-related preferences are now split into product scopes:

ScopeSettings surfaceOwns
PlatformPlatform OptionsPlatform theme, navigation placement, Alma placement and rail width, Inspector side rule, and safety default.
RuntimeDisplay OptionsRuntime theme override, Runtime Command Strip placement and flow, Runtime Dock position and size, screensaver, cursor, density, and wallpaper.
StudioStudio optionsCurrent Studio layout density, grid behavior, scene preview behavior, and engine-specific display controls.
AppApp-owned optionsFocus, page, panel, window, compact, or app-specific presentation choices.

Desktop Runtime no longer owns Display Options as a private app-only concept. The old window presentation can remain as an Official System App surface, but the source of truth should be shell settings, Studio settings, and app presentation contracts. Runtime theme defaults to platform so the Runtime inherits Platform Options until a user explicitly chooses system, light, or dark for that Runtime.

Shortcut Scopes

Shortcuts follow the same global/local split:

  • Global shortcuts: Universal Command Palette, Switcher, Prox Mission Control, and global display controls.
  • Studio shortcuts: engine-specific actions while that Studio is active.
  • Scene shortcuts: layout-state switching inside the active Studio.
  • App shortcuts: focused App behavior.
  • Input, editor, and iframe shortcuts: local typing/editing behavior wins unless a focused surface delegates explicitly.

Current switching shortcuts:

Ctrl/Cmd + K            Universal Command Palette
Ctrl/Cmd + Shift + K    Switcher
Ctrl + Shift + Up       Prox Mission Control
Ctrl + ,                Previous Scene
Ctrl + .                Next Scene
Ctrl + Shift + ,        Previous Studio session
Ctrl + Shift + .        Next Studio session

Boss Mode

Boss Mode is a playful focus shortcut, not a deception feature. It exists as a quick switch from entertainment, trading, or feeds into a serious study surface.

Current shortcut:

Control + Shift + 0

When enabled in Display Options, the shortcut opens or focuses /app-edu/ts-fullstack with the #study-mode route hint and shows a system toast. It avoids triggering while an input, textarea, select, or contenteditable target is focused.

Current Boundary

  • No full shortcut registry package exists yet.
  • Boss Mode is implemented as a small shell listener beside the existing global shortcut component because GlobalShortcuts.tsx is intentionally kept small.
  • It does not minimize or close other windows.
  • It does not change auth, permissions, or browser history outside the normal app open flow.

Future work can move global shortcut definitions into a dedicated shortcut registry and let apps declare scoped shortcut affordances through the app contract.

On this page