Home Works Info
← Back to All Work

iStaging Design System — From Zero to AI-Ready

A token architecture built from scratch in Figma, then bridged to Claude — one source of truth serving designers, developers, and AI across five products.

Role
Sole Designer & System Owner
Token architecture · Figma variables & modes · Component library · AI workflow integration
Timeline
Ongoing
Platform
Figma · Web · AI workflows
Team
Valerie LinSole Designer & System Owner
Product by
Token architecture and component library
The Problem

Five products, no shared language — and an AI-shaped opportunity.

Business

  • Every new product rebuilt basics from scratch
  • Handoff friction slowed every launch

User

  • Designers making decisions in isolation
  • Developers interpreting specs differently each time

Technical

  • Two interface paradigms — CMS editor and spatial viewer
  • Tokens must be machine-readable for AI workflows
Why This Was Hard
01

Zero to system, solo

One designer building shared infrastructure for five products.

02

Two paradigms, one source

Minimal CMS surfaces and glass spatial UI generated from the same tokens.

03

Naming as contract

Every token name doubles as a CSS custom property — no translation layer allowed.

04

AI-readability

The system had to be parseable by Claude, not just by humans.

My Role

I built the system alone — architecture, library, and the AI bridge.

Owned

  • Token Architecture
  • Component Library
  • Multi-Product Theming
  • AI Workflow Integration

Collaborated with

  • Developers (token adoption)
  • Product Teams (rollout)
Key Decisions

Decisions that made one system feed humans and AI.

01
Decision 01 — Foundation

Variables over static styles

Challenge

Static styles require manual updates across every file and every product.

Decision

Variable-first: every color, spacing value, radius, and type scale is a Figma variable.

Reasoning

One change must cascade everywhere — and structured variables are machine-readable.

Outcome

Five product libraries collapsed into one variable-driven source.

Three-tier token architecture
Before: fragmented components
02
Token naming mapped to CSS
Semantic token detail
Decision 02 — Alignment

Token names that speak CSS

Challenge

Design systems die in translation between design names and code names.

Decision

A primitive → semantic → component hierarchy mapping 1:1 to CSS custom properties.

Reasoning

If developers need a lookup table, they won't use it — and neither will AI.

Outcome

Figma and the codebase share one language; handoff roughly 60% faster.

03
Decision 03 — Future

AI as a system consumer

Challenge

For a one-person team, a system that only documents is dead weight.

Decision

Structure tokens and modes so Claude parses the .fig files against the codebase.

Reasoning

Systematic naming lets AI generate on-brand output without manual translation.

Outcome

Brand-consistent prototypes in hours instead of days.

Dual-mode components: CMS and spatial viewer
iStaging Design System — decision 3 detail
Innovation

Dual-mode components

The same component renders solid in the CMS and glass in the spatial viewer.

AI-native tokens

Claude reads the token structure to generate branded, code-ready output.

80/20 coverage

Maintained components for repeated patterns; documented principles for the rest.

Impact
Product
5→1
Component libraries consolidated into one variable-driven source
Team
60%
Faster design-to-development handoff via token-aligned naming
Team
3×
Fewer iteration rounds — variable changes propagate instantly
Business
Hours
AI-assisted prototyping with brand styles pre-applied, down from days
Reflection

The trade-off — I invested in variable architecture when Figma variables were new and unstable. Setup cost was high, but it bought automatic cascade and AI-readability — the two properties everything else depends on.

What I'd improve — documentation for the unmaintained 20% of patterns is principle-based; worked examples per product would reduce drift.

Next time — design systems should be built as data from day one. The AI leverage came entirely from structure, and I would formalize token export even earlier.

Project Showcase
Design system overview
iStaging Design System — showcase b