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
DotCanvasbackground with a radial fade that reveals dots toward the edges. -
New:
dot-canvasis a decorative dotted canvas overlay for design surfaces. Usesize12,20, or24inside arelativecontainer. -
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:
traceis a composable list of agent steps with icons, titles, status, and expandable detail. Depends oncollapsibleandshimmer. -
New:
code-blockis a composable code panel with header, copy button, line variants, and a Shikihighlighterhelper. Depends onbuttonandscroll-fade. -
New:
use-highlighted-codestreams Shiki-highlighted React nodes for a code string and language. Depends oncode-block. -
New:
hero-01andhero-02are installable marketing hero blocks with announcement badge, dual CTAs, and product screenshot. They depend onbutton,heading, andtext.
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 addpulls 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: maintainersin their frontmatter.
October 6, 2026
v1.6.1
- Fix: The
stylesitem 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 appcnhelper treats those classes as sizes, so a text color no longer removes them. - Fix:
Headingsizes (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
cnregistration thosetext-*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-uiregistry URL on Installation and Styles athttps://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-themepalettes fromglobals.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
stylesitem now publishestheme-secondary.cssandtheme-tertiary.cssso the accent imports inglobals.cssresolve after install.
September 2, 2026
v1.5.3
- New:
useBodyOverflowis a hook that locks page scroll by togglingoverflow-hiddenondocument.body. - New:
useCloseMobileMenuOnResizeis a hook that dismisses mobile menus and overlays when the viewport is resized.
August 31, 2026
v1.5.2
- Breaking: Moved
Announcement Barfromregistry/items/blocks/hero/announcement-bar/toregistry/items/blocks/announcement-bar/as a standalone block item. Install targets now publish undercomponents/ui/announcement-bar/and declarecontaineras 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
viewBoxrather than fixedwidth/height, so it scales with theLogosizevariants.
August 14, 2026
v1.5.0
- Update: Components that use
class-variance-authoritynow keep everycva()call in a colocated<name>.variants.tsfile (.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, andToggle.Toggle Groupnow importstoggleVariantsfromtoggle.variants.ts. - Update: Renamed
container.variants.tsx/container.types.tsxto.tsso 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 theshadcn-registryskill so maintainers and coding agents follow the same layout asbutton.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 asIconsandLogosinstall undercomponents/icons/**andcomponents/logos/**(includingicon/,icon-set/,logo/, andlogo-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 publishedIconsandLogosfile; removed unusedicon-set/types.tsandlogo-set/types.tsstubs. - New:
Data Tablenow publishes samplepayments.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.mdxpages) so install paths match consumers’components.jsonaliases. - 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-uiincomponents.jsonon the Installation and Styles pages, so new projects can resolve namespaced install commands. - New:
Containeris a centered content wrapper with max-width size variants. - Docs: Published registry metadata and preview files for
Containerso it is discoverable in the registry catalog and docs. - New:
Iconsis a typed icon component with size variants and a searchable gallery for browsing and copying icons. - Docs: Published registry metadata and preview files for
Iconsso it is discoverable in the registry catalog and docs. - New:
Logosis a set of brand logo SVGs with a searchable gallery for browsing and copying. - Docs: Published registry metadata and preview files for
Logosso it is discoverable in the registry catalog and docs.
July 20, 2026
v1.2.0
- Docs: Added a
Headingpreview component to demonstrate sizing in the docs. - Update:
Headingstyles now use CSS variables for size and tone, improving theme consistency. - Docs: Improved
Headingcomponent compatibility and docs examples/stories. - Styles: Added centralized theme style imports and refined global selection styling.
- New:
Link Textis a polymorphic text-link component with tone, underline, size, and external-link options. - New:
Link Spreadis 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:
Sectionis a semantic wrapper component with responsive vertical padding variants. - Docs: Published registry metadata and preview files for
Sectionso it is discoverable in the registry catalog and docs. - Docs: Added a reusable
DemoSectionfor Storybook and aligned theSectionstory to render that shared demo. - New:
Spinneris an accessible loading indicator built on Lucide's Loader2 icon. - Docs: Published registry metadata and preview files for
Spinnerso it is discoverable in the registry catalog and docs. - New:
Textis a polymorphic body-text component with size, weight, tone, and alignment controls. - Docs: Published registry metadata and preview files for
Textso it is discoverable in the registry catalog and docs. - New:
Herois 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:
Buttonvariants 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
linkvariant. Use anas="a"button (or a link styled separately) instead. - Breaking: Removed the
icon-xssize. Useicon-sm,icon-md, oricon-lg. - Breaking: Resized icon buttons —
icon-mdis nowsize-9(wassize-10) andicon-lgis nowsize-10(wassize-12).
April 21, 2026
v1.0.1
- Fix: The pointer cursor now appears when hovering
Buttoncomponents.