← All cases

Enterprise B2BDesign systemWiki & handoff

Growing a design system at an early stage

Joined when the base existed but did not cover new modules: added components, documented rules in an internal wiki — handoff became more predictable for engineering.

Context

The design system was early but already live: base components and tokens existed before I joined. The product line grew — new dashboards, tables, and configurators needed elements and clear usage rules.

The goal was not to build from zero but to evolve for real screens: add missing components and variants, document behavior and handoff in an internal wiki, so the team stopped reinventing UI each time.

Problem

At the start the system could not keep up with the product:

Library gapsNew modules needed components not yet in Figma.
Unstructured wikiUsage and state rules were not collected in one place.
Handoff via chatEngineering kept asking the same questions about spacing, hierarchy, and themes.
Theme driftLight and dark component versions were documented unevenly.
No single referenceDesign QA relied on team memory, not a document.

Process

  1. Audited what components and states existed and where new screens broke consistency — via layout review and engineering questions.
  2. Extended the Figma library: new components and variants for operational UI — buttons, fields, status pills, dense tables and panels.
  3. Documented components, usage rules, and handoff in an internal wiki: which variant when, how states behave, light and dark considerations.
  4. Aligned changes with engineering, ran design QA against wiki and library on new module releases.

Solution

Library extension

Closed gaps that blocked new modules.

Composition
New components and variants for dashboards, tables, forms, and status UI.
Solution
Extended the existing system, not a parallel set of ad hoc elements.

Wiki as source of truth

Documentation both design and engineering can return to.

Composition
Component descriptions, states, hierarchy, light/dark examples.
Solution
Handoff no longer depended on verbal agreements and personal notes.

Design QA against the system

New screens checked against library and wiki, not by eye.

Composition
Checklist for components, themes, and documented patterns.
Solution
Fewer gaps between layout, implementation, and what wiki already describes.

Diagram: component → wiki → handoff

Not a catalog from scratch but a chain: extend library, fix rules, team validates implementation against the doc.

ComponentVariantState WikiLightDark Figma library · internal wiki · design QA

Result

The design system became more practical: new screens use the extended library, rules live in wiki, handoff and design QA are more predictable.

+New components

Extended the library with elements and variants missing for new product modules.

2Themes in wiki

Light and dark — rules and examples for both without duplicating layouts.

WikiDocumentation hub

Components, states, and handoff — one internal source for design and engineering.

3Handoff steps

Figma library → wiki description → design QA before module release.

NDA

Anonymized role and process description without confidential product data. The system existed before I joined; my contribution is early-stage growth, new components, and wiki documentation.