PlatformArchitectureApps
App Route Taxonomy
Adding /app-track, /app-connectors, /app-edu, /app-health, /app-sports, /app-game, and /app-hub is a narrow route-group extension. The shell still parses
Current Route Groups
| Group | Prefix | Meaning | Desktop placement |
|---|---|---|---|
app | /app | Personal work, data, creative, productivity, finance, and daily apps. | Left |
app-edu | /app-edu | Learning, study mode, practice labs, notes, reviews, and long-term personal growth surfaces. | Left, near Apps |
app-health | /app-health | Health, sleep, dreams, body, mood, mindfulness, and sensitive personal tracking surfaces. | Left, near Education |
app-track | /app-track | Personal tracking primitives: People, Places, Devices, Money, Sources, and AI Context. | Left, near Apps |
app-connectors | /app-connectors | External platform connector surfaces for imports, sync readiness, provider status, permissions, and source provenance. | Left, near Track |
app-user | /app-user | Profile, visitor, preferences, notifications, logs, shortcuts, and display surfaces. | Right |
app-spaces | /app-spaces | Proxied Spaces home, Slidepad, compatibility, install destinations, and fallback settings. | Right, near User Apps |
app-sports | /app-sports | Sports memories, matchdays, fan passports, practice logs, equipment, costs, and personal context. | Left, near Track |
app-game | /app-game | Browser-native games and future sandboxed game embeds. | Left |
app-admin | /app-admin | Internal admin operations, real data readiness, waitlist, feedback, audit, permissions, jobs, storage, and billing. | Bottom right |
app-dev | /app-dev | Local development tools, API docs, contracts, mock scenarios, Storybook, Scalar, architecture graphs, and route maps. | Bottom right, next to Admin |
app-iframe | /app-iframe | Standalone or external Proxied Apps loaded through iframe. | Left |
app-os | /app-os | Official OS, platform, community, and system apps. | Right |
app-hub | /app-hub | Productized vertical Hub cockpits with internal modules and bundle semantics. | Right, after OS Apps |
New Phase 1 Routes
| App | Route | Runtime | Notes |
|---|---|---|---|
| Games Hub | /app-game | @prox-os/os-apps | New route group and desktop folder entry. |
| TS Fullstack | /app-edu/ts-fullstack | @prox-os/os-apps | Study cockpit and Boss Mode target. |
| Health | /app-health/health | @prox-os/os-apps | Personal health mock, no medical advice. |
| Dreams | /app-health/dreams | @prox-os/os-apps | Health-folder dream journal; /app/dreams is an alias. |
| Game Records | /app/game-records | @prox-os/os-apps | Personal gaming session and purchase journal. |
| Places | /app/places | @prox-os/os-apps | Visited-place timeline and wishlist mock. |
| Movies | /app/movies | @prox-os/os-apps | Cinema and film journal mock. |
| News RSS | /app/news-rss | @prox-os/os-apps | Feed reader mock with source management modal. |
| Madrid | /app/madrid | @prox-os/os-apps | Local city life hub mock. |
| Stock Track | /app/stock-track | @prox-os/os-apps | Trading journal mock, not financial advice. |
| AI Medium | /app/ai-medium | @prox-os/os-apps | Model-transparent publishing mock. |
| Snake | /app-game/snake | @prox-os/os-apps | First local mini game. |
| Tile Merge | /app-game/tile-merge | @prox-os/os-apps | Local tile merge puzzle. |
| Minesweeper | /app-game/minesweeper | @prox-os/os-apps | Local beginner minefield. |
| Memory Cards | /app-game/memory-cards | @prox-os/os-apps | Local pair matching memory game. |
| Breakout | /app-game/breakout | @prox-os/os-apps | Local paddle-and-bricks arcade game. |
| Pong | /app-game/pong | @prox-os/os-apps | Local player-versus-AI paddle game. |
| Falling Blocks | /app-game/falling-blocks | @prox-os/os-apps | Local falling block line-clear game. |
| Subscription Tracker | /app/subscription-tracker | @prox-os/os-apps | Mock recurring subscription ledger. |
| AI Question Tracker | /app/ai-question-tracker | @prox-os/os-apps | Mock AI question history. |
| Market Watch | /app/market-watch | @prox-os/os-apps | Mock market and portfolio watchlist. |
| Proxied Spaces Home | /app-spaces/home | @prox-os/os-apps | Third-party web app Space management and fallback preview. |
| Slidepad | /app-spaces/slidepad | @prox-os/os-apps | Corner quick panel for Proxied Spaces and web app rails. |
| Music Memory | /app/music | @prox-os/os-apps | Music listening memories, loops, places, people, sources, and AI summaries. |
| Music Player | /app/music-player | @prox-os/os-apps | Mock music player with Floating Surface mini-player behavior. |
| Sponsor | /app-os/sponsor | @prox-os/os-apps | Early funding and supporter transparency surface. |
| Prox Wallet | /app-connectors/wallet | @prox-os/os-apps | User-specific wallet and billing connector mock. |
| Track People | /app-track/people | @prox-os/os-apps | People and relationship memory entities. |
| Track Places | /app-track/places | @prox-os/os-apps | Reusable place entities for scene apps. |
| Track Devices | /app-track/devices | @prox-os/os-apps | Devices as life capture and work media. |
| Track Money | /app-track/money | @prox-os/os-apps | Cross-app spending and experience value context. |
| Track Sources | /app-track/sources | @prox-os/os-apps | Data provenance, source confidence, and permission status. |
| Track AI Context | /app-track/ai-context | @prox-os/os-apps | Prompt trails, model usage, linked outputs, and trust review. |
| Food | /app/food | @prox-os/os-apps | Meal, restaurant, cost, people, and source memory surface. |
| Work | /app/work | @prox-os/os-apps | Personal work sessions, projects, tools, and output log. |
| Books | /app/books | @prox-os/os-apps | Bookshelf, reading timeline, notes, stats, and source links. |
| Series | /app/series | @prox-os/os-apps | Long-form watching tracker for seasons, episodes, and platforms. |
| Music Memory | /app/music-memory | @prox-os/os-apps | Songs as memory anchors across people, places, and moods. |
| Collections | /app/collections | @prox-os/os-apps | Personal artifacts, categories, value, storage, and timeline. |
| Local Services | /app/local-services | @prox-os/os-apps | City services, costs, documents, places, and safety notes. |
| Documents Vault | /app/documents-vault | @prox-os/os-apps | Semantic life-admin files, cases, deadlines, and sources. |
| AI Team | /app/ai-team | @prox-os/os-apps | Personal AI workers, task timeline, permissions, and AI Context links. |
| Personal Blog Studio | /app/personal-blog-studio | @prox-os/os-apps | Drafts, channels, calendar, SEO, assets, and AI writing cockpit. |
| Public Profile Builder | /app/public-profile-builder | @prox-os/os-apps | Public identity, links, portfolio, narrative, and preview. |
| Project Museum | /app/project-museum | @prox-os/os-apps | Project history, artifacts, prompts, milestones, and AI trail. |
| Europe Planner | /app/europe-planner | @prox-os/os-apps | Europe life planning cockpit; not legal, tax, or immigration advice. |
| Events | /app/events | @prox-os/os-apps | Live and event experiences, venues, costs, and memories. |
| Tickets | /app/tickets | @prox-os/os-apps | Ticket and stub memories; no real QR codes. |
| Photo Roll | /app/photo-roll | @prox-os/os-apps | Photo context enrichment and Moments bridge. |
| Wishlist | /app/wishlist | @prox-os/os-apps | Unified wishlist across life, media, travel, and tools. |
| Reading | /app/reading | @prox-os/os-apps | Open-web reading log with friends reading and AI summaries. |
| Bookmarks | /app/bookmarks | @prox-os/os-apps | Saved links with folders, tags, imports, and stale-link checks. |
| Podcasts | /app/podcasts | @prox-os/os-apps | Podcast listening log and notes. |
| Deployment Spaces | /app-spaces/deployments | @prox-os/os-apps | Web deployment work surface, not a deployment connector API. |
| Connectors Hub | /app-hub/connectors | @prox-os/os-apps | App Hub data integration and schema cockpit. |
| Launcher Hub | /app-hub/launcher | @prox-os/os-apps | App Hub external app launcher and iframe fallback cockpit. |
| Design System Hub | /app-hub/design-system | @prox-os/os-apps | App Hub design system, pattern, and AI recipe cockpit. |
| Backend Foundation | /app-admin/backend | @prox-os/os-apps | Mock-first backend resource, roadmap, and safety workspace. |
| Connector Sandbox | /app-admin/connector-sandbox | @prox-os/os-apps | Mock-only connector debugging and provider boundary lab. |
| Mock Lab | /app-admin/mock-lab | @prox-os/os-apps | Static UI/mock/contract/API/DB/docs readiness board. |
| Architecture | /app-dev/architecture | @prox-os/os-apps | Developer architecture observatory. |
| API Worker | /app-dev/api-worker | iframe | Local Cloudflare Worker smoke surface. |
| Scalar | /app-dev/scalar-api | iframe | API reference entry; does not replace Scalar. |
| UI Workshop | /app-dev/ui-workshop | iframe | Storybook workbench. |
| Docs | /app-dev/docs | iframe | Local docs site entry. |
| Nx Graph | /app-dev/nx-graph | iframe | Workspace project graph entry. |
User Connector Routes
| App | Route | Runtime | Notes |
|---|---|---|---|
| Calendar | /app-connectors/calendar | @prox-os/os-apps | Calendar connector and planning surface; no provider API. |
| Books Connectors | /app-connectors/books | @prox-os/os-apps | Goodreads, Kindle, Apple Books, Readwise, and manual import readiness. |
| Music Connectors | /app-connectors/music | @prox-os/os-apps | Spotify, Apple Music, YouTube Music, Last.fm, and Bandcamp readiness. |
| Movies Connectors | /app-connectors/movies | @prox-os/os-apps | Letterboxd, IMDB, Trakt, JustWatch, and streaming watch-history placeholders. |
| Airtable Connectors | /app-connectors/airtable | @prox-os/os-apps | Airtable base and table import readiness for Food, Work, and research records. |
| Chat | /app-connectors/chat | @prox-os/os-apps | User conversation connector surface; not ChatOS. |
/app-connectors/email | @prox-os/os-apps | Email intelligence connector; no mailbox sync. | |
| Weather | /app-connectors/weather | @prox-os/os-apps | Weather context for planning; no real location or forecast API. |
| Messages | /app-connectors/messages | @prox-os/os-apps | OS-native message center for approvals and agent results. |
| Contacts | /app-connectors/contacts | @prox-os/os-apps | People graph and identity connector; no contact provider sync. |
| Prox Wallet | /app-connectors/wallet | @prox-os/os-apps | Existing mock wallet grouped as a financial connector. |
| Game Connectors | /app-connectors/game | @prox-os/os-apps | Unified game library connector hub; no OAuth or provider API. |
| Files | /app-connectors/files | @prox-os/os-apps | Files and drive connector; no filesystem or Drive API access. |
| Notes | /app-connectors/notes | @prox-os/os-apps | Notes and docs connector; no provider sync. |
| Tasks | /app-connectors/tasks | @prox-os/os-apps | Tasks and reminders connector; no external task writes. |
| Bookmarks | /app-connectors/bookmarks | @prox-os/os-apps | Reading connector; no browser bookmark scraping. |
| Photos | /app-connectors/photos | @prox-os/os-apps | Private media connector, separate from Moments. |
| Projects | /app-connectors/projects | @prox-os/os-apps | Personal project context connector; no GitHub or Linear API. |
| Secrets | /app-connectors/secrets | @prox-os/os-apps | Model-blind secrets placeholder; no real secret storage. |
| Places | /app-connectors/places | @prox-os/os-apps | Saved places and location connector; no real geolocation. |
| Health | /app-connectors/health | @prox-os/os-apps | Sensitive wellness placeholder; no medical advice. |
| Project CRM | /app-connectors/project-crm | @prox-os/os-apps | Lightweight relationship connector; no external sends. |
| Knowledge Graph | /app-connectors/knowledge-graph | @prox-os/os-apps | Personal graph visualization placeholder; no graph backend. |
| Browser Activity | /app-connectors/browser-activity | @prox-os/os-apps | Research activity connector; no browser history reads. |
| Sports Connectors | /app-connectors/sports | @prox-os/os-apps | Sports source readiness; no official data integration. |
| Events Connectors | /app-connectors/events | @prox-os/os-apps | Event source import readiness. |
| Tickets Connectors | /app-connectors/tickets | @prox-os/os-apps | Ticket import previews; no real QR exposure. |
| Deployment Connectors | /app-connectors/deployments | @prox-os/os-apps | Deployment platform source metadata; no env secrets. |
| Social Connectors | /app-connectors/social | @prox-os/os-apps | Public social links and signal imports; no DMs. |
Boundary
Adding /app-track, /app-connectors, /app-edu, /app-health, /app-sports, /app-game, and /app-hub is a narrow route-group extension. The shell still parses
routes by registered manifest routing.routeBase; it does not hardcode app UI
into the router or window manager.
/app-data/* remains a deprecated compatibility alias that normalizes to /app-track/*. New app manifests, docs, and launcher entries should use /app-track/*.
/app-user-connectors/* remains a deprecated compatibility alias that normalizes to /app-connectors/*. New app manifests, docs, and launcher entries should use /app-connectors/*.
The /app-admin and /app-dev split is an information architecture boundary,
not a security boundary. Admin is for real OS operations and future production
data control surfaces. Dev is for local development tools, API references,
contracts, mock scenarios, and diagnostics.
/app-game is intentionally separate from /app because games have different
future policy needs: iframe sandboxing, score storage, community submissions,
moderation, performance controls, and content rules.
/app-edu is intentionally separate from /app because learning and study
mode have different startup, focus, note, and future curriculum persistence
needs. /app-health is separate because health, dreams, sleep, mood, and body
records are sensitive and should have stricter permission and AI-context
defaults.
/app-hub is intentionally separate from /app-os because productized Hubs
are workflow bundles rather than generic official OS utilities. The Hub route
group does not replace owner-scoped Store listing URLs or creator canonical
URLs.
Future Direction
Future owner-scoped or creator-scoped app URLs remain out of scope for this change. They should continue to follow the app namespace and surface-model docs before any public URL contract is introduced.