Tutorials
Friendly, step-by-step walkthroughs — start at the top and work down.
- Getting started
Install ds-bridge, answer the preferences dialog, and read your very first lint finding — start to finish, in about ten minutes, no Figma account required.
- Lint code against design tokens
Find every hardcoded color, spacing, and radius that should be a design token — and fix exact matches automatically.
- Track design-system health over time
Turn the checks you already run into numbers you can watch — on-system share and a system score, recorded run after run and on every push in CI — then set targets, share a one-page manager report, and export the numbers.
- Roll up analytics across repos
See every product repo that uses your design system in one ranked view — system score, on-system share, drift, contrast, readiness and freshness — built on your machine from the history each repo already records.
- Turn recurring exceptions into decisions
Not every deviation is a mistake. When a component keeps getting overridden run after run, ds-bridge flags it as needing an owner, so the team can decide whether to fix the usage or evolve the component, without ever hiding it from the numbers.
- Detect design token drift
Diff your token source against built outputs to find stale, missing, and orphaned tokens — scored and trended over time.
- Connect ds-bridge to Figma
Save your Figma token so it survives restarts, point ds-bridge at your design-system library, and register the product files your team designs in — the one-time setup behind every Figma-powered feature.
- Automated design handoff QA for Figma frames
Score any Figma frame’s handoff readiness 0–100: detached instances, raw values, missing styles — before an engineer is blocked.
- Figma to code component parity audit
A component-by-component matrix of what exists in Figma, what exists in code, and where the props disagree.
- From a Figma frame to on-system code
Point figma-impl at a frame and get code assembled only from your registered components and exact tokens — with everything it can't resolve reported as a gap instead of invented.
- Keep every mode WCAG-compliant with a11y-check
Audit your color tokens for WCAG contrast across light, dark, and every other mode — read which pairings fail, see lightness-only fixes, and gate CI on the result.
- Know the blast radius before a library change lands
Diff your published Figma library against the last snapshot, classify each change as breaking, additive, or cosmetic, see how many code call sites it touches, and gate CI on the breaking ones.
- One changelog for designers and developers
Turn your git history, Figma versions, and token changes into a single audience-segmented changelog — one document everyone on the team can read.
- Compose a dashboard for your role
Pick a persona view — one of six roles or everything — so ds-bridge report opens the dashboard you actually read, from one shared history, in HTML, terminal, or a published site.
- Component docs that write themselves
Turn your saved registry, a code scan, and your token map into one MDX page per component plus a machine-readable llms.txt — generated, gap-honest, and reviewable in a pull request.