Prox OS Internal Docs
PlatformArchitectureApps

App Store, Library, Workspace Contexts, And Published Apps

Prox OS separates app discovery, installed assets, workspace usage, and

Four Layers

Prox OS separates app discovery, installed assets, workspace usage, and published definitions.

LayerCanonical exampleMeaning
App Store/apps, /apps/@prox-os/holaPublic discovery, listing, install, and open-in-OS context.
Library/@esmadrider/library/apps/holaThe owner's installed app relationship, permissions, version, source, and default opening behavior.
Workspace/@esmadrider/runtime/os/app-os/holaA runtime or Studio context where the installed app can be opened, projected, or reviewed.
Published App/@prox-os/apps/holaThe app definition published by an owner or organization.

These routes must not collapse into one concept. Installing an app does not copy the published app definition. Adding an app to a workspace does not replace Library management. Viewing an App Store listing does not mean the app is installed.

App Picker

Library uses an App Picker dialog for contextual app selection. The picker reuses App Store catalog data and cards, but it does not become a second App Store. The full discovery route remains /apps.

One App, Many Workspaces

One App can power multiple workspaces because each workspace is a context instance, not a copy of the App. Hola can appear in:

/@esmadrider/runtime/os/app-os/hola
/@esmadrider/studios/atlas/app-os/hola
/@esmadrider/studios/grid/app-os/hola

Each workspace can have different owner, visibility, datasets, permissions, AI context, collaborators, presentation settings, and Scenes.

Local Single-App Experiments

The historical App Studio / single-app engine is now a local-only development surface under /dev/studios/single-app. It should not appear in App Store, Library, New, Switcher, or public navigation until it becomes a product surface again.

Route App Reuse

The same App Store component can appear as a Desktop Runtime app window and as the public /apps page. Public route wrappers provide presentation context; they should not duplicate the App Store UI. Site Studio remains a local-only development engine under /dev/studios/site.

On this page