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
- Active maintenance: The repo shows fresh activity, with an upstream push on 2026-09-10 and multiple
shadcnand packageupdatesduring late Aug to early Sep 2026, indicating ongoing development rather than dormancy. - Update cadence: Changes are arriving on a roughly weekly rhythm in this window (for example,
4.19.1on 2026-08-31,4.20.0and4.20.1on 2026-09-02, and4.21.0on 2026-09-04), plus additional package updates in the same timeframe.
AI summary generated
Recent updates
shadcn@4.21.0
shadcn@4.21.0 switches the project to use the `cn` package as the source of the `cn` utility instead of composing it from `clsx` plus `tailwind-merge`. The release notes also mention internal `twMerge` usage coming from `cn` rather than `tailwind-merge` directly.
Featuresshadcn@4.20.1
shadcn@4.20.1 is a patch release that changes the `shadcn migrate cn` transformation to preserve leading comments (leading trivia) in CN migration output. The diff also updates the signed-commits GitHub workflow logic and bumps the package version used by apps/v4.
shadcn@4.20.0
shadcn@4.20.0 adds a new CLI migration, `shadcn migrate cn`, intended for Tailwind CSS v4 projects to migrate from `clsx`, `tailwind-merge`, and `cnfast` to `cn`. The code diff also includes additional, unrelated registry-health and `cn` utility changes in the monorepo.
Featuresshadcn@4.19.1
shadcn@4.19.1 is a small patch release. It updates the package metadata to include the official shadcn/ui website.
@shadcn/react@0.3.1
Release notes for @shadcn/react@0.3.1 describe a patch to MessageScroller to set `data-pending-scroll` on the root and viewport to prevent a scroll flash after server-side reloads. The provided code diff for this release, however, is dominated by substantial new functionality in apps/v4 related to registry health monitoring and documentation, which is not described in the release notes.
SecurityFeaturesshadcn@4.19.0
shadcn@4.19.0 adds support for fetching from private GitHub registries using either GH_TOKEN or GitHub CLI credentials. It also introduces a new migration, `npx shadcn migrate base-color`, to switch a project's base color.
SecurityFeaturesshadcn@4.18.0
shadcn@4.18.0 focuses on improving how registries are handled between components.json and package.json, and making file scanning more resilient to permission issues (skipping unreadable directories instead of failing). The release also changes how registry configuration is resolved in memory for commands like add/search/view/init, and adjusts migration scanning behavior.
Features@shadcn/helpers@0.2.0
This release of @shadcn/helpers@0.2.0 adds support for mocking human-in-the-loop flows in the AI SDK, including pausing on tool approval and continuing based on the user decision. It also updates the AI SDK `createChat` API typing to be generic over the UI message type, similar to `useChat`, improving type propagation across the chat transcript.
BreakingFeaturesshadcn@4.17.0
This release adds SOCKS4 and SOCKS5 proxy support to the registry HTTP stack. You can now configure SOCKS proxies via the standard curl-style environment variable `ALL_PROXY=socks4://...` or `ALL_PROXY=socks5://...`, while existing HTTP/HTTPS proxy handling remains unchanged via `HTTP_PROXY` and `HTTPS_PROXY`.
Featuresshadcn@4.16.2
This patch release adds support for richer questionnaire choice descriptions in the shadcn registry base components, introducing a new `QuestionnaireChoiceDescription` component and associated styling hooks. It also adjusts questionnaire spacing and alignment (shortcut, indicators, and error margin) across multiple style themes.
Features@shadcn/react@0.3.0
This @shadcn/react release introduces a new Questionnaire primitive for building multi-step question flows, including fixed and freeform answers, validation, and keyboard navigation. The accompanying app/docs changes add full documentation and multiple themed examples (Base, React Aria, Radix), plus a new changelog entry page for Questionnaire.
Featuresshadcn@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.
Features