Design Mode
Design-system maintainers

Design-system audit on a deployed app

Design systems decay. Engineers under deadline reach for raw hex codes; designers hand off without checking tokens; a year later the deployed app uses 14 shades of grey. Design Mode is the fastest way to find and fix the drift.

The problem

Reading code for drift means parsing thousands of CSS rules. Reading the design system file doesn't tell you what's actually deployed. The only ground truth is the rendered page.

The workflow

  1. Step 1

    Walk the deployed app

    Open key pages with Design Mode. Use the colour picker to spot non-token colours.

  2. Step 2

    Log drift as structured changes

    Replace off-spec values with the correct token. Each replacement is logged.

  3. Step 3

    Export the audit

    Markdown export becomes the audit report. Engineering ships the fixes as one or many PRs.

The outcome

A deployed app that matches the design system. A reproducible audit that can run again next quarter.

Related use cases