About Storybook DESIGN.md
Curated by Dov AzencotUpdated Source storybook.js.org
- Developer Tools & IDEs
Storybook's marketing page makes a choice that almost no other open-source dev-tool makes: the hero's visual protagonist is the product itself. A detailed mockup of the Storybook UI — component tree on the left, canvas in the center, controls panel on the right — sits inside a dark browser frame that spans the full hero width. The gradient behind it runs from near-black at the page center to a deep indigo-blue at the edges, creating a depth field that makes the product mockup appear to float. The brand's hot-pink logomark sits top-left but the pink goes nowhere else on the marketing surface; the only colors visible in the hero come from the rendered UI components inside the mockup.
The DESIGN.md file packages the system into a machine-readable spec for React tooling. Inside: 14 color tokens anchored on a near-black-to-midnight gradient canvas with a single structural gray hairline and a muted secondary text tier; 12 typography tokens running Nunito Sans at sizes from 12px caption to 56px display hero; 6 corner-radius tokens from 2px (the tightest code fragment rounding) through 9999px pill (the primary CTA); and 15 component definitions covering the gradient hero, the navy card surface, the pill-shaped primary button, the dark text input, and the brand logo badge. The gradient brand colors (hot pink, deep blue, gradient variants) are declared in the system but appear only inside the logomark and the hero gradient fill.
Feed this file to Claude or Cursor and it reproduces Storybook's specific moves: near-black gradient hero instead of a flat dark canvas, product-screenshot as the visual hero above the fold, pill CTAs against a dark surface, and Nunito Sans across every typographic tier without a second voice. The token set is notably restrained for a brand with this much chromatic personality in its logomark — the design discipline is the abstinence of the pink, held back so the product can carry the page.
What makes it distinct
- Product-screenshot canvasthe hero's visual anchor is a literal Storybook UI mockup inside a dark browser frame, not brand illustration
- Logo-mark pink as the only chromatic signalthe hot-pink-to-coral gradient appears in the Storybook logomark but is absent from any CTA, text, or card fill
- Midnight navy gradientthe above-fold hero graduates from near-black at center to deep indigo at edges, a depth effect rare in open-source dev-tools brands
- Nunito Sans across every tierdisplay sits at 56px / weight 700, body at 16px / 400, with no second typeface or mono voice on the marketing surface
- Pill-dominant radiusthe primary CTA and nav pills use 9999px full rounding; cards and inputs use 6px; the binary choice mirrors Cloudflare's structure
Live at storybook.js.org
A snapshot of the brand in production. Hover the frame to scroll the page; click to visit.
storybook.js.orgExplore Storybook
Pick what you want to see — mockups, colors, typography, layout, or the full component list.
Brand & Accent
Sparing, CTA-only voltage.
Surface
Page and card backgrounds.
Text
Headlines, body, captions, muted.
Borders & Hairlines
Dividers, outlines, structural rules.
Semantic
Status, errors, success, inline links.
Other
Specialty colors.
Storybook design system FAQ
Common questions about Storybook's tokens, components, and how to use this DESIGN.md in your project.
Related reading
Specs, directories, and component libraries that pair with this design system.
Browse all design systems
The full directory of DESIGN.md files on shadcn.io, with live mockups for each.
Storybook — official site
Storybook's public marketing site — the source of truth for the live tokens captured in this file.
The DESIGN.md specification
Google Labs' open spec for machine-readable design system files — the format this page is built on.