Inclusive Design Foundation publishes 'Token Hygiene' guide for accessibility-first design systems

Design · 4 min read

The Inclusive Design Foundation released a practical guide called 'Token Hygiene' that walks teams through organizing design tokens to support accessibility requirements. It emphasizes semantic token naming (e.g., 'button-primary-background' rather than 'blue-500'), variant layering for accessibility (contrast, motion, spacing), and clear mapping strategies for runtime overrides like increased text size or reduced motion.

One core recommendation is to separate design intent from visual values. Instead of creating tokens per breakpoint or persona, teams should create intent-driven tokens (e.g., 'emphasis', 'neutral-text') and define accessibility-aware layers that adjust those intents via transforms. The approach reduces the number of surface tokens while enabling deterministic transformations for accessibility scenarios.

The guide also covers governance: how to version token changes, communicate accessibility impacts to product teams, and include accessibility checks in token CI. Sample scripts for integrating token checks into CI/CD and templates for accessibility rationale in token change PRs are included. Foundation members say the goal is to make accessibility changes low-friction and traceable in large design systems.