Internal
Reader Navigation Internals
The reader shell switches documents from the navbar and renders document-specific sidebar navigation and routes.
uinavigationsearchreaderrouting
Key files
components/docs-shell.tsxcomponents/function-reference.tsxcomponents/markdown-content.tsxsrc/pages/index.astrosrc/pages/[documentSlug]/index.astrosrc/pages/[documentSlug]/[entryId].astro
Routes
/renders the default document and its first entry. Documentation is the default only when it has visible concepts; otherwise an available project plan is used as the root document./documentation/renders the first visible documentation concept./documentation/:conceptId/renders a documentation concept./project-plan/renders the first project plan section./project-plan/:sectionId/renders a project plan section./task-tree/renders the fullscreen task graph workspace./task-tree/:taskId/renders the fullscreen task graph workspace with the selected task drawer open.- Function and type entries use hash anchors under the owning documentation concept route.
Behavior
- The header navbar lists every recognized document in the collection.
- The sidebar shows documentation categories for documentation pages.
- The sidebar shows project plan areas for project plan pages.
- Task tree pages do not use a sidebar; the graph is the primary workspace.
- Search is scoped to the active document.
- Documentation search returns concepts, function entries, and type entries.
- Project plan search returns plan sections and searches section summaries, intro Markdown, and detail blocks.
- Project plan pages render section summaries, free-form intro Markdown, and
###detail blocks. - Task tree search returns tasks.
- Task tree pages render a pannable, zoomable SVG graph with task statuses, decomposition edges, dependency edges, and a right-side detail drawer.
- Inline type references inside function and type cards link back to the owning
TypeReferenceTarget.