App Surface Map
Source-of-truth map of the current authenticated app surfaces and where docs coverage is still thin.
This page maps the actual authenticated product surface in apps/app. It exists because route names, redirects, and old work logs drift over time. The current app should be documented from its live navigation model, not from memory.
The Five Live Domains
The authenticated shell is organized into five domains:
| Domain | Live destinations |
|---|---|
| Personal | /, /profile, /settings, /notifications, /coin, /personas |
| Finance | /finance, /portfolio, /network/tokenomics, /invest, /vouchers, /business |
| Technology | /graph, /fixies, /network/validation, /markets/algorithms, /stars |
| Organization | /legal-entities, /circles, /governance, /governance/constitution, /tasks, /core-circle, /locations |
| Markets | /markets, /markets/ecosystem, /currencies/*, /markets/p2p-arbitrage, /markets/trade |
This structure comes from the current sidebar taxonomy in apps/app/app/(authenticated)/components/domain-nav-config.ts.
Important Consolidations
The app has several legacy routes that still exist, but they redirect:
/dashboard->//membership->/profile/wallets->/profile/bridgeand related bridge overview routes ->/finance/holacracy->/circles/cartography->/graph?mode=advanced/accounting->/business
That means older docs and old work logs can easily overcount or misname the current user-visible surface.
Priority Surfaces
The most important current user-facing routes are:
- Dashboard at
/ - Profile at
/profile - Finance at
/finance - Portfolio at
/portfolio - Circles at
/circles - Governance at
/governance - Graph Explorer at
/graph - Advanced Graph / Cartography at
/graph?mode=advanced - Invest at
/invest - Fixies at
/fixies
The route-to-tour mapping in the app also reinforces those as the product’s real primary surfaces.
Documentation Gaps
The current docs are stronger on architecture than on product usage.
What is documented well:
- tokenomics
- network foundations
- compliance
- architecture and research
What still needs dedicated product docs:
- dashboard workflow
- profile and identity workflow
- finance and Bridge-consolidated actions
- circles as the real organization center
- legal entities and registry workflow
- tasks
- graph explorer and advanced graph mode
- business page
This is the baseline for the next rounds of docs work. The goal is to update these product surfaces one by one without breaking the current docs structure.