Toolbox
Token Migration Playbook
Step-by-step guide for migrating to semantic tokens.
What it is
Purpose and scope.
A playbook for transitioning from hard-coded values or core tokens to a semantic token architecture.
When to use
Signals this is the right tool.
When theming, dark mode or brand changes are blocked by raw values in code.
How to use
Minimum steps to get value quickly.
- Audit current token usage with static analysis
- Map raw values to semantic tokens
- Create ESLint rules to block core token imports
- Run codemods to automate migration
- Validate with visual regression tests
Downloads
Grab the files and ship.
Related
Keep the loop tight.