Handbook
Studio route atlas
Use this page as the canonical token table. Deeper UX context lives in the focused guides below (shell, workspace, Docs Health UI, settings, Studio troubleshooting).
Focused guides
- Studio — navigation and shell
- Studio — workspace and projects
- Studio — Docs Health UI
- Studio — LLM and Fleet settings
- Studio — troubleshooting
What it is
Forge Studio (lenses-enterprise React SPA) mounts at /studio/ from python3 -m lenses. Client routes come from lenses-enterprise/src/App.tsx (BrowserRouter + nested <Route> declarations). Each area fans out to JSON endpoints catalogued in http-api-and-routes.html (maintainer build) and summarized for builders in Schemas and API (builders).
When to read it
- You need URL → API alignment for screenshots, support, or QA.
- You extended Studio and must document new
GETvsPOSTbehavior.
Daily flow (swimlane)
Route families vs network hops
Client route checklist (from App.tsx)
Paths below are relative to / studio / (spaces added to avoid accidental linkification in plain Markdown editors). Token text matches studio-route-doc-coverage.yaml for CI.
| Area | Path tokens (representative) | Typical APIs | Notes |
|---|---|---|---|
| Home | overview/charts, projects, projects/:name, projects/:name/charts, projects/:name/strategy, projects/:name/docs-health, projects/:name/docs-health/master, projects/:name/docs-health/session/:sessionId |
workspace state, chart bundles, git proxies | Project scoping is the busiest subtree. |
| Discovery | search, chat |
search indices, assistant | chat may be gated by LLM config. |
| Settings | settings/llm, settings/fleet, settings/ux-insights, settings/agent-runtime |
LLM gateway, Fleet jobs, experiments | fleet also appears in settings paths. |
| Governance | governance/connectors, governance/audit |
governance APIs | Distinct from methodology knowledge panes. |
| Productivity | toolset, toolset/:name |
tool runner | :name selects packaged automation. |
| Sites | websites, websites/browse/:site |
blog + workspace markdown indexes | Includes Forge SDLC blog surfaces. |
| Structure | wbs, wbs/view |
WBS readers | |
| Planning | plan, plan/matrix, timeline, board, board/:id |
plan spine, matrix, boards | plan/matrix is the matrix lens. |
| Learning | tutorials |
guided content | |
| Embedded | view/docs/*, view/local-site/*, workspace-md, workspace-md/view |
static file proxies | local-site serves selected static previews. |
| Content | blog, blog/post/:slug |
blog feeds | post segment is static in the router. |
| Knowledge | knowledge/methodology/evidence, knowledge/methodology/decisions, knowledge/methodology/record/:entityId, knowledge/methodology/readiness, knowledge/agentic-bridge |
methodology registries | Includes evidence, decisions, record, readiness, and agentic-bridge. |
| Labs | roadmap-section, feature-showcase |
experimental panes | treat as optional / flag-gated. |
| Wizard | blueprints/wizard, blueprints/wizard/session/:sessionId |
/api/blueprints/wizard/* |
Session deep links for debugging. |
Decision: blank Studio shell
Troubleshooting
See Studio — troubleshooting for blank shell, assets, and API-origin checks (includes the same steps formerly duplicated here).
- Watch Network while visiting each family above; compare methods to
http-api-and-routes.html. - Keep this table aligned with
docs/strategy/studio-route-doc-coverage.yaml— CI asserts tokens stay documented.