StorybookGitHub

Changelog

Track user-facing changes to this registry.

Use this page to publish notable registry updates, new items, breaking changes, and migration notes.


October 18, 2026

v1.10.0

  • Docs: The maintainer Registry guide highlights the AI-ready authoring workflow, with an example prompt, repository skills, and validation steps.

  • Update: Gallery cards and detail preview panels use the shared DotCanvas background with a radial fade that reveals dots toward the edges.

  • New: dot-canvas is a decorative dotted canvas overlay for design surfaces. Use size 12, 20, or 24 inside a relative container.

  • Fix: Production builds resolve Shiki core without an unused WebAssembly loader, fixing the Vercel SSR build failure.

  • New: Registry detail headers link directly to their Storybook stories. Destinations are generated from story metadata and the configured Storybook URL, without per-item links to maintain. Missing stories show a dimmed, disabled action with a “Storybook Needed” hint.

  • Fix: Gallery previews now load only near the viewport, show loading feedback until rendered, and skip source highlighting and usage documentation when fetching preview data.

  • Update: Components now uses the shared searchable preview gallery with grid and stacked list views, linking to each component’s documentation inside the existing app shell.

  • Update: Blocks now has a searchable preview gallery with category filters, animated category indicator, grid and stacked list views, and direct links to existing block documentation. The Blocks sidebar groups variants by category with live item counts. Hero blocks groups the published hero variants.

  • New: trace is a composable list of agent steps with icons, titles, status, and expandable detail. Depends on collapsible and shimmer.

  • New: code-block is a composable code panel with header, copy button, line variants, and a Shiki highlighter helper. Depends on button and scroll-fade.

  • New: use-highlighted-code streams Shiki-highlighted React nodes for a code string and language. Depends on code-block.

  • New: hero-01 and hero-02 are installable marketing hero blocks with announcement badge, dual CTAs, and product screenshot. They depend on button, heading, and text.


October 5, 2026

v1.6.0

  • Docs: New Component flows page shows how registry items depend on each other. Choose between three layouts: a registry map, lineage lanes, or an install chain that lists everything shadcn add pulls in, in order. Search for an item by name to jump to its flow. The install chain shows each component's props: its variants with their options and defaults, plus the props it declares itself. Open Detailed list for a table of every prop with its type and default. Hover a node to preview another item's props. Props branches each prop into its own node on the canvas and is on by default; turn on Options to list every option with its default. Your layout choice is remembered for the browser session.
  • Docs: Docs pages meant for registry maintainers show a Maintainers badge in the sidebar. Registry is marked, since it covers authoring items in this repo rather than installing them. Mark other pages with audience: maintainers in their frontmatter.

October 6, 2026

v1.6.1

  • Fix: The styles item includes the contents of its CSS files again.
  • Docs: A docs page with no headings no longer reserves an On This Page column while it loads. On the install chain, What it installs and What depends on it sit in the canvas header with the other filters.

September 30, 2026

v1.5.7

  • Styles: The type scale in theme.css (text-14, text-label, and the other --text-* sizes) is one font-size theme. The docs app cn helper treats those classes as sizes, so a text color no longer removes them.
  • Fix: Heading sizes (text-60, text-72, and the rest of that scale) stay applied next to a tone color.
  • Docs: Styles documents the type scale and the cn registration those text-* sizes need. The README covers the same setup.

September 24, 2026

v1.5.6

  • Docs: Installation and Styles now use one package-manager switcher for the install command, matching component pages.

September 20, 2026

v1.5.5

  • Docs: Pointed the @design-system-ui registry URL on Installation and Styles at https://reactdocs.canceydejean.dev/r/{name}.json.

September 17, 2026

v1.5.4

  • Docs: Updated the Bun install command on Installation and Styles to bunx shadcn add "@design-system-ui/...", which works in new Bun projects.
  • Docs: Documented how consumer apps apply brand accents after installing Styles: ship data-theme palettes from globals.css, add a custom [data-theme] CSS file, or keep one component set with a palette file per brand for multi-brand teams. See Theming.
  • Styles: The styles item now publishes theme-secondary.css and theme-tertiary.css so the accent imports in globals.css resolve after install.

September 2, 2026

v1.5.3

  • New: useBodyOverflow is a hook that locks page scroll by toggling overflow-hidden on document.body.
  • New: useCloseMobileMenuOnResize is a hook that dismisses mobile menus and overlays when the viewport is resized.

August 31, 2026

v1.5.2

  • Breaking: Moved Announcement Bar from registry/items/blocks/hero/announcement-bar/ to registry/items/blocks/announcement-bar/ as a standalone block item. Install targets now publish under components/ui/announcement-bar/ and declare container as a local registry dependency.

August 15, 2026

v1.5.1

  • Update: The Instagram logo now renders the full-color gradient brand mark instead of the flat black glyph. It sizes from its viewBox rather than fixed width/height, so it scales with the Logo size variants.

August 14, 2026

v1.5.0

  • Update: Components that use class-variance-authority now keep every cva() call in a colocated <name>.variants.ts file (.ts, not .tsx). The component file imports the helper; it does not define CVA inline.
  • Update: Moved CVA out of component source for Alert, Attachment, Badge, Bubble, Button Group, Empty, Field, Input Group, Item, Marker, Navigation Menu, Sidebar, Tabs, and Toggle. Toggle Group now imports toggleVariants from toggle.variants.ts.
  • Update: Renamed container.variants.tsx / container.types.tsx to .ts so the file extension matches the variants convention.
  • Docs: Documented the Component Variants pattern on the Registry authoring page, with pointers from Agents docs, AGENTS.md, and the shadcn-registry skill so maintainers and coding agents follow the same layout as button.variants.ts.

August 10, 2026

v1.4.0

  • Breaking: Multi-file components now publish nested folder structure instead of flattening basename-only into ui/. Nested packages such as Icons and Logos install under components/icons/** and components/logos/** (including icon/, icon-set/, logo/, and logo-set/).
  • Update: Same-item relative imports are preserved in installed source so multi-file packages keep working after shadcn add (for example ./icon.variants, ./logo-set/apple, ../index).
  • Update: Added explicit install targets for every published Icons and Logos file; removed unused icon-set/types.ts and logo-set/types.ts stubs.
  • New: Data Table now publishes sample payments.tsx (columns + fixture data) as a registry file, not story-only source.
  • Docs: Install targets and usage examples updated across registry items (including Accordion, Button, Hero, and many component _registry.mdx pages) so install paths match consumers’ components.json aliases.
  • Docs: Component registry preview exports and docs samples tightened for catalog rendering.

July 22, 2026

v1.3.0

  • Docs: Documented how to register @design-system-ui in components.json on the Installation and Styles pages, so new projects can resolve namespaced install commands.
  • New: Container is a centered content wrapper with max-width size variants.
  • Docs: Published registry metadata and preview files for Container so it is discoverable in the registry catalog and docs.
  • New: Icons is a typed icon component with size variants and a searchable gallery for browsing and copying icons.
  • Docs: Published registry metadata and preview files for Icons so it is discoverable in the registry catalog and docs.
  • New: Logos is a set of brand logo SVGs with a searchable gallery for browsing and copying.
  • Docs: Published registry metadata and preview files for Logos so it is discoverable in the registry catalog and docs.

July 20, 2026

v1.2.0

  • Docs: Added a Heading preview component to demonstrate sizing in the docs.
  • Update: Heading styles now use CSS variables for size and tone, improving theme consistency.
  • Docs: Improved Heading component compatibility and docs examples/stories.
  • Styles: Added centralized theme style imports and refined global selection styling.
  • New: Link Text is a polymorphic text-link component with tone, underline, size, and external-link options.
  • New: Link Spread is an absolute-positioned anchor helper for making full card surfaces clickable.
  • Docs: Published registry metadata and preview files for both link components so they are discoverable in the registry catalog and docs.
  • New: Section is a semantic wrapper component with responsive vertical padding variants.
  • Docs: Published registry metadata and preview files for Section so it is discoverable in the registry catalog and docs.
  • Docs: Added a reusable DemoSection for Storybook and aligned the Section story to render that shared demo.
  • New: Spinner is an accessible loading indicator built on Lucide's Loader2 icon.
  • Docs: Published registry metadata and preview files for Spinner so it is discoverable in the registry catalog and docs.
  • New: Text is a polymorphic body-text component with size, weight, tone, and alignment controls.
  • Docs: Published registry metadata and preview files for Text so it is discoverable in the registry catalog and docs.
  • New: Hero is a registry block, including metadata and preview files so it is discoverable in the registry catalog and docs.

July 19, 2026

v1.1.0

  • Update: Button variants and sizes now use CSS variables for colors and typography, improving theme support (including dark mode on the primary variant).
  • Update: Simplified default icon (svg) sizing inside buttons.
  • Breaking: Removed the link variant. Use an as="a" button (or a link styled separately) instead.
  • Breaking: Removed the icon-xs size. Use icon-sm, icon-md, or icon-lg.
  • Breaking: Resized icon buttons — icon-md is now size-9 (was size-10) and icon-lg is now size-10 (was size-12).

April 21, 2026

v1.0.1

  • Fix: The pointer cursor now appears when hovering Button components.