Builder meta lives in a Stripe-style workbench, not the site nav
Decision (2026-08-05). Decisions, the builder roadmap, and future building-process meta (annotations, time travel) do not appear in the marketing site’s navigation. They live in a workbench: a collapsed dark bar at the bottom of every page, Stripe-style, with three states —
- Collapsed bar — a slim strip with an open-decision count.
- Icon popovers — small widgets sharing the Astro-toolbar popover mechanics: the theme switcher and the version lens.
- Expanded panel — a resizable section hosting a mini-app with its own navigation (decisions, builder roadmap), independent of the main site.
Why. The original spec put these surfaces in the site nav and the Astro dev toolbar, which broke the core promise: the vision site should read as a finished product’s marketing site. Meta about the building process is a different mode of looking. The Stripe workbench pattern keeps that meta one click away but visually separate — and because the panel is independent of the page, the builder can review a decision while navigating the site around it to think it through in context.
Consequences.
- The workbench replaces the Astro dev toolbar apps and ships with the
site (not dev-only), so it works on immutable preview deployments —
which time travel (FEAT-0009) will rely on.
private: truecontent still strips from production builds. - Old
/decisionsURLs redirect to/workbench/. - The public
/roadmappage stays marketing-friendly (what ships when); gate state and blocking decisions moved to the workbench roadmap. - This supersedes §7’s “four toolbar apps” surface from the founding spec; BOOTSTRAP.md remains as written — decision records carry the deltas.