SDLC · Surface Design System

Surface Design Tokens

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.

Wave H — H1a through H2a complete SDS-L16: 1735 → 1071 (−664) Status: Awaiting review gate
664
Hex literals replaced
1071
Remaining (skip list)
18
Tokens introduced
5
Passes (H1a–H2a)

How to use these tokens

Semantic colors
8 tokens + dim variants

UI feedback and state colors. Each has a full-strength foreground value and a dim background variant. All three themes provide visually distinct values.

--color-accent
dark #4FD6BE · medium #4FD6BE · light #2AA493
Primary interactive color. Links, highlights, active states, primary buttons.
Button Outline
--color-warning
dark #E8B74A · medium #FAA61A · light #9A6E1A
Caution states, non-critical alerts, pending status.
Pending
--color-danger
dark #F85149 · medium #ED4245 · light #C44B3A
Errors, destructive actions, critical alerts.
Error
--color-success
dark #3FB950 · medium #57F287 · light #2E7D52
Completion, confirmed states, positive outcomes.
Done
--color-info
dark #6CB2F2 · medium #5865F2 · light #1E5AA8
Informational states, neutral data indicators, hyperlinks in data views.
Info
--color-evaluate
dark #BC8CFF · medium #B9A0FF · light #6B4FCF
AI/Curate sessions, evaluation states, purple semantic group.
Evaluating
--text-inverse
dark #0B0E14 · medium #1E1F22 · light #FFFFFF
Text rendered on a colored or accent background. Always used with --color-accent as background.
--text-secondary
dark #8B96A5 · medium #B5BAC1 · light #4E5058
Supporting labels, meta, secondary descriptions. One step below primary.
Signal tokens
7 tokens across 3 tiers

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.

--signal-high
all themes #5fd08a
High ICP score, healthy lifecycle, qualified lead.
ICP 90–100
--signal-medium
all themes #e8b74a
Mid-tier ICP score, shortlisted, needs nurturing.
ICP 70–89
--signal-low
all themes #f07a6a
Low ICP score, at-risk, suppressed or churned contact.
ICP <70
--priority-high
dark #f97316 · medium #fb923c · light #c2530b
Ticket priority: Urgent. Orange family, distinct from warning amber.
Urgent
Wave H progress

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
Permanent skip list
~1071 remaining hex literals

These hex values stay as literals permanently. They are not design system violations — they are intentional by category.

MarkIcon.tsx
Logo SVG — hand-tuned stroke geometry. Never tokenize.
email.ts
HTML email — email clients cannot resolve CSS variables.
convertProjectDoc.ts
PDF generation via PDFKit — no CSS context.
reportColors.ts
Chart/time report color palette — data, not design tokens.
Avatar palette arrays
MemberAvatar, ChannelNav, CompanyDetail AVATAR_COLORS — user-facing color picker data.
#FF9580 salmon
Intentional warm highlight. Not mapped to any semantic token.
#34d399 / #10b981 emerald
Distinct from --color-success green family. Kept as literal.
#F472B6 / #ec4899 pink
No semantic token. Intentional accent in specific components.
Google brand (#4285F4 etc.)
OAuth button SVG — must match Google brand spec exactly.
Discord brand (#57F287)
Platform status colors — spec-locked.
Stripe / Slack / Envato
#635bff, #4A154B, #81B441 — third-party brand colors.
ConsoleClient rgba
Custom opacity values (.06, .35) differ from standard -dim tokens. Visual audit pending.