Design tokens go semantic: a new spec for accessible semantics in systems

Tech · 6 min read

Traditional tokens tie a semantic name to a color or size value, but many systems still leave accessibility decisions implicit. The proposed semantic-token spec formalizes the accessibility role of a token and attaches metadata like minimum contrast targets, typographic thresholds, and state-specific overrides.

When tokens carry semantic constraints, build systems can programmatically validate that a theme meets the declared accessibility floor before shipping. This reduces brittle token swaps that accidentally reduce contrast in dark mode or when brands request color changes.

Tooling vendors are evaluating adapters that transform legacy token files into the new semantic format and enable live compliance checks. Designers and engineers say the migration takes effort, but the payoff is fewer accessibility regressions and clearer cross-team contracts about what tokens mean.