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, with an upstream push on October 27, 2026, just two days before this assessment.
- Updates have been frequent in the recent period, with several component, CLI, registry, and tooling updates between October 7 and October 27.
AI summary generated
Recent updates
shadcn@4.23.0
shadcn 4.23.0 upgrades its MCP implementation to the MCP TypeScript SDK v2, adding support for protocol version 2026-07-28 while retaining compatibility with earlier versions. It also changes the public MCP server API and adds a per-connection server factory; the diff additionally changes runtime requirements and some MCP capability and logging behavior not covered by the release notes.
BreakingFeaturesshadcn@4.22.2
This patch release updates the `undici` dependency to 7.30.1 and updates `@shadcn/registry` to 0.2.1. No user-facing features, behavior changes, or migration steps are described.
@shadcn/registry@0.2.1
The documented change for @shadcn/registry 0.2.1 is an update of undici to 7.30.1. The diff also includes unmentioned changes to application build and tracing configuration, registry data, generated templates, and numerous template dependencies.
shadcn@4.22.1
shadcn@4.22.1 is a patch release focused on fixing how `shadcn add` determines which UI components are available when a project uses a specific style. It updates the component picker and `--all` behavior so the component list matches the project’s resolved style, rather than an initial/default guess.
@shadcn/helpers@0.3.0
Release @shadcn/helpers@0.3.0 is documented as a minor streaming improvement: add `{ preliminary: true }` to the tool handle's `output()` so preliminary tool output can be streamed. However, the actual diff contains many additional application, UI, and docs changes that are not mentioned in the release notes.
BreakingFeaturesshadcn@4.22.0
shadcn@4.22.0 upgrades shadcn/schema and @shadcn/registry/schema to export Zod 4 schemas. This changes TypeScript typechecking behavior and some Zod error/wording details, so code that previously mixed these schemas with Zod 3 can fail to compile or behave differently at runtime.
Breaking@shadcn/registry@0.2.0
This release upgrades @shadcn/registry to Zod 4. The exported registry schemas and types have been updated accordingly, which affects TypeScript typechecking and validation error handling when used with Zod 3 patterns.
BreakingFeaturesshadcn@4.21.5
This is a patch release focused on dependency updates and a fix to MCP (Model Context Protocol) search and list output. It updates several packages, including @modelcontextprotocol/sdk and undici, and addresses a UI bug where commands were rendered as "[object Promise]".
@shadcn/registry@0.1.4
Version 0.1.4 of @shadcn/registry is a patch release that primarily reorganizes internal module locations (moving code out of the utils folder) and updates the undici dependency. The diff also shows a small but potentially user-visible behavior change in env merging logic that is not mentioned in the release notes.
Breakingshadcn@4.21.4
This patch release removes the ts-morph dependency from @shadcn/registry and rewrites multiple code transformation steps to run without ts-morph. When transformation is not possible, the tooling now skips the change and emits a warning instead of writing broken Next.js layouts or Tailwind config.
@shadcn/registry@0.1.3
Release @shadcn/registry@0.1.3 refactors the registry code generation pipeline to remove the ts-morph dependency and reimplement required code transforms and crawling without it. It also adds additional safety behavior so that when Next.js layout, Tailwind config, or other transforms cannot be applied safely, it skips the write and emits a warning instead of generating broken files.
shadcn@4.21.3
This patch release fixes a Windows-specific CLI startup issue where running the shadcn CLI via pnpm dlx could throw ERR_REQUIRE_CYCLE_MODULE. It also updates the @shadcn/registry dependency to version 0.1.2.
@shadcn/registry@0.1.2
This patch release primarily addresses a Windows-specific CLI failure, `ERR_REQUIRE_CYCLE_MODULE`, when running via `pnpm dlx`. The code diff also shows an internal schema import path refactor and a build configuration hardening in the registry package.
shadcn@4.21.2
shadcn@4.21.2 is a patch release focused on improving project config file handling and making npm-based install workflows faster by skipping extra checks. It also updates the @shadcn/registry dependency to 0.1.1.
@shadcn/registry@0.1.1
This release updates @shadcn/registry to improve JSON config file handling and reduce dependency weight by replacing cosmiconfig with a custom JSON reader/explorer. It also expands test coverage around BOM handling (UTF-8 byte order mark) and introduces stricter behaviors around how JSON config files are found and parsed.
shadcn@4.21.1
This patch release introduces the @shadcn/registry package (registry engine behind the CLI) as a dependency and re-exports it through shadcn/registry and shadcn/schema, with no expected changes for existing users. It also fixes reduced-motion handling for shimmer variants and narrows shadcn docs link rewriting to the ui.shadcn.com host.
BreakingFeatures@shadcn/registry@0.1.0
This release introduces @shadcn/registry as the registry engine behind the shadcn CLI. The release notes state shadcn now depends on it and that @shadcn/registry and @shadcn/schema re-export it, so existing users should not see changes.
Featuresshadcn@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.
Features