Description
Multiple prior rounds have tokenized hardcoded hex colors component-by-component (benefits.tsx, network-switcher.tsx, transactions-table.tsx, transactions-header.tsx, and others), but there is no single tracking document showing which components are done, in progress, or not yet started. A migration matrix gives the team and future contributors a clear, prioritized view of remaining design-token debt.
Requirements and context
- Inventory every component still containing hardcoded hex colors across app/ and components/
- Record each component's tokenization status (done / in progress / not started) with a link to its tracking issue
- Prioritize the remaining rows by user-facing visibility (landing and dashboard first)
- Must be accessible (WCAG 2.1 AA), responsive, and consistent with existing design tokens
- Should be tested and easy to review
Suggested execution
Fork the repo and create a branch
git checkout -b docs/design-token-migration-matrix
Implement changes
- Update/Write:
app/globals.css
- Add/Update tests:
app/metadata.test.ts
- Add documentation:
design/token-migration-matrix.md
- Annotate accessibility (contrast, keyboard nav, ARIA)
- Validate responsive behavior across breakpoints (sm 640, md 768, lg 1024, xl 1280)
Test and commit
- Run tests:
pnpm test (or repo's test command)
- Cover edge cases (empty/error/loading, long text, dark mode)
- Include before/after screenshots and accessibility notes
Example commit message
docs: add a design-token migration matrix tracking tokenization status
Guidelines
- WCAG 2.1 AA compliance
- Clear documentation and spec hand-off
- Timeframe: 96 hours
Description
Multiple prior rounds have tokenized hardcoded hex colors component-by-component (benefits.tsx, network-switcher.tsx, transactions-table.tsx, transactions-header.tsx, and others), but there is no single tracking document showing which components are done, in progress, or not yet started. A migration matrix gives the team and future contributors a clear, prioritized view of remaining design-token debt.
Requirements and context
Suggested execution
Fork the repo and create a branch
Implement changes
app/globals.cssapp/metadata.test.tsdesign/token-migration-matrix.mdTest and commit
pnpm test(or repo's test command)Example commit message
Guidelines