clean-architecture-frontend-template/docs/styling/design-tokens.md

Design-token styling contract

src/presentation/styles/theme.css is the styling SSOT. Components consume semantic color, spacing, typography, and radius tokens through static Tailwind classes.

Arbitrary-value policy:

• prefer a named semantic token
• bracket values are allowed only for one-off platform constraints that cannot be expressed by the current scale
• a repeated bracket value must be promoted into @theme
• user-controlled or runtime-composed class strings are forbidden
• class variants must be selected from a closed static map

The removable sample may demonstrate tokens, but product modules must not import from src/sample/contract-fixture.