Case Study

Design System:
built from zero

I owned the creation of IntegrityNext's design system from scratch — not polishing an existing library, but defining foundations, structure, and governance so design and engineering could move at the same speed, in a way that's legible to both humans and AI tooling.

Company
IntegrityNext
Role
Product Design Lead
Timeline
Oct 2023 — Present
integritynext.com / design-system
Design system color guide — primary, semantic, and AI palettes
01

Context

When I joined this initiative, IntegrityNext had no shared design system in the modern sense. UI had grown organically — designers worked from scattered patterns, engineers relied on a legacy MUI theme and ad hoc components, and there was no single source of truth connecting design decisions to code. Handoffs were slow, inconsistent, and hard to scale, especially as the product expanded across sustainability, compliance, and supply-chain workflows.

As Product Design Lead, I owned creating a design system from scratch — defining foundations, structure, and governance so design and engineering could move at the same speed.

02

The challenge

The core problem was never missing buttons or colors — it was a missing system:

Gap
No token architecture for color, typography, spacing, elevation, or breakpoints
No consistent component variants, states, or usage rules
No structure designers and developers could both navigate
No format readable by AI tooling (Cursor, Claude) for faster prototyping and handoff
High cost every time a screen moved from wireframe → hi-fi → implementation

The business needed faster delivery, stronger design–dev alignment, and a foundation that could eventually support white-label and theme variations — without rebuilding from zero again.

03

Approach

I framed the work as a two-phase initiative.

Phase 1 — Foundations
Icons (Streamline-based set), a scalable token architecture, typography, color semantics, spacing, elevation, and radius — each with explicit "when to use / when to avoid" guidance.
Phase 2 — Component optimization
Audited and rebuilt components using React-friendly conventions (PascalCase names, camelCase props), organized in a MUI-familiar structure — Inputs, Data Display, Feedback, Navigation — with IntegrityNext's own visual language and product-specific components layered on top.

Underneath both phases, I applied atomic design — atoms (tokens, icons, base styles) → molecules (inputs, chips, list items) → full components and patterns. Every component includes written descriptions, so the system is legible to humans and to AI assistants, not only as pixels in Figma.

04

What I built

Figma design library
A tokenized library covering the full foundation layer — typography (Geometria scale), color system (primary, semantic, chip, priority palettes), spacing, shadows, border radius, breakpoints — plus 30+ components with variants, states, and usage tables, structured atoms/molecules-first to match how engineers think.
Written specification
A comprehensive design system spec — 4-column tables mapping every token and component to usage rules and React-app implementation paths — exported to Markdown and HTML so it's shareable outside Figma.
Agent-ready workflow
Structured the library and docs so Cursor can read tokens, variants, and rules directly, and built a Claude skill for prototyping — letting designers and PMs generate UI from the system instead of inventing patterns screen by screen.
Organizational integration
Initiated moving the written spec into the company's shared context repo, so PRDs, spec docs, and frontend agents consume one canonical design source, with Design Lead review as governance.
integritynext.com / design-system / buttons-guide
Buttons system guide — CTA types, icon patterns, and wording rules
Buttons system guide — CTA hierarchy, icon patterns, selection controls, and wording rules.
integritynext.com / design-system / button
Button component — variants, states, and spacing rules
Button component — primary, secondary, danger, and text variants with states and 24px spacing rules.
figma.com / design-system / button / properties
Button component properties in Figma — variants, states, icons, and loading
Button properties — variant, color, size, state, loading, and icon slots defined as Figma component props for dev handoff.
integritynext.com / design-system / text-field
Text field component — outlined inputs and helper text
Text field — outlined inputs, helper text, error states, and textarea patterns.
integritynext.com / design-system / chip
Chip component — status, risk, and compliance mappings
Chip component — workflow status, risk severity, compliance, and AI probability color mappings.
05

Impact

AreaOutcome
SpeedWireframe → hi-fi → dev handoff is faster, with fewer "which button?" debates
ConsistencyShared tokens and component rules reduce one-off UI across dashboards, assessments, and modals
Design ↔ EngineeringMUI-aligned structure and naming gives developers a familiar mental model, with INX-specific customizations documented
AI / toolingTokenized, described components enable Cursor-readable specs and Claude-based prototyping
ScalabilityToken architecture is built to support future modes — dark theme, white-label — without a full rebuild
06

Key decisions

01

MUI-like structure, custom INX design. Borrow familiarity, not generic Material aesthetics.

02

Usage rules, not just components. Every token and component answers when and why, not only what it looks like.

03

Atoms → molecules. Composable, maintainable, and agent-parseable by construction.

04

Documentation as a first-class deliverable. The system lives in Figma and in a written spec agents can consume — not just in designers' heads.

05

Incremental code adoption. The design system lands in product incrementally — no forced big-bang migration.

07

Reflection

This project was not a visual refresh. It was infrastructure for how IntegrityNext designs and ships UI. Starting from zero, I defined the initiative, built the tokenized Figma library, wrote the cross-functional specification, and created an AI prototyping workflow — so design quality scales with the product, not with individual heroics.

Where it stands

Live and in review.

The next phase is deepening variable and mode rollout, completing component contracts in code, and expanding standards — accessibility, UX writing — on the same foundation.

Design System Strategy Token Architecture Atomic Design Design–Dev Alignment Cross-Functional Documentation AI-Ready Design Ops Design Leadership Figma Variables & Component Props
Let's talk about this → ← Back to selected work