20260914-0317-site-explorer-theme Replace the product-docs theme with a site-wide explorer layout

• status: completed
• priority: P1
• owner: claude/session-63037002
• createdAt: 2026-09-14 03:17

Description

The owner finds the current VitePress default-theme layout (no sidebar, breadcrumb-only navigation, narrow content column) oriented to product documentation: it compresses content and hides the shape of the site. They asked for a file-manager style layout where the whole site tree is visible at once.

Deliver a layout in which a directory tree of every published page is always visible, folders collapse and expand, the current page is highlighted, and pages show their kind and status from frontmatter; the content column stays wide enough for the corpus of wide tables. Keep VitePress and the existing search, breadcrumb, DocMeta, diagram zoom and table wrapper.

Acceptance: every page under bizplan/ and docs/ is reachable from the tree without leaving the page; the tree is generated from the file system at build time, not hand-maintained; the lint, build and diff check pass; screenshots at 1440 px and 1920 px show the tree, content and outline together.

ActiveForm

Designing the site-wide explorer layout.

Dependencies

• blocked by: proposal approval
• blocks: (none)

Notes

• Full tier: theme, config and architecture docs across several files; build configuration is a risk area.

• 2026-09-14 03:45: Alternative A delivered: generated tree (.vitepress/site-tree.ts) feeding sidebar, breadcrumb and docs/sitemap.md; 320 px tree and 1100 px content column; emoji shortcut rule disabled. Screenshots at 1440 px and 1920 px in tmp/shots/ show tree, content and outline together; the 1440 px clipping found on the first capture was fixed by capping --vp-layout-max-width at the viewport width.

• complete: Generated explorer sidebar, sitemap and wide layout delivered; screenshots verified at 1440 and 1920 px.