← Back to work
Design System/2024/Case study

Onyx — Design System

A scalable, token-based design system created for Onyx AI Lesson Planning — and the foundation for every future Onyx product surface.

Onyx Design System — hero
Project details

One source of truth across every Onyx surface.

Client
Reconstruction — a private Ed-Tech company developing and teaching K–12 curriculum throughout US school districts.
Role
Design Lead, Design System Architect
Duration
Ongoing — built alongside Onyx product
Tools
Figma · Tokens Studio · Storybook
My role
  • Architected a token-based design system to support the entire Onyx product family.
  • Defined foundations — color, typography, spacing, elevation, motion — and documented usage guidelines.
  • Built a reusable component library with accessibility and responsive behavior baked in.
  • Partnered with engineers on hand-off, naming conventions, and a shared language between design and code.
The problem

Designing fast without losing consistency.

As Onyx grew from a single AI lesson planner into a product family, every new feature was being designed from scratch. Components drifted, colors duplicated, and engineering hand-off slowed to a crawl.

We needed a single source of truth — a system that gave the team velocity while protecting brand and accessibility standards across every screen.

What we achieved

A shared language for design and code.

A documented, token-based system spanning color, typography, spacing, iconography, and components — with responsive behavior and accessibility requirements baked in from the start.

Designers ship faster, engineers reach for the right primitives, and the Onyx brand stays consistent as the product continues to expand.

01 — Foundations

Tokens before components.

Color

A semantic palette for surfaces, ink, and accents — paired with WCAG-checked contrast pairings for every combination.

Typography

A type scale tuned for long-form lesson content and dense data tables alike, with clear hierarchy across breakpoints.

Spacing & Layout

A consistent spacing rhythm and grid system so layouts compose predictably across products and form factors.

Iconography

A unified icon set sized to the type scale, with guidelines for stroke, weight, and metaphor.

Elevation & Motion

Reusable shadows and motion tokens that signal hierarchy and feedback without distracting from the content.

Accessibility

Focus states, contrast, and keyboard behavior defined at the token level — not bolted on at the component layer.

02 — Style guide

The system, end to end.

The full Onyx style guide — color, typography, components, and patterns documented in a single reference. Click to enlarge.

ONYX STYLE GUIDE - TYPOGRAPHY
ONYX STYLE GUIDE - COLOR PALETTE
ONYX STYLE GUIDE - NAVIGATION
ONYX STYLE GUIDE - BUTTONS
ONYX STYLE GUIDE - DROP DOWN
ONYX STYLE GUIDE - CHECK BOX & RADIO BUTTONS
ONYX STYLE GUIDE - SIDEBAR
03 — Outcomes

Built for the team that builds with it.

For designers

  • Faster screen production with a library of trusted primitives.
  • A clear contract for color, type, and spacing that prevents drift across features.
  • Ready-made patterns for common Onyx surfaces — onboarding, lesson flows, and dashboards.

For engineers

  • A shared vocabulary between Figma and code — tokens map 1:1 to component props.
  • Accessibility behavior documented and testable at the component level.
  • Less guesswork during hand-off; more time spent on product logic instead of pixel reconciliation.

Want a deeper walkthrough of the system or component library?

Let's create together