manage/openspec/changes/archive/2026-06-17-web-ui-rework/.pi-map.md

openspec/changes/archive/2026-06-17-web-ui-rework

dir: openspec/changes/archive/2026-06-17-web-ui-rework

index: openspec/changes/archive/2026-06-17-web-ui-rework/.pi-map.index.md

role

OpenSpec change specification archive documenting the planning, design, implementation, and verification of a React frontend migration from MUI v9 to shadcn/ui + Tailwind v4.

files

• apply-progress.md | Cumulative progress log documenting the implementation of a web UI rework across multiple slices, tracking completed tasks, file changes, deviations, and remaining work for a React/TypeScript frontend migration from MUI to shadcn/ui primitives. | dep: shadcn/ui, TanStack Table, Vitest, React, TypeScript, Vite, lucide-react, Tailwind CSS, npm, Node.js, git
• archive-report.md | Documents the archive readiness of a completed web-ui-rework OpenSpec change, deferring the final folder move to a parent orchestrator while verifying all 8 lifecycle phases and archive preconditions are satisfied. | dep: git, openspec, sdd-sync, sdd-status, node/npm (build/lint/test toolchain), vitest, eslint, tanstack table, shadcn/ui, tailwind
• design.md | Technical design document for migrating a React web UI from MUI v9 to shadcn/ui + Tailwind v4 + lucide-react, including component mappings, theme tokens, TanStack Table wrapper design, and navigation IA changes. | dep: shadcn/ui, Tailwind v4, lucide-react, @tanstack/react-table, react-router-dom, react-oidc-context, Vitest, @testing-library/react
• exploration.md | A technical planning document mapping the scope, inventory, and migration strategy for replacing MUI v9 with shadcn/ui + Tailwind CSS across a React frontend codebase. | dep: MUI v9, shadcn/ui, Tailwind CSS v4, lucide-react, @tanstack/react-table, @tanstack/react-query, react-router-dom, react-oidc-context
• proposal.md | A proposal document outlining the migration of a React frontend from MUI to shadcn/ui + Tailwind v4, removing orphaned dependencies and standardizing the UI design system. | dep: shadcn/ui, Tailwind v4, lucide-react, @tanstack/react-table, @mui/material, @mui/x-data-grid, @mui/icons-material, @emotion, recharts, d3, react-router-dom, react-oidc-context
• spec.md | Define acceptance requirements for a web UI rework migrating from MUI to shadcn/ui + Tailwind v4 + TanStack Table, delivered in eight build-green slices with zero legacy dependency residue. | dep: shadcn/ui, Tailwind v4, lucide-react, @tanstack/react-table, Vitest, @testing-library/react, react-router-dom, react-oidc-context, Grafana
• sync-report.md | Documents the synchronization of OpenSpec artifacts for the web-ui-rework change, reconciling a flat spec into domain-specific delta and canonical specs to unblock the native status engine's sync/archive gates. | dep: gentle-pi.sdd-status, openspec, verify-report.md, git, markdown
• tasks.md | Defines a phased implementation plan for migrating a web UI from MUI v9 to shadcn/ui + Tailwind v4 + lucide-react, with 8 slices of concrete tasks, dependency ordering, and strict exit gates per slice. | dep: shadcn/ui, Tailwind CSS v4, lucide-react, TanStack Table, Vitest, Testing Library, React, Vite, MUI v9 (being removed), @emotion (being removed)
• verify-report.md | Verification report documenting a completed frontend migration from MUI v9 to shadcn/ui + Tailwind v4 + lucide-react, validating all 71 tasks, 18 requirements, and 4 quality gates pass with two non-blocking findings. | dep: npm, node, vitest, @testing-library/react, react, react-router-dom, react-oidc-context, @tanstack/react-table, tailwindcss, lucide-react, radix-ui, jsdom, eslint, typescript, vite, git

arch

Document-driven specification pattern with eight lifecycle phases (proposal → exploration → design → spec → tasks → apply-progress → verify-report → archive-report), using incremental slice-based delivery with strict exit gates per slice.

tags

react, shadcn, lucide, ui, report, mui, tailwind, table

symbols

workflows

dirty