Desktop Runtime

Desktop Runtime is the primary OS Runtime host. It owns multi-window app work, the Runtime Dock, active and minimized window state, runtime overlays, screensaver scope, cursor scope, and runtime-local Display Options.

URL Model

Route	Status	Meaning
`/@user/runtime/:runtimeSlug`	Current canonical route	Owner-scoped Runtime root.
`/@esmadrider/runtime/os`	Seeded mock route	First mock Runtime for the `@esmadrider` Universe.
`/@user/runtime/:runtimeSlug/:runtimeMode`	Current canonical route	Runtime Command Strip modes such as Data, Apps, Automations, Collect, Settings, and Publish.
`/@user/runtime/:runtimeSlug/app-*`	Runtime app route family	Future app routes can remain scoped to the active Runtime object.
`/@user/studios/:studioSlug`	Studio route	Studio containers use runtime chrome but do not own Desktop Runtime window state.

Runtimes are repo-like objects owned by a user or organization. os is the default seeded slug and can later become any user-chosen Runtime name.

Product Boundaries

Concept	Runtime relationship
Platform Navigation	Outside the Runtime. It links to Launchpad, Universe, App Store, Community, user menu, and Platform Options.
Alma and Inspector	Platform-level surfaces that can read Runtime context but are positioned by Platform Options.
Runtime Command Strip	Inside the Runtime or Studio frame. It owns mode tabs, placement, flow, and About menu.
Runtime Dock	Inside OS Runtime only. It owns pinned, running, active, and minimized app state.
Display Options	Runtime-local panel for command strip, Dock, screensaver, cursor, density, and wallpaper.
Platform Options	Platform-level panel for Alma side, rail width, Inspector side rule, platform navigation position and flow, and safety default.

Runtime Dock

State	Behavior
Pinned	Shown first and never duplicated.
Running	Shown after a divider when not already pinned.
Active	Derived from the focused Runtime window.
Minimized	Rendered with a quieter state when the window manager exposes minimized state.
Position	`top`, `bottom`, `left`, or `right` inside the Runtime viewport.
Size	Runtime-local numeric preference that changes item size and container thickness immediately.

Runtime Overlay Boundary

Screensaver and cursor effects are scoped to the OS Runtime content layer. They must not cover Platform Navigation, Alma, Inspector, Runtime Command Strip, Community, Universe, or Studio routes.

App Launch And Window Rules

Host context	Window rule	Launch path
Launchpad	One singleton app window at a time.	Shared app launch path.
Studio surfaces	One singleton app window at a time when outside OS Runtime.	Shared app launch path with Studio projection later.
App Store actions	One singleton app window at a time when outside OS Runtime.	Shared app launch path, falling back to route launch.
Cmd+K	Depends on active host context.	Shared app launch path.
OS Runtime	Multiple app windows through the Runtime window manager.	Multi-window branch of the same app launch model.

The singleton host and multi-window host should share renderer foundations so apps behave consistently while OS Runtime keeps the stronger desktop model.