Edge & Node (The Graph)'25

GDS: The Graph Design System

Took over design system efforts at The Graph while shipping product work. Tokens, 60+ components, design-dev parity, and custom tooling, now used by seven products.

Role
Design system owner and primary reviewer, alongside product design work
Timeline
2023 to present
Scope
Semantic token architecture, Component library in Figma and React, Design-dev parity, Figma plugins and Slack tooling, Code review
Stack
Figma variables, React, TypeScript, Tailwind CSS, Storybook
Outcome
  • Used by seven products: Subgraph Studio, Graph Explorer, The Graph Docs, thegraph.com, edgeandnode.com, Ampersend, and Amp Cloud
  • 60+ components rebuilt with matching props, states, and defaults in Figma and code
  • Teams build interfaces with GDS without a designer on every screen
00

Context

When I joined The Graph, I was told I'd take over design system efforts within a few months while continuing to ship product work. There was no dedicated team. The existing system had components but they weren't built with design system principles. A select component in Figma might have completely different states than the one engineers were working with. Designers and engineers were essentially working from different sources of truth, and handoffs reflected that.

Inconsistent Props
Button styling and many other components were inconsistent between Figma and code.
Different Sources
Designers and engineers were working from separate truths.
One-off Solutions
Components built for immediate needs, not scale
01

The Work

I started by auditing what existed and understanding why it wasn't working. Components had been built as one-offs, solving immediate needs without considering how they'd scale or connect to each other. Fixing this meant rebuilding from the ground up while keeping the system usable for teams who depended on it.

The work happened incrementally over months. I rebuilt form controls, buttons, navigation patterns, feedback components, and data display elements. I also added crypto-specific components that didn't exist anywhere else because no off-the-shelf library covers things like wallet selectors or token inputs.

Button component
Chip component
02

Component Library

Form controls, buttons, navigation patterns, feedback components, and crypto-specific elements like wallet selectors and token inputs. 60+ components rebuilt from the ground up.

03

Token Architecture

A complete token system for color, spacing, and typography. Every value has a semantic name and documented usage.

/
Gray Scale
100
200
300
400
500
600
700
800
900
1000
Brand Scale
100
200
300
400
500
600
700
04

Design-Dev Parity

What you see in Figma matches the code exactly: styling, functionality, prop names, prop values, defaults. Engineers don't have to guess or translate.

Figma
Properties Panel
React
Code
<Button
  variant="primary"
  size="medium"
  disabled={false}
  loading={false}
>Button</Button>
100% parity: prop names, values, and defaults match exactly
05

Custom Tooling

Some problems didn't have existing solutions, so I built them.

06

Outcome

Teams across the organization now use GDS to build interfaces without needing a designer involved in every screen. Data science builds dashboards with it. Product teams move faster because engineers trust that what they see in Figma will match what they ship. Design reviews focus on product decisions instead of catching implementation inconsistencies.

The system works the way a design system should: quietly, in the background, making other people's work easier.