Semantic Design Tokens

Overview

Use tokens as the design-system contract. Global semantic tokens should express reusable roles across the application, not surface-specific implementation details.

When To Use

• Styling, auditing, or extending UI where semantic color, spacing, typography, radii, shadows, or motion roles matter.
• Reviewing raw values, duplicated style constants, or local values that may bypass the design system.
• Deciding whether a value belongs in global tokens, scoped tokens, or local styling.

Token-First Workflow