ai-workflow-skill/docs/roadmaps/archive/web-frontend-cadence-ui-bootstrap.md

Web Frontend Cadence UI Bootstrap

Status

• completed

Owner

• Codex

Started At

• 2026-03-20

Goal

• Bootstrap the apps/web frontend with copied-in cadence-ui components and shared token styles so Phase 2 web UI work can build on the project component library instead of the bare Vite scaffold.

Scope

• create an execution trace for this frontend bootstrap slice
• install the initial cadence-ui component set into apps/web
• wire the Cadence token stylesheet into the frontend entrypoint
• validate the frontend workspace build after the component copy-in
• keep docs/implementation-roadmap.md synchronized with the new frontend state

Checklist

• create the active execution roadmap for the Cadence UI frontend bootstrap workstream
• install the initial cadence-ui component set into apps/web
• wire apps/web/src/main.tsx to load cadence-ui token styles
• validate the frontend workspace build and resolve any dependency gaps
• update docs/implementation-roadmap.md
• archive this execution roadmap with a completion summary if the slice is fully complete

Files

• docs/roadmaps/archive/web-frontend-cadence-ui-bootstrap.md
• docs/implementation-roadmap.md
• apps/web/package.json
• apps/web/src/main.tsx
• apps/web/src/cadence-ui/
• pnpm-lock.yaml

Decisions

• start Phase 2 frontend work by copying in the shared component library instead of building bespoke primitives inside apps/web

Blockers

• none

Next Step

• build the first Phase 2 product screens in apps/web on top of the copied-in Cadence UI primitives, installing additional registry components only when those screens need them

Completion Summary

• ran the cadence-ui registry installer from /Users/xd/project/cadence-ui and copied the initial component set into apps/web/src/cadence-ui, including shared tokens plus button, input, textarea, dialog, form, tabs, card, badge, and alert primitives
• wired apps/web/src/main.tsx to import ./cadence-ui/tokens/styles.css so the copied-in components share the library token base from app startup
• installed the newly required frontend dependencies into the workspace, refreshed pnpm-lock.yaml, and verified the result with pnpm run web:build
• synchronized docs/implementation-roadmap.md so Phase 2 frontend work now explicitly continues from the Cadence UI foundation