token-validation

Design token validation checks that all token definitions, references, and formats are correct and consistent. It scans your design-tokens.yml for broken references, format errors (HEX, RGB, HSL, rem, px), naming convention violations, and structural issues like circular or orphaned tokens, generating a prioritized report of problems to fix.

Design tokens should follow established primitive and semantic layer naming rules for clarity and maintainability. Validation ensures tokens adhere to your naming conventions, distinguishing primitive tokens from semantic tokens and enforcing consistent patterns across your design system.

Circular reference and orphaned token detection identifies tokens that reference each other in loops and tokens defined but never used. This dependency analysis catches these critical issues automatically, preventing build failures and ensuring every token serves a purpose in your design system.

Semantic layer integrity validation enforces that semantic tokens reference only primitive tokens and include complete state coverage (base, hover, focus, disabled). This ensures your design system's architectural layers remain properly separated and fully specified.

Token validation verifies that values match expected formats including color formats (HEX, RGB, HSL), spacing units (rem, px), and typography properties. Format checking prevents inconsistencies that could break your design system or cause unpredictable UI rendering.

Duplicate detection identifies tokens with identical values across your repository, helping you consolidate redundant definitions. Finding and removing duplicates improves maintainability and ensures your design system remains lean and consistent.