Design Tokens Validator

Scan source files for hard-coded design values and suggest official token replacements.

Quick Start

python3 scripts/validate_tokens.py --tokens tokens.json --source src/

Supported Token Categories

Category Example Token Detects

Colors color.primary.500

Hex (#FF0000), rgba(), hsl(), named colors

Typography font.size.md , font.weight.bold

px/rem font sizes, numeric weights

Spacing spacing.4 , spacing.lg

px/rem padding/margin/gap values

Radius radius.md

Border-radius values

Shadows shadow.lg

Box-shadow definitions

Detection Examples

CSS/SCSS

/* Violation */ .card { color: #222222; padding: 17px; }

/* Correct */ .card { color: var(--color-text-primary); padding: var(--spacing-4); }

SwiftUI

// Violation Text("Hello").foregroundColor(Color(hex: "#222222"))

// Correct Text("Hello").foregroundColor(.textPrimary)