Prox OS Apps
Prox OS apps are registered surfaces that open inside the browser OS shell. They can be full local apps, connector-first user apps, iframe-backed Proxied Apps,
Prox OS apps are registered surfaces that open inside the browser OS shell. They can be full local apps, connector-first user apps, iframe-backed Proxied Apps, system surfaces, or Hub Apps that bundle a product workflow.
The runtime source of truth is the app registry in apps/os-shell/src/apps/registry.ts. App docs should stay aligned with each manifest route, ownership, permissions, and current mock or production boundary.
App Groups
| Group | Route prefix | Purpose |
|---|---|---|
/app-os | /app-os/* | System, official team, community, developer, and platform operations apps. |
/app-user | /app-user/* | Identity, profile, visitor, notifications, shortcuts, display, and preference surfaces. |
/app-track | /app-track/* | Personal tracking primitives: People, Places, Devices, Money, Sources, and AI Context. |
/app-connectors | /app-connectors/* | External platform connector surfaces for imports, sync readiness, source status, permissions, and cache deletion concepts. |
/app-sports | /app-sports/* | Sports memories, matchdays, practice logs, fan passports, equipment, costs, and personal context. |
/app-edu | /app-edu/* | Learning, study mode, practice labs, notes, reviews, and long-term personal growth surfaces. |
/app-health | /app-health/* | Health, sleep, dreams, body, mood, mindfulness, and sensitive personal tracking surfaces. |
/app-spaces | /app-spaces/* | Proxied Spaces home, Slidepad, compatibility, install destinations, and fallback settings. |
/app-hub | /app-hub/* | Hub, directory, marketplace, curated Space, and workflow cockpit apps. |
/app | /app/* | Personal work, data, creative, productivity, finance, and daily apps. |
/app-game | /app-game/* | Browser-native games and future sandboxed game experiments. |
/app-admin | /app-admin/* | Internal admin operations, real data readiness, waitlist, feedback, audit, permissions, jobs, storage, billing, and backend workbenches. |
/app-dev | /app-dev/* | Local development tools, API docs, contracts, mock scenarios, Storybook, Scalar, architecture graph, route map, and debugging surfaces. |
/app-iframe | /app-iframe/* | External or standalone apps proxied into managed OS windows. |
Documentation Layout
- app-user documents identity, profile, visitor, preference, Activity, and user settings surfaces.
- app-track documents the personal tracking layer, deprecated
/app-dataaliases, and seven dimensions. - app-connectors documents the connector layer and the
/app-user-connectorscompatibility migration. - Sports documents
/app-sports, Football Fan Passport, and sport-specific memory apps. - Scenario Apps documents Food, Work, Books, Series, Music Memory, Collections, Local Services, Documents Vault, AI Team, creator apps, Project Museum, and Europe Planner.
- Media And Event Records documents Events, Tickets, Photo Roll, Wishlist, Reading, Bookmarks, Podcasts, Music Memory, Awesome GitHub Radar, and RSS Knowledge Inbox.
- Madrid Activity Explorer documents
/app/madridas the city activity hub. - Madrid Cine Radar documents
/app/madrid-cine-radaras the mock-first cinema decision engine. - Madrid Cine Radar B2B documents
/app/madrid-cine-radar-b2bas the partner cockpit mock. - Deployment Connectors And Spaces documents
/app-connectors/deploymentsversus/app-spaces/deployments. - Personal Record OS documents the mock-first life log apps across games, learning, health, places, movies, feeds, Madrid, markets, and AI publishing.
- Utility And Intelligence Apps documents Calculator, Currency Converter, DevUtils, Clock, Celebrity Tracker, Hurun Wealth List, Open Movie Database, Industry News, and AI Navigation.
- app-os indexes OS-level apps, system apps, and platform control surfaces.
- app-hub indexes productized Hub Apps and workflow cockpits.
- App Store documents Native Apps, Proxied Apps, Spaces, and install destinations.
- UI App Competitive Matrix maps the current registered UI app families to product references, competitors, learning goals, and anti-copy boundaries.
- Proxied Space documents
/app-spaces/home,/app-spaces/slidepad, browser limits, and future client paths. - Music documents the split between
/app/musicMusic Memory and/app/music-playerMusic Player. - Timeline documents
/app-user/activityas the productized Timeline surface. - visitor documents the privacy-first Visitor App and OS Home presence model.
- Existing flat app docs remain linked while the taxonomy is being normalized.
App Shapes
- Full app: Owns a meaningful in-window workflow and can grow app-local navigation.
- Connector app: Connects external services later, normalizes user-owned context, and exposes permission-aware summaries.
- Iframe app: Loads an external or standalone app in a managed shell window.
- System surface: Controls or explains OS behavior and may remain tightly coupled to shell runtime.
- Hub app: Bundles multiple related operational modules into a cockpit or directory surface.
Alma Relationship
Alma should consume structured summaries, scoped tools, and explicit permissions from app surfaces. It should not receive uncontrolled raw provider data. App docs should call out what Alma can read, summarize, suggest, and what requires user confirmation.
The current control-plane UI upgrade adds App Map, Personal Data Graph, Connector Wall, Prompt Studio, and Activity as mock-first surfaces. Together they show OS capability topology, personal object relationships, external service boundaries, reusable AI workflow assets, and event history without claiming real backend integrations.