A set of beautifully designed, accessible UI components with documentation at ui.shadcn.com. It is useful for building and customizing your own component library, and it works with popular frontend frameworks such as React and Next.js.
Project status
- Actively maintained: Yes, GitHub upstream push was on 2026-07-29, and the most recent updates are within days (4.16.0 on 2026-07-27, 4.15.0 on 2026-07-25).
- Apparent update cadence: Frequent, roughly weekly across the main
shadcnpackage in this window (4.11.1 to 4.16.0 spans about a month with multiple versions).
AI summary generated
Recent updates
shadcn@4.16.1
This patch release includes the documented dynamic-search change, where the CLI can forward search parameters to registries to enable server-side filtering. It also includes a fix for `shadcn build` failing with ENOENT when registry item names contain path segments. In addition to those two items, the diff shows a broader internal refactor of the apps/v4 registry/example component loading mechanism and a Next.js version bump.
Featuresshadcn@4.16.0
shadcn 4.16.0 introduces new registry configuration plumbing, primarily centered around a new getRegistriesConfig API and changing addRegistryItems to accept explicit registry configuration instead of implicitly loading components.json. It also adds support for reading registries from the top-level registries field in package.json. The code changes go beyond the brief release notes, especially around TypeScript exports and default behavior when components.json is absent.
BreakingFeaturesshadcn@4.15.0
shadcn@4.15.0 introduces a new public programmatic API, `addRegistryItems`, intended as the non-CLI equivalent of `shadcn add`. The implementation also refactors registry handling to use async-local context for headers and env vars, and updates registry fetching and installation logic to be safer for concurrent operations.
BreakingFeaturesshadcn@4.14.1
This patch release adds Base UI Toast support to shadcn, including a new registry entry for a `toast` component backed by `@base-ui/react`, plus new documentation and examples. The code changes also adjust how deprecated components are selected and presented for Tailwind v4 and for Base UI presets, and update the v4 app to mount the new Base UI Toaster.
BreakingFeaturesshadcn@4.14.0
This release primarily expands shadcn's icon migration tooling. However, the code diff also introduces a larger UI behavior change, adding hover-based preview overrides to multiple “picker” components (design system create/typeset flows), including iframe parameter synchronization logic.
Featuresshadcn@4.13.1
shadcn@4.13.1 is a patch release focused on hardening registry-related install behavior and improving accessibility by adding React Aria support. The release notes call out fixes for credential leakage on cross-origin redirects, path traversal prevention, and flag injection prevention.
SecurityFeatures@shadcn/react@0.2.1
This patch release focuses on fixing MessageScroller autoScroll behavior around anchored turns, especially when streamed content changes the viewport. It also addresses a ResizeObserver warning by coalescing resize callbacks to requestAnimationFrame, and fixes an issue where an autoScroll-enabled anchor could be abandoned during streaming.
shadcn@4.13.0
shadcn@4.13.0 announces that Base UI is now the default component library instead of Radix. The code changes go beyond release-note scope, including URL preset syncing behavior in the create/customizer flow and multiple internal UI changes that appear to reflect a move to different Base UI component APIs and styles.
Breaking@shadcn/react@0.2.0
This release is published as @shadcn/react@0.2.0 and is described in the notes as the initial release of the package. The release notes do not call out any API, behavior, or migration changes beyond that single statement.
Featuresshadcn@4.12.0
Release shadcn@4.12.0 is documented as a minor change adding scroll-fade and shimmer utilities. The actual diff, however, includes a broader set of changes across the apps/v4 documentation site (new @shadcn/react docs, new message scroller/animation components, streamdown-based markdown), and significant changes to the repo’s release and prerelease automation workflows.
Featuresshadcn@4.11.1
shadcn@4.11.1 is a patch release. The documented changes focus on swapping node-fetch for the runtime-native fetch API, and on preserving existing dependency specifiers when running `shadcn add`.
shadcn@4.11.0
shadcn@4.11.0 includes a documented minor improvement to the search command and a patch that moves `msw` to `devDependencies`. However, the provided code diff shows additional UI registry changes that are not described in the release notes.
shadcn@4.10.0
shadcn@4.10.0 introduces first-class support for GitHub-backed registries and items, allowing registry and item resolution from GitHub owner/repo references (optionally with #ref). The change adds new address parsing, GitHub ref resolution (via git ls-remote), GitHub source fetching/validation, and updates CLI/docs to describe the new address formats.
Featuresshadcn@4.9.0
Version shadcn@4.9.0 is released with notes claiming a single minor change, adding an `npx shadcn eject` command. However, the provided code diff shows many user-facing updates across theme button style registry files (and adds new full-dark/full-light images), which are not described in the release notes.
shadcn@4.8.3
This patch updates shadcn template handling during scaffolding, and improves RTL className string literal handling. Specifically, template workspace detection and pnpm-workspace.yaml processing were revised, and the RTL transformer was adjusted to preserve quoting correctly.
shadcn@4.8.2
shadcn@4.8.2 is described as a patch release that updates template handling. The code diff shows several additional, user-impacting changes beyond that note, including changes to how registries are generated/served in apps/v4, dependency upgrades, and significant edits to multiple starter templates.
Featuresshadcn@4.8.1
shadcn@4.8.1 is a small patch release with release notes that only mention adding “style rhea”. The code diff shows substantial UI additions in apps/v4 (new cards and skeleton components built on the base-rhea design system), plus CI and repo configuration changes not mentioned in the release notes.
Featuresshadcn@4.8.0
shadcn@4.8.0 ships a minor set of registry-related updates, including a new registry validation command and changes to how registries are included. The patch notes also mention a fix for a failing version derivation test. However, the code diff shows additional site content and UI template changes that are not covered by the release notes.
Featuresshadcn@4.7.0
shadcn@4.7.0 adds support for package.json import maps and allows registry item targets to use alias placeholders (for example, @components/, @ui/, @lib/, @hooks/). It also improves error handling by suggesting a previous minor version command when operations fail. Under the hood, there are additional refactors to alias resolution, import rewriting, and init behavior that are not covered in the release notes.
Featuresshadcn@4.6.0
shadcn@4.6.0 introduces new `shadcn preset` CLI commands for decoding, resolving, sharing, and opening preset codes, plus related documentation updates. The diff also shows a broad switch of registry example-code URLs to a new `ui.shadcn.com/code/...` path, and it updates docs around the `apply` command. A monorepo-related `apply` fix is also mentioned in the release notes.
Features