Skip to main content
Tokens·Three-tiered System

The contract
everything renders against.

1,520 tokens organized in three tiers. Every color, every space, every curve in the system flows from this contract — and re-themes when it changes.

Primitives
286
Semantic
102
Component
1132

All 1,520 tokens are typed. Zero hex codes ship in the components package.

Tier 01 · Primitive286

Raw values. Never referenced directly by components.

--color-fiery-coral-700
oklch(0.508 0.139 37.8)
Tier 02 · Semantic102

Roles. The contract every theme must satisfy.

--color-background-primary
→ fiery-coral-700 in light and dark
Tier 03 · Component1132

Surfaces. The shape components consume.

--color-button-primary-background
→ background-primary
Renders →
Color

OKLCH means the ramp is the math.

Lightness is a first-class axis, so steps move predictably. Mix safely, lighten without muddying, and pick a step by its measured contrast, shown below for the brand ramp.

Contrast measured against white
Acquisition · Q3 2026+18.4%

Cohort retention

100%75%50%25%0%
Wk 7 · 1,284
W1W2W3W4W5W6W7W8W9W10W11W12
primary · 100%

Direct

42% of new users

primary · 70%

Referral

28% of new users

primary · 45%

Search

21% of new users

primary · 25%

Social

9% of new users

brand ramp · fiery-coral

contrast vs white
5096.2% L1.12 : 1
10088.2% L1.45 : 1
30075.1% L2.32 : 1
50065.3% L3.45 : 1
60061.0% L4.08 : 1
70050.8% L · brandAA · 6.18
90035.4% LAAA · 11.56

status tones

Deployment succeeded

--color-foreground-success-muted

Quota approaching limit

--color-foreground-warning-muted

Build failed · 2 errors

--color-foreground-danger-muted

Typography

A pairing that ships long-form, dashboards, and code.

Besley for editorial moments. Manrope for everything else. JetBrains Mono for code and labels. 10 sizes, 8 weights, 3 families.

Wylie Dog Field Notes·Issue 14
8 min read

Engineering · April 2026

Why we rebuilt the entire color system in a week.

Ten months of hex codes, three product redesigns, and one paint-bucket migration later — here is what an OKLCH-native token system actually buys you.

EM

Elena Mori

Lead, Design Systems · 10 May 2026

Engineering

Every design system eventually hits the same wall: your color ramp made sense when it was just a handful of HEX values, but somewhere between the third palette expansion and the dark mode sprint, the math stopped working.

OKLCH fixes this because perceptual lightness is a first-class axis. When you step from oklch(0.508 0.139 37.8) to oklch(0.354 0.091 38.03), the difference is predictable — not a guess.

Spacing

One scale. Three densities. Same data.

The 4-pixel base scale powers every gap, padding, and inset in the system. Switch density on this real members table — every gutter, row height, and avatar size re-resolves through the same tokens.

Team members

14 active · 3 invited

AB

Akira Brennan

akira@compound.co

active
LG

Leila Garza

leila@compound.co

active
TP

Tom Parker

tom@compound.co

invited
SC

Sasha Chen

sasha@compound.co

active
MK

Min-jun Kim

min@compound.co

inactive
--space-150: 0.75rem (12px) (row padding and gap)--space-400: 2rem (32px)

Scale · --space-*

050
4px
100
8px
150
12px
200
16px · in use
300
24px
400
32px
500
40px
600
48px
700
64px

Composed tokens

--space-card-padding: 2rem

--space-input-padding-x: 1rem

Radius

Five corners. Every surface already knows which.

Radius isn't a design decision at use-time — it's encoded in the token. Every component surface resolves to its semantic radius automatically.

sm2px
DesignSystemsOKLCH

Tags & chips

--border-radius-sm

md4px

Buttons & inputs

--border-radius-md

lg8px
Edit
Duplicate
Archive

Menus & popovers

--border-radius-lg

xl12px

Pro plan

$49/mo

68% of limit used

Cards & tiles

--border-radius-xl

2xl16px

Invite teammate

name@company.com

Modals & sheets

--border-radius-2xl

Elevation

7 shadow steps — one stacking story.

Each step encodes both a shadow value and a semantic z-axis role. The scene below reflects honest stacking order.

xs · base

packages/ui

Button.tsx

md · popover
View changelog
Copy token
Open in Figma
lg · toast

Tokens published · v1.4.1

xl · modal

Invite teammate

name@company.com

Elevation ladder

sm

Cards, tabs, feature icons

--shadow-sm

base

Raised elements

--shadow-base

md

Menus, popovers, tooltips

--shadow-md

lg

Toasts, dialogs

--shadow-lg

xl

Largest floating surfaces

--shadow-xl

Dark mode redefines the same shadow tokens with higher opacity (0.3 to 0.4 instead of 0.05 to 0.1).

Motion

5 curves and 6 durations cover everything.

A default curve for most transitions, ease-out (decelerate) for entrances, ease-in (accelerate) for exits, and ease-in-out for symmetric moves. Pick a duration from the scale — the curve does the rest.

Live preview

New PR ready to review

feat/token-refresh · 3 files changed

animation: tile-rise 250ms cubic-bezier(0.4, 0, 0.2, 1)

Ready to wire tokens into your codebase?

Install the package or pull tokens straight into Figma with Token Bridge — both consume the exact same contract you saw on this page.