NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
npm · #4267 most downloaded on npm
Add components to your apps.
Last release 3 days ago
01 Oct 2026
Ships fairly regularly
a new release about every 2 weeks
Nearly every release is documented
notes for 60 of the last 60 stable releases
Nothing withdrawn
no release was ever pulled
2 years old
301 releases · first in 2024
Updated dependencies [ bf6646b449684e687f28531305eca4e4768c2782 ]:
#12087 bf6646b449684e687f28531305eca4e4768c2782 Thanks @shadcn! - Add @shadcn/registry, the registry engine behind the CLI. shadcn now depends on it, and shadcn/registry and shadcn/schema re-export it, so there are no changes for existing users.
#12061 a9c1da49ec4eab488dc99c69ae20a7ffaa4897d4 Thanks @shadcn! - fix shimmer reduced motion handling when used with a variant
#12087 bf6646b449684e687f28531305eca4e4768c2782 Thanks @shadcn! - shadcn docs only rewrites links on the ui.shadcn.com host.
Updated dependencies [bf6646b449684e687f28531305eca4e4768c2782]:
One column per month.
8720dec73f5aebed9f649ea58636f54599fdedf1 Thanks @shadcn ! - use twMerge from cn instead of tailwind-merge internally.
c257f688cf4de7ec10cc1be84cad29cd4631182c Thanks @shadcn! - install cn and generate export { cn } from "cn" for lib/utils on init. Registry components now import cn from the cn package.8720dec73f5aebed9f649ea58636f54599fdedf1 Thanks @shadcn! - use twMerge from cn instead of tailwind-merge internally.Patch Changes #11742 04bb134c52af23af7d77673618ef4e3862b7c310 Thanks @shadcn ! - preserve leading comments when running shadcn migrate cn .
04bb134c52af23af7d77673618ef4e3862b7c310 Thanks @shadcn! - preserve leading comments when running shadcn migrate cn.Minor Changes #11728 51f3e12203b0026ea106cafb4f770bda9abead87 Thanks @shadcn ! - add npx shadcn migrate cn to replace clsx , tailwind-merge and cnfast
51f3e12203b0026ea106cafb4f770bda9abead87 Thanks @shadcn! - add npx shadcn migrate cn to replace clsx, tailwind-merge and cnfast in Tailwind CSS v4 projects.Patch Changes #11713 f9ea1e600ea5dd7b1b79769b7b25cafa400cee6f Thanks @shadcn ! - Add the official shadcn/ui website to the package metadata.
f9ea1e600ea5dd7b1b79769b7b25cafa400cee6f Thanks @shadcn! - Add the official shadcn/ui website to the package metadata.Minor Changes #11582 33c81f991f1013653444d6819107b2b356563f57 Thanks @shadcn ! - add private repository support to GitHub registries via GitHub CLI cr
#11582 33c81f991f1013653444d6819107b2b356563f57 Thanks @shadcn! - add private repository support to GitHub registries via GitHub CLI credentials or GH_TOKEN.
#11248 b4f2023b1d5c733db67d4e90eb9485a95c5ed480 Thanks @rbadillap! - add npx shadcn migrate base-color to switch a project's base color.
Minor Changes #11501 aef1cdca54e8da689351cdddf959342909e45e76 Thanks @shadcn ! - merge registries from package.json and components.json, and support a
aef1cdca54e8da689351cdddf959342909e45e76 Thanks @shadcn! - merge registries from package.json and components.json, and support adding registries to package.json when components.json is not present#11500 e66b99b14dd9c54afc434dbf5a702f170b1153b0 Thanks @shadcn! - Skip unreadable directories during file scans instead of failing with EACCES.
#11504 9f4e3ff26025d16a243ea03cc891c734c4cf0b59 Thanks @shadcn! - Skip unreadable directories when resolving monorepo targets.
#11502 87d71b3629c34f3c38a353a211ec8591c1ff1721 Thanks @shadcn! - resolve registries declared in package.json when adding components. shadcn add, search, view and init now resolve registries from package.json in memory without persisting them to components.json
#9248 03c45b822e60195796dfd3d2fcf7c223ff4ece86 Thanks @Grafikart! - Fix shadcn for projects with unreadable permission files
Proxy selection now goes through a createProxyDispatcher(env) factory that checks ALL_PROXY / all_proxy for a socks*:// URL before falling back to the
#10453 deda4df80fb350230b2fce2b575e769a90cae076 Thanks @nbouvrette! - Add SOCKS4/SOCKS5 proxy support to the registry HTTP stack via ALL_PROXY=socks5://... (the curl convention), backed by the socks package.
Proxy selection now goes through a createProxyDispatcher(env) factory that checks ALL_PROXY / all_proxy for a socks*:// URL before falling back to the existing HTTP/HTTPS handling. ALL_PROXY with a non-SOCKS scheme is ignored here — HTTP_PROXY / HTTPS_PROXY remain the way to configure those. Existing HTTPS_PROXY / HTTP_PROXY / NO_PROXY handling via undici.EnvHttpProxyAgent is unchanged.
Patch Changes #11348 df664e1bba86c6712bc5e08c8626590dca736089 Thanks @OwenKephart ! - Include registry item titles in searchRegistries results and fuz
df664e1bba86c6712bc5e08c8626590dca736089 Thanks @OwenKephart! - Include registry item titles in searchRegistries results and fuzzy matching.Patch Changes #11322 bfa1b5e9a69a155b2f590523d50fda810bde1a9a Thanks @AndrewBarba ! - fix shadcn build failing with ENOENT when registry item names co
#11322 bfa1b5e9a69a155b2f590523d50fda810bde1a9a Thanks @AndrewBarba! - fix shadcn build failing with ENOENT when registry item names contain path segments (e.g. extension/foo) by creating nested output directories before writing
#11352 5ca53ca7c7dea390e0e78091ff7c54adc48c773a Thanks @shadcn! - forward search params to registries for server-side dynamic search
Minor Changes #11307 431da7169cae753643e67e56e168b93ec31dfe90 Thanks @shadcn ! - make addRegistryItems accept explicit registry configuration instead
#11307 431da7169cae753643e67e56e168b93ec31dfe90 Thanks @shadcn! - make addRegistryItems accept explicit registry configuration instead of loading components.json
#11304 bf906bb8aeebc64d374afb54497b822d587ac6d7 Thanks @shadcn! - add getRegistriesConfig and registries in package.json support
Minor Changes #11276 7d90dfc0a5ec70cdc3bd08b741a42440041907ac Thanks @cmpadden ! - Add a public addRegistryItems API for installing registry items pro
7d90dfc0a5ec70cdc3bd08b741a42440041907ac Thanks @cmpadden! - Add a public addRegistryItems API for installing registry items programmatically without invoking the CLI.Patch Changes #11266 6cd3f4c65c361ab6554e06a77e6a0af9cf8b6e37 Thanks @shadcn ! - Add Base UI Toast support.
6cd3f4c65c361ab6554e06a77e6a0af9cf8b6e37 Thanks @shadcn! - Add Base UI Toast support.### Minor Changes - #11241 `3c26ee2dbd3a772c1cddc2c76249cc1cb0a250d5` Thanks @shadcn! - add support for icon migration
3c26ee2dbd3a772c1cddc2c76249cc1cb0a250d5 Thanks @shadcn! - add support for icon migration### Patch Changes - #11196 `c49c3061b5b86b130736d36bf20008349f89b416` Thanks @shadcn! - Drop custom registry headers on cross-origin redirects to prev
#11196 c49c3061b5b86b130736d36bf20008349f89b416 Thanks @shadcn! - Drop custom registry headers on cross-origin redirects to prevent credential leakage.
#11191 df2656111fc8ca030eb768ade2da26cef2fd11b5 Thanks @shadcn! - Validate file paths for registry items without an explicit target to prevent path traversal.
#11195 b8a8e9209659fa810514b61c60ad593bc81973f9 Thanks @shadcn! - Prevent flag injection from registry-supplied dependency strings during install.
#11208 2b89d67e19ceda27381477e127b349f9aaa25355 Thanks @shadcn! - Add React Aria support.
### Minor Changes - #11082 `f3e7de11752b087b1c4bf61f4035a866f3a4f9ed` Thanks @shadcn! - base-ui is now default
f3e7de11752b087b1c4bf61f4035a866f3a4f9ed Thanks @shadcn! - base-ui is now default### Minor Changes - #11022 `18fcf0f766857a7249cc0daac3c1609610edd158` Thanks @shadcn! - add scroll-fade and shimmer utilities
18fcf0f766857a7249cc0daac3c1609610edd158 Thanks @shadcn! - add scroll-fade and shimmer utilities### Patch Changes - #10905 `9197676b3d09b77f51b17b63e5978db29e498ca4` Thanks @shadcn! - replace node-fetch with native fetch - #10967 `365d53b590a6ddb
#10905 9197676b3d09b77f51b17b63e5978db29e498ca4 Thanks @shadcn! - replace node-fetch with native fetch
#10967 365d53b590a6ddb79c1487a9dbeabcde5f4ac37f Thanks @shadcn! - Preserve existing dependency specifiers in package.json when running shadcn add.
### Minor Changes - #10886 `05eb2b968bdc769ad78df9628dc2260e1dec903c` Thanks @shadcn! - improve search command ### Patch Changes - #10851 `7dfd933102f
05eb2b968bdc769ad78df9628dc2260e1dec903c Thanks @shadcn! - improve search command7dfd933102fdb881f8abd24fc1ef11a669682b94 Thanks @harshithasompura! - move msw to devDependencies### Minor Changes - #10842 `7c63c467361dee9e20631b2999040912439b35d4` Thanks @shadcn! - add support for GitHub registries. See the docs.
7c63c467361dee9e20631b2999040912439b35d4 Thanks @shadcn! - add support for GitHub registries. See the docs.Nothing published for this version
### Minor Changes - #10834 `8e2d2d1439f54260aa0c51747261c220334ec641` Thanks @shadcn! - add npx shadcn eject
8e2d2d1439f54260aa0c51747261c220334ec641 Thanks @shadcn! - add npx shadcn eject### Patch Changes - #10659 `07900769d91b09def00e68179bcb7a821f59b954` Thanks @raashish1601! - update template handling - #10495 `360e8a19c3ee13ac78b65
#10659 07900769d91b09def00e68179bcb7a821f59b954 Thanks @raashish1601! - update template handling
#10495 360e8a19c3ee13ac78b656027462007c8bdaa6d5 Thanks @artemxknpv! - Preserve quotes in className literals when applying RTL transforms.
### Patch Changes - #10786 `55ea86f2525e63c2d0373754314f0e31212572d2` Thanks @shadcn! - Update template handling.
55ea86f2525e63c2d0373754314f0e31212572d2 Thanks @shadcn! - Update template handling.### Patch Changes - #10779 `df1752dfe092957f84aa467d2270436139e3ecc7` Thanks @shadcn! - add style rhea
df1752dfe092957f84aa467d2270436139e3ecc7 Thanks @shadcn! - add style rhea### Minor Changes - #10715 `51e3cfaf32faeff2589e5c74d81ffd109f509e93` Thanks @shadcn! - add shadcn registry validate command - #10708 `c8ab3801ecf97c0
#10715 51e3cfaf32faeff2589e5c74d81ffd109f509e93 Thanks @shadcn! - add shadcn registry validate command
#10708 c8ab3801ecf97c0350ac0234a25e61f19ccaba62 Thanks @shadcn! - add include to registry.json
1c4a53a37adeba36dbd5c07980c5bb6d295cea9e Thanks @shadcn! - fix failing version derivation test### Minor Changes - #10519 `eb42ae25fda81e90e621f1e334e5126b1f22371d` Thanks @shadcn! - add support for package imports - #10528 `309d95017fce3936548c
#10519 eb42ae25fda81e90e621f1e334e5126b1f22371d Thanks @shadcn! - add support for package imports
#10528 309d95017fce3936548c15d2ef827c84560cc45a Thanks @shadcn! - allow alias placeholders in target for registry items
28b3e5f36086677b0533583817407d8f936a567b Thanks @shadcn! - add previous version error suggestion### Minor Changes - #10530 `ea6086cbcc33b359bb876651374e26f643ea85b1` Thanks @shadcn! - add shadcn preset commands - #10516 `c236d0c009b4ff87c77a04c61
#10530 ea6086cbcc33b359bb876651374e26f643ea85b1 Thanks @shadcn! - add shadcn preset commands
#10516 c236d0c009b4ff87c77a04c618d2b348cac7cdcb Thanks @shadcn! - add preset info to npx shadcn info
#10526 55fd4dc71be9e6410a528d6ce6bc7287ffba262c Thanks @shadcn! - update docs and info urls
#10524 6dea65ebcbbdb8773b3072ca74c9cee4e386988b Thanks @shadcn! - fix apply in monorepo
npx shadcn init --pointer will enable cursor: pointer on buttons.
#10488 eb6e783fb3861aba3b35289a473954080e6f1607 Thanks @shadcn! - add --pointer option to cli.
npx shadcn init --pointer will enable cursor: pointer on buttons.
`9c572ab778b5a0ab42693eb07bc4a75d0c24603e` Thanks @shadcn! - fix chartColor in presets
e456fed9d3f0b7aacf7084aecc02a75e8fde622d Thanks @shadcn! - add apply --only9c572ab778b5a0ab42693eb07bc4a75d0c24603e Thanks @shadcn! - fix chartColor in presets### Patch Changes - #10436 `b7cfc364aca36bc90f8efa86773bc81011502036` Thanks @shadcn! - Ensure init only runs template post-init hooks for newly creat
#10436 b7cfc364aca36bc90f8efa86773bc81011502036 Thanks @shadcn! - Ensure init only runs template post-init hooks for newly created projects.
#10179 d00605c5fb5fe3cfbcb68cea65398430cdd819f8 Thanks @EthanThatOneKid! - Send Accept: application/vnd.shadcn.v1+json, application/json;q=0.9 and User-Agent: shadcn on registry fetches so servers using HTTP content negotiation can reliably serve JSON to the CLI. Fixes #10164.
### Minor Changes - #10416 `101741046813622d48c081dfc19c40d0aa76484b` Thanks @shadcn! - add style sera
101741046813622d48c081dfc19c40d0aa76484b Thanks @shadcn! - add style seraNothing published for this version
### Minor Changes - #10313 `c1e29824cd7a6809448e45b6b7fe8f7be71ecb0f` Thanks @shadcn! - add shadcn apply command
c1e29824cd7a6809448e45b6b7fe8f7be71ecb0f Thanks @shadcn! - add shadcn apply commandNothing published for this version
### Patch Changes - #10246 `44c09a19b0658cf8e72ac84bbba5b76e05192a0d` Thanks @shadcn! - add style luma
44c09a19b0658cf8e72ac84bbba5b76e05192a0d Thanks @shadcn! - add style luma### Patch Changes - #10202 `12b49c986fcf7e6db9be7f515df6142f822f2236` Thanks @shadcn! - fix packageManager in package.json
12b49c986fcf7e6db9be7f515df6142f822f2236 Thanks @shadcn! - fix packageManager in package.jsonNothing published for this version
### Minor Changes - #10115 `687f09817b614a3450f0f56779edf367082e1e53` Thanks @shadcn! - add fontHeading to presets - #10115 `687f09817b614a3450f0f5677
#10115 687f09817b614a3450f0f56779edf367082e1e53 Thanks @shadcn! - add fontHeading to presets
#10115 687f09817b614a3450f0f56779edf367082e1e53 Thanks @shadcn! - add chartColor
Nothing published for this version
### Patch Changes - #10041 `a97ebe54f1824032d8ad00d1d0c079e3dc6f52d7` Thanks @shadcn! - Bundle @antfu/ni and tinyexec to fix missing module error with
a97ebe54f1824032d8ad00d1d0c079e3dc6f52d7 Thanks @shadcn! - Bundle @antfu/ni and tinyexec to fix missing module error with npxNothing published for this version
### Patch Changes - #9929 `f9b365bc7f9d591c995952976711dbdd7b1bc45a` Thanks @kapishdima! - add dependency field to registry:font
f9b365bc7f9d591c995952976711dbdd7b1bc45a Thanks @kapishdima! - add dependency field to registry:fontNothing published for this version
### Patch Changes - #10022 `7e93eb81ea8160c06c86f98bb6bfeb1ddfd0d237` Thanks @shadcn! - ensure monorepo respect package manager
7e93eb81ea8160c06c86f98bb6bfeb1ddfd0d237 Thanks @shadcn! - ensure monorepo respect package manager### Patch Changes - #9960 `5ee456735377158c12cf55eefbe872f7303e1325` Thanks @shadcn! - update handling of init urls
5ee456735377158c12cf55eefbe872f7303e1325 Thanks @shadcn! - update handling of init urls### Patch Changes - #9957 `aa841e35cf405e574123478b46f4058cff0e179a` Thanks @shadcn! - fix cache in resolveRegistryBaseConfig
aa841e35cf405e574123478b46f4058cff0e179a Thanks @shadcn! - fix cache in resolveRegistryBaseConfig### Patch Changes - #9950 `ce2c3ca688916db4fdb5fe173e9c6902f78696ed` Thanks @shadcn! - add support for translucent menu
ce2c3ca688916db4fdb5fe173e9c6902f78696ed Thanks @shadcn! - add support for translucent menu### Patch Changes - #9903 `f5ac4a0d2aa5af87202f67558a4b9b8f92c00bd2` Thanks @shadcn! - scaffold templates from github remote
f5ac4a0d2aa5af87202f67558a4b9b8f92c00bd2 Thanks @shadcn! - scaffold templates from github remoteNothing published for this version
### Patch Changes - #9896 `1ce9c2dd6a3d16422a6586e39632ebbccc45d3a4` Thanks @shadcn! - fix apple metadata files in template - #9897 `5edf9c95b7d13dcbd
#9896 1ce9c2dd6a3d16422a6586e39632ebbccc45d3a4 Thanks @shadcn! - fix apple metadata files in template
#9897 5edf9c95b7d13dcbd325aa4cf6b48d58a53b07c6 Thanks @shadcn! - fix fallback style resolving issue
### Major Changes - #9804 `605246f93b8c0c56eee0c1b25ccaa526e5cbdc1d` Thanks @shadcn! - add --monorepo flag and monorepo support for vite, start and re
#9804 605246f93b8c0c56eee0c1b25ccaa526e5cbdc1d Thanks @shadcn! - add --monorepo flag and monorepo support for vite, start and react-router
#9804 da10396f2b9b248c23bef05234ce222b0868ace4 Thanks @shadcn! - add new base colors: mauve, olive, mist and taupe
#9804 ce1f9259bfe043b3105350a3357249458ac41a1b Thanks @shadcn! - added --preset flag to init command
#9804 642d802eeef86a01a861de20e6da851cd3d8c974 Thanks @shadcn! - use multiplicative instead of addition for --radius calc
#9804 b9b30a23e644c952fbe52db337bfdd427bc6449f Thanks @shadcn! - add shadcn/skills
#9804 642d802eeef86a01a861de20e6da851cd3d8c974 Thanks @shadcn! - deprecate --base-color, --src-dir, --no-base-style flags
#9804 3bc23a60c7c825647265bca0942c330d1e93fcaa Thanks @shadcn! - deprecate create and make it an alias of init
#9804 fae5e7829263d80eb4b19bdcc9b8ea595060b837 Thanks @shadcn! - add astro template support
#9804 4bdd23291c499159098e2b2e27b738041a514558 Thanks @shadcn! - add --reinstall flag for init
#9804 4fa2ef66ed6e99a02ea4524e45568440968a6c27 Thanks @shadcn! - add shadcn docs command
#9804 642d802eeef86a01a861de20e6da851cd3d8c974 Thanks @shadcn! - add --base to shadcn init
#9804 642d802eeef86a01a861de20e6da851cd3d8c974 Thanks @shadcn! - deprecate --css-variables flag from shadcn add
#9804 0d3f6a0812c51b36a6c7618e3b9eadd758860321 Thanks @shadcn! - deprecate registry:build and registry:mcp
#9804 4307815c0fa7576668e1d39999a284e350dbfc66 Thanks @shadcn! - add preset code support
#9804 5f9691670188b5b411f84d16ca7db2693c922155 Thanks @shadcn! - refactor shadcn info command to output llm-friendly output
#9804 642d802eeef86a01a861de20e6da851cd3d8c974 Thanks @shadcn! - refactor ordering of updaters
#9804 646f884e8fddd196cff3e118184733522516193d Thanks @shadcn! - add --dry-run, --diff and --view to the add command
#9804 642d802eeef86a01a861de20e6da851cd3d8c974 Thanks @shadcn! - getTailwindCssFile fallback to config.tailwind.css
#9804 642d802eeef86a01a861de20e6da851cd3d8c974 Thanks @shadcn! - add support for hooks, lib and ui install for workspaces
#9804 4a96d95bde1bb2e692e61808ccc6b9c8e00676f4 Thanks @shadcn! - fix kbd display in tooltip
#9804 2ddd920e4d7c251eb96c88398b98bfe1f6ea0b8a Thanks @shadcn! - warn if in monorepo and cwd not set
#9708 82f03d0f1dd12efb5395a0b8689533588d778d0c Thanks @shadcn! - handling of apply directive inside utility
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
### Patch Changes - #9599 `bbb59c9fe1b3517db01d3a80cb7559da142ad14b` Thanks @shadcn! - fix handling of nested aschild transforms
bbb59c9fe1b3517db01d3a80cb7559da142ad14b Thanks @shadcn! - fix handling of nested aschild transformsNothing published for this version
Nothing published for this version
### Patch Changes - #9568 `a1e3afed06a78474abff6a729ff990938f455719` Thanks @shadcn! - remove restricted blocks
a1e3afed06a78474abff6a729ff990938f455719 Thanks @shadcn! - remove restricted blocksYour coding agent can read these notes before it upgrades. Set up the MCP server →