Mara Linden
← All work
Design systemTypeScriptAccessibility

One design system for three products.

Ledgerly's web app, admin console, and marketing site had drifted into three visual dialects. I led the effort to replace them with a single token-based component library.

Role
Lead frontend engineer
Team
5 engineers, 1 designer
Timeline
9 months, 2023
Stack
TypeScript, React, Storybook

The problem

Each surface had its own buttons, its own spacing, and its own idea of what an error looked like. Fixing a bug in one place meant fixing it twice more, and new features shipped with whichever version the author found first.

Design reviews had turned into arguments about which version was correct, instead of conversations about the product.

The approach

I started with tokens, not components: color, spacing, type, and radius, defined once and consumed everywhere. Components came second, built against those tokens and documented in Storybook.

  • Audited every existing component and merged 118 variants into 42.
  • Shipped a migration codemod so teams could adopt components without a rewrite.
  • Made keyboard and screen reader behavior part of each component's definition of done.

The results

Adoption was gradual and voluntary. Within two quarters the old components were deprecated across all three surfaces.

−34%UI bug reports
3 → 1component libraries
42documented components

What I'd do differently

I'd involve the support team earlier. They knew which broken patterns users hit most, and that data would have set our migration order better than our own intuition.