storybook-chromatic-builder

Builds Storybook components, stories, and Chromatic visual regression testing from synced Figma design tokens.

77|11|Updated Jun 2, 2026
One-click install
npx skills add https://github.com/jrpease/throughline --skill storybook-chromatic-builder-jrpease
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: storybook-chromatic-builder
Source: https://github.com/jrpease/throughline/tree/main/skills/storybook-chromatic-builder
Command: npx skills add https://github.com/jrpease/throughline --skill storybook-chromatic-builder-jrpease

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Setting up the code side of a design system — Storybook, component implementations, stories, and visual regression testing — is repetitive, error-prone work that often drifts from the Figma source of truth. This Skill automates that entire pipeline so code components match the Figma spec and every change is visually tested. ## Core Features & Use Cases - Storybook setup and component building: Initializes Storybook in the monorepo wired to synced design tokens, then builds code components from Figma specs including slot contracts, variant props, and icon handling. - Parallel story generation: Dispatches subagents to generate stories per component with working controls, plus a single searchable icon gallery story. - Chromatic visual regression with cost guardrails: Configures Chromatic CI with full snapshots (avoiding TurboSnap pitfalls for token-driven systems), usage alerts, and scoped CI triggers. - Use Case: After syncing Figma tokens into a pnpm monorepo, run this Skill to stand up Storybook, generate stories for 40 components, and get a Chromatic PR workflow that catches visual regressions on every token update. ## Quick Start Set up Storybook and Chromatic for my design system monorepo and generate stories for all the components synced from Figma.

Frequently Asked Questions about storybook-chromatic-builder

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I set up Storybook for a design system monorepo?

Initialize Storybook in the UI package configured for your framework, wire it to consume the tokens package output, and share the app's global CSS rather than duplicating it. On pnpm workspaces, add esbuild to onlyBuiltDependencies so Storybook's first run succeeds.

How do I set up Chromatic visual regression testing in CI?

Generate the Chromatic config and a CI workflow that runs on pull requests and main only. Place the CHROMATIC_PROJECT_TOKEN in a gitignored .env locally and in GitHub Actions secrets for CI, then verify a build goes green.

Should I use TurboSnap with a token-driven design system?

No — TurboSnap's incremental tracing misses global token changes, since token edits live in a linked workspace package it cannot trace. Default to full snapshots of every story on every run; only reconsider at very large story counts.

Does Figma Code Connect work on all Figma plans?

No, Code Connect requires a Figma Organization or Enterprise plan. If the plan does not support it, the setup skips it gracefully and the component spec in the repo still records the Figma-to-code mapping.

Why do Storybook controls not update my component?

Controls break when the render function ignores its args, such as hardcoding props instead of spreading them. Use render: (args) => <Component {...args} /> and map boolean helper args to ReactElement slot props that object controls cannot drive.

How much does Chromatic cost for a design system?

Chromatic bills per snapshot, roughly stories times modes times builds. The free plan pauses testing around 5,000 snapshots per month, and paid plans have no hard cap, so set usage alerts and scope CI triggers before the first large token PR.