Integration plan (v1.0)
Historical record of the 27-issue rollout that bootstrapped this scaffold.
The integration plan documents the 27-issue sprint that took the scaffold from a bare Astro 4 + Tailwind 3 starter to the full UI stack now in place. All issues are merged. Future work lives in ROADMAP.md.
The 8 phases
| Phase | Milestone | What shipped |
|---|---|---|
| 0 | v0.2 — Stack modernization | Astro 5, Tailwind v4 via @tailwindcss/vite, @astrojs/react, path aliases |
| 1 | v0.3 — shadcn/Base UI | Button, Input, Card, Badge, Label via shadcn CLI + Base UI wrappers for Dialog, Dropdown, Tabs |
| 2 | v0.4 — TanStack | react-query + idb-keyval persistence, DataTable with react-table + react-virtual |
| 3 | v0.5 — Charts + Motion | Recharts wrappers (6 chart types), motion/react LazyMotion, tailwindcss-motion |
| 4 | v0.6 — PWA | @vite-pwa/astro service worker, install prompt, update toast, offline cache |
| 5 | v0.7 — Cross-island state | Nano Stores, theme toggle, cross-island counter demo |
| 6 | v0.8 — Docs + Gallery | Custom /docs route via content collections (ADR 0004), gallery with live render |
| 7 | v1.0 — Inceptor-aware stack | FeedbackFAB, ErrorBoundary, HydrationCanary, sub-agent spec files, ethics checklist |
Key architectural decisions made during the rollout
- ADR 0001 — Shape Up over Scrum
- ADR 0002 — Base UI over Radix as the primitive layer
- ADR 0003 — centinela verdict tokens (
APPROVED/RETRY_FORJA/NEEDS_HUMAN/BLOCKED_UPSTREAM) - ADR 0004 — Custom docs route over Starlight (reasoning: Starlight added a full runtime dependency; a content-collection-powered
[...slug].astrogives us the same result with zero additional deps) - ADR 0005 — Base UI as the standard component library (policy for 44-component catalog)
Full canonical plan → INTEGRATION-PLAN.md