Semantic Tokens Over Raw Color Literals
Binding components directly to semantic variables like `--background`, `--foreground`, `--text-secondary`, and `--accent-primary` guarantees seamless parity between Sahara Solstice (light) and Sahara Nocturne (dark).
Contrast failures happen when components reference raw brightness names instead of semantic roles. Testing secondary labels on muted surfaces ensures readability across every theme combination.
Key Takeaway
Author components strictly against semantic surface/text tokens rather than theme-specific hex values.
Accessible Focus, Composition & Slottable Buttons
Design system primitives should provide generous `focus-visible:ring-2` indicators, proper Radix `Slot`/`Slottable` polymorphic composition, and built-in reduced-motion defaults so every downstream app inherits WCAG compliance automatically.