Dev.to
7/7/2026
Why I stopped using design tokens as implementation details
Short summary
Design tokens are decisions, not CSS variables — confusing the two creates systems that fail both designers and developers. A token like --color-accent answers 'what is this for?' while a primitive like --gray-200 answers 'what is this value?'. Tokens belong at the semantic layer and should remain stable even when their underlying implementation changes.
- •Design tokens are semantic decisions, not raw CSS variable values
- •Mapping Figma colors 1:1 to CSS variables produces implementation details, not tokens
- •Tokens like --color-border-subtle encode purpose; primitives like --gray-200 encode values
Generated with AI, which can make mistakes.
Is this a good recommendation for you?



