# 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`.