Skip to content

Create a design-token migration matrix (design/token-migration-matrix.md) tracking hardcoded-hex components against tokenized status #928

Description

@Jagadeeshftw

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

Metadata

Metadata

Assignees

No one assigned

    Labels

    GrantFox OSSGrantFox open-source programMaybe RewardedGrantFox: potentially rewarded contributionOfficial Campaign | FWC26GrantFox official campaign issueStellar WaveIssues in the Stellar wave programdesign-systemDesign system / tokensdocumentationImprovements or additions to documentationfrontendFrontend implementation

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions