The semantic CSS token layer introduced in Wave H. These tokens replace raw hex literals across the Surface codebase. All three themes resolve to distinct values. Review and approve before tokens are published to the official design-system docs.
var(--color-accent) for primary interactive elements, links, and highlights. Never write #4FD6BE directly in product code.--signal-high/medium/low) for ICP scores, lifecycle states, and health indicators — not for generic success/warning/danger UI.--color-danger/warning/success/info for UI feedback states (form errors, toasts, status badges). Signal tokens are for data quality, not UI state.--text-inverse for text rendered on an accent or colored background. Never hardcode #111417 or #0d1117 in product code.--color-danger-dim) are for backgrounds and subtle fills. Use them with the matching foreground token — never mix dim from one family with text from another.var(--base-*) primitive tokens in product code (SDS-L13). Always use the semantic alias.UI feedback and state colors. Each has a full-strength foreground value and a dim background variant. All three themes provide visually distinct values.
ICP scoring, lead quality, and lifecycle health. Signal tokens are for data quality — not interchangeable with semantic colors. High = good, Medium = caution, Low = at-risk.
Mechanical hex-to-token passes across the Surface codebase. Each pass targets specific directories and produces a PR against main.
| Pass | Scope | Replacements | L16 after | Status |
|---|---|---|---|---|
| H1a | Shared libs, styles, globals | 189 | 1546 | merged |
| H1b | work/, audience/ | 22 | 1524 | merged |
| H1c | admin/, settings/, console/, components/ | 230 | 1294 | merged |
| H1d | All remaining routes (22 dirs) | 391 | 1074 | merged |
| H2a | Missed files — auth, vault, cycles, work subfolders, statusSets | 98 | 1071 | merged |
| Wave V | Visual redesign — /curate first | — | — | awaiting brief |
These hex values stay as literals permanently. They are not design system violations — they are intentional by category.