Figma holds the source of design truth

Components, variants and tokens defined once in Figma, with auto-layout mirroring how the same component should behave responsively in code - so a designer's intent for how a card should wrap or resize is unambiguous before a developer ever touches it.

Storybook holds the source of implementation truth

export default { title: 'Components/Button' };
export const Primary = () => <Button variant="primary">Click me</Button>;
export const Disabled = () => <Button disabled>Click me</Button>;

Every state of every component gets its own isolated story, viewable and testable without spinning up the whole application around it.

The two need to reference each other

We link each Storybook entry back to its Figma component and vice versa. It's a small amount of extra bookkeeping that pays for itself the first time a designer and a developer would otherwise have built two subtly different versions of the same button.

Figma defines the intent, Storybook proves the implementation

A design file can specify exactly what a button should look like in every state; it can't guarantee the built component actually matches once real content, edge-case text lengths, and browser quirks get involved. Pairing Figma components with matching Storybook stories closes that gap - every state gets built and visually verified in isolation before it's ever used in a real page.

// Button.stories.js
export const Disabled = { args: { disabled: true, children: 'Submit' } };
export const LongLabel = { args: { children: 'A surprisingly long button label' } };

The token layer is what keeps the two in sync

Shared design tokens - color, spacing, and type scale values defined once and consumed by both the Figma file (via variables or a plugin) and the codebase (via CSS custom properties or a JS token file) - are what stop the two from drifting apart after the first redesign. Without a shared source of truth, "does the build match the design" becomes a manual, error-prone comparison instead of a structural guarantee.