Globalfair Design System
Tokens, primitives, and patterns that scaled across 4 product lines and 60+ engineers.
The brief.
Four product teams. Three accidental design languages. Globalfair DS unified them under one tokens layer — semantic, themable, and engineered so a button is a button is a button.
Every team had shipped their own primitives. Buttons varied by 4px of padding and seven shades of blue. We needed a system that respected speed without sacrificing coherence.
Talking to real users.
- ✦Component audit
- ✦Consumer interviews (devs + designers)
- ✦Adoption pulse surveys
- ✦Doc-site analytics
12 engineers · 6 designers · 3 PMs across 4 product lines
8 weeks audit + rolling adoption research
"I copy-paste from the last PR. That's my design system."
"I want tokens I can trust — not a Figma of best-effort ghosts."
- Insight 01
Docs are the product
Adoption rose sharply once docs shipped runnable code, not just anatomy diagrams.
- Insight 02
Migration needs a partner
Embedded designer for two weeks unblocked more than any Loom could.
- Insight 03
Semantic tokens win
Teams stopped asking for new colors once intent tokens (danger/success/info) existed.
How it came together.
- 01
Audited 1,200 components across four products; landed on 38 primitives that covered 92%.
- 02
Defined semantic tokens (intent, surface, density) — never raw hex in components.
- 03
Shipped docs as a product: live previews, copy-paste code, a11y notes, and migration guides.
- 04
Embedded with each product team for two weeks during rollout to unblock in real time.
Inside the work.
