Semantic tokens preserve intent across themes and platforms

Raw color and spacing values describe appearance, but semantic tokens encode why each value exists.

Names such as surface, danger, and focus communicate purpose across themes, components, and implementation platforms.

USWDS uses curated palettes to improve design efficiency and reduce unnecessarily granular communication between disciplines.

The emerging exchange format standardizes token data between tools, though it remains outside the W3C Standards Track.

System governance defines approved meanings, while documented states reveal where tokens operate.

Changing an alias can update many surfaces without forcing consumers to understand raw palette values.

Prefer semantic aliases over direct values, then review their contrast and meaning within every supported theme.