Run Storybook locally
Clone the repo, install dependencies, and start the dev server:http://localhost:6006. Hot reload is on by default.
What the sandbox contains
The sandbox covers all 10 components, each with a story per interaction state.The contract between specs and stories
Every state listed underinteraction_states: in a component spec must have a corresponding Storybook story. This is a hard gate — a component cannot be promoted to AI-Ready status until all stories exist.
For Button, the spec declares:
apps/storybook/stories/Button.stories.tsx. The AI-Ready gate checks this correspondence mechanically.
Example story structure
Stories live inapps/storybook/stories/<Component>.stories.tsx. Here is the structure for Button:
interaction_states list. Add a state to the spec, add a story to the file.
Promoting a component to AI-Ready
Before you setstatus: AI-Ready in a component spec, confirm:
- Every entry in
interaction_states:has a named export in the component’s.stories.tsxfile. - The story renders correctly in the live sandbox (run
pnpm storybookand check). checks.states_complete: truein the spec frontmatter.
ai-ready-gate validation rule.
Auto-deploy
Storybook auto-deploys to clementine-ds-storybook.vercel.app on every push tomain after CI passes. You do not need to trigger a manual deploy. Push your branch, merge, and the live sandbox reflects your changes within minutes.