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.
Latest stable
4.23.0
Last release 20 days ago
27 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
314 releases · first in 2024
Drag across the ruler to compare, or tap a release to open it.
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
Your coding agent can read these notes before it upgrades. Set up the MCP server →
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 blocks### Patch Changes - #9539 `e0063070a63751efd40cf5e5d93da3c9536e64c8` Thanks @shadcn! - use tw-merge to transform-style
e0063070a63751efd40cf5e5d93da3c9536e64c8 Thanks @shadcn! - use tw-merge to transform-style### Patch Changes - #9507 `b7b839ebc254120eb9bf1a138ce979c38fc348d6` Thanks @shadcn! - update migrate radix command
b7b839ebc254120eb9bf1a138ce979c38fc348d6 Thanks @shadcn! - update migrate radix command### Patch Changes - #9502 `2bf55c91338525f886f7c4a7b1fe820155d6bace` Thanks @shadcn! - properly detect already installed fonts
2bf55c91338525f886f7c4a7b1fe820155d6bace Thanks @shadcn! - properly detect already installed fonts### Minor Changes - #9498 `38de7fddc257f04901e98a5fd7821cb8729d54bf` Thanks @shadcn! - Add RTL support ### Patch Changes - #8798 `2acaf954d7492ce722d2
38de7fddc257f04901e98a5fd7821cb8729d54bf Thanks @shadcn! - Add RTL support2acaf954d7492ce722d2a7ee02747dc8f85691ef Thanks @VeiaG! - Fix: skip all transforms for universal registry items### Minor Changes - #9156 `66d24007849ca34c18a5c28b55f2d8dac29ce1e0` Thanks @nrjdalal! - add remix icons - #9351 `682c98989d28971a04382da1f174b970fff9
#9156 66d24007849ca34c18a5c28b55f2d8dac29ce1e0 Thanks @nrjdalal! - add remix icons
#9351 682c98989d28971a04382da1f174b970fff91d92 Thanks @shadcn! - add registry add command
### Patch Changes - #9161 `f2583391eafc22a6ec6c9299a8ad9fac857f8181` Thanks @yeasin2002! - validate app name on create - #8422 `c2fd847d65bfccde531cf1
#9161 f2583391eafc22a6ec6c9299a8ad9fac857f8181 Thanks @yeasin2002! - validate app name on create
#8422 c2fd847d65bfccde531cf1b4462ae466446efa06 Thanks @aquaticcalf! - add mcp support for opencode
### Patch Changes - #9126 `df67e49aac8c87da59a4257164f55ef0f53b55de` Thanks @shadcn! - add create command to readme - #9044 `137b1c12b7bde1318c8781680
#9126 df67e49aac8c87da59a4257164f55ef0f53b55de Thanks @shadcn! - add create command to readme
#9044 137b1c12b7bde1318c8781680b41ae449e40df8f Thanks @mezotv! - add phosphor icons
## 3.6.1 ### Patch Changes - #9054 `d3156c09ae1df2321c0505db6b2e637374e320f7` Thanks @shadcn! - fix resolver for url
d3156c09ae1df2321c0505db6b2e637374e320f7 Thanks @shadcn! - fix resolver for url## 3.6.0 ### Minor Changes - #9022 `86d9b00084affa7010e6c7c7bd410ec62525caac` Thanks @shadcn! - add registry:base item type - #9022 `86d9b00084affa701
#9022 86d9b00084affa7010e6c7c7bd410ec62525caac Thanks @shadcn! - add registry:base item type
#9022 86d9b00084affa7010e6c7c7bd410ec62525caac Thanks @shadcn! - add npx shadcn create
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
### Patch Changes - #8997 `6699158a22e376a6abc91693843a64cdb0b496da` Thanks @shadcn! - fix handling of base styles for add command - #8993 `142cd8ef13
#8997 6699158a22e376a6abc91693843a64cdb0b496da Thanks @shadcn! - fix handling of base styles for add command
#8993 142cd8ef13a0ff691a94bbd73dba9d7a62428ffa Thanks @pasqualevitiello! - Prevent duplicate keyframes when adding components
### Patch Changes - #8900 `d0fb73ac0e4e7f6d02768586c5232bbc6b33a3c3` Thanks @shadcn! - do not install base style when adding themes - #7557 `ad6a3c636
#8900 d0fb73ac0e4e7f6d02768586c5232bbc6b33a3c3 Thanks @shadcn! - do not install base style when adding themes
#7557 ad6a3c63678bb31dbfb94536ee1d4aa4f06a8b8d Thanks @remorses! - Fix utils import transform when workspace alias does not start with @
#8901 62218c1c0c79195bda49a36817a13392cae7b4f2 Thanks @shadcn! - update color value detection for cssVars
Nothing published for this version
### Minor Changes - #8555 `d7e0dc3ec81676d47351e8f7134639e0dd0c3e3c` Thanks @shadcn! - rename middleware to proxy for Next.js 16 - #8550 `6bddba986d75
#8555 d7e0dc3ec81676d47351e8f7134639e0dd0c3e3c Thanks @shadcn! - rename middleware to proxy for Next.js 16
#8550 6bddba986d75da35e18343dbb6254fed4537b7d7 Thanks @shadcn! - add Next.js 16 support for init command
### Patch Changes - #8478 `b52ec12f1e22cf89270bf3d931f5b7544e4b80b4` Thanks @shadcn! - fix regression with universal item detection
b52ec12f1e22cf89270bf3d931f5b7544e4b80b4 Thanks @shadcn! - fix regression with universal item detection### Patch Changes - #8420 `40c3ff513a88ca8e6f02bf798a7cf73b88401024` Thanks @zbeyens! - Fix support for universal registry items that only have depend
#8420 40c3ff513a88ca8e6f02bf798a7cf73b88401024 Thanks @zbeyens! - Fix support for universal registry items that only have dependencies without files
#8459 7cd019ad3652a0e98770b89032b7a161edfda805 Thanks @shadcn! - add support for color as var
#8451 b83023034a301b41fa18045af0d9bd787e415aa5 Thanks @diegohaz! - fix adding registry item with CSS at-property
### Minor Changes - #7742 `da8fa6aacdf58191bfd4eb6bc65f2fb02ec137ad` Thanks @sirldev! - rename monorepo project on init - #8348 `e96f9edf027c8f97dc565
#7742 da8fa6aacdf58191bfd4eb6bc65f2fb02ec137ad Thanks @sirldev! - rename monorepo project on init
#8348 e96f9edf027c8f97dc565b6e6c2fbd6f258bfa1e Thanks @shadcn! - add mcp support for codex
`75dde2e64679081dad63ecd20f3fd9e3b68fa0ce` Thanks @shadcn! - fix deps in cts projects
75dde2e64679081dad63ecd20f3fd9e3b68fa0ce Thanks @shadcn! - fix deps in cts projects### Minor Changes - #8216 `fc6d909ba23ac1ba09cf32087f0524aca398b5aa` Thanks @shadcn! - add getRegistriesIndex ### Patch Changes - #8186 `cdf58be7e1ed2
fc6d909ba23ac1ba09cf32087f0524aca398b5aa Thanks @shadcn! - add getRegistriesIndex#8186 cdf58be7e1ed25bf1dd19a1c60612c5e89b82a60 Thanks @imskyleen! - fix transformCssVars function with prefix
#8036 fae1a81addb22429c103d5d08813e1c80779d5fb Thanks @fuma-nama! - fix async imports not being transformed when installing components
### Patch Changes - #8147 `e5402f9a20f070e92e7384c1ae08e6bfb79cd7a9` Thanks @shadcn! - fix recursive namespacing
e5402f9a20f070e92e7384c1ae08e6bfb79cd7a9 Thanks @shadcn! - fix recursive namespacing### Minor Changes - #8128 `9c5eb0d20f0b75b28dccee219bf74fc9cd2019c6` Thanks @shadcn! - add support for registries index
9c5eb0d20f0b75b28dccee219bf74fc9cd2019c6 Thanks @shadcn! - add support for registries index### Minor Changes - #8110 `64f8baf9aa7562d4d2170863c29c6ae723f31df3` Thanks @shadcn! - allow no files items - #8109 `e84c819977046f555daa9a8af5736ad77
#8110 64f8baf9aa7562d4d2170863c29c6ae723f31df3 Thanks @shadcn! - allow no files items
#8109 e84c819977046f555daa9a8af5736ad7725fb4da Thanks @shadcn! - update handling of import and apply at rules
### Major Changes - #8004 `a941287411e4cf4eca29779a8220d59bfca2a25c` Thanks @shadcn! - bump all dependencies - #7994 `4f5333ea7ae8a2197fb84472addaa9fd
#8004 a941287411e4cf4eca29779a8220d59bfca2a25c Thanks @shadcn! - bump all dependencies
#7994 4f5333ea7ae8a2197fb84472addaa9fd66d984ef Thanks @shadcn! - add view and search commands
#7983 a426fea9410ade04c26bb4edfa5da813ecaddc17 Thanks @shadcn! - update getRegistry, getRegistryItems and resolveRegistryItems apis
#7990 b3639227d0737538e98923ab335b6dd03f2c993f Thanks @shadcn! - deprecate fetchRegistry and resolveRegistryTree
#7972 6e870c399350adf17554c35cdf732421ac8a6ab2 Thanks @shadcn! - copy registry.json on build
#7989 a4a36007578a6847c0b1f02c1b46350de6ebe2cc Thanks @shadcn! - move schema to shadcn/schema
#8001 fed7e3bfdc2696b8bc1fb8e65134e96330347aa0 Thanks @shadcn! - update signatures for getRegistry, getRegistryItems, resolveRegistryItems and searchRegistries
#7992 7d71b02fb1c69b649fd143d0eeab1ddc7995f5ca Thanks @shadcn! - add getRegistry
#7948 2c164b0f221fac0367a0eda3ce8502b38b25ce3e Thanks @shadcn! - update registry dependencies resolution algorithm
#7940 578f83cbefe1b3d70b8179a58c70c5729fd1982f Thanks @shadcn! - add support for namespaced registries
a80ab374830fa414bf3672fefc66b03ea4b8da78 Thanks @shadcn! - update file handling for monorepo#8081 fc27ba269217ade8ae3a87724259874da799cd03 Thanks @shadcn! - fix --defaults option
#7962 fc8927a1f9d7d1be3338e3d984de20355af61083 Thanks @shadcn! - fix monorepo init on nix system
#8004 a941287411e4cf4eca29779a8220d59bfca2a25c Thanks @shadcn! - bump all dependencies
#8012 296feb28a220627958f3a558dcb2384875c2d7a1 Thanks @shadcn! - add new mcp server and command
#7994 4f5333ea7ae8a2197fb84472addaa9fd66d984ef Thanks @shadcn! - add view and search commands
#7983 a426fea9410ade04c26bb4edfa5da813ecaddc17 Thanks @shadcn! - update getRegistry, getRegistryItems and resolveRegistryItems apis
#7990 b3639227d0737538e98923ab335b6dd03f2c993f Thanks @shadcn! - deprecate fetchRegistry and resolveRegistryTree
#7972 6e870c399350adf17554c35cdf732421ac8a6ab2 Thanks @shadcn! - copy registry.json on build
#7989 a4a36007578a6847c0b1f02c1b46350de6ebe2cc Thanks @shadcn! - move schema to shadcn/schema
#8001 fed7e3bfdc2696b8bc1fb8e65134e96330347aa0 Thanks @shadcn! - update signatures for getRegistry, getRegistryItems, resolveRegistryItems and searchRegistries
#7992 7d71b02fb1c69b649fd143d0eeab1ddc7995f5ca Thanks @shadcn! - add getRegistry
#7948 2c164b0f221fac0367a0eda3ce8502b38b25ce3e Thanks @shadcn! - update registry dependencies resolution algorithm
#8086 17422714f65a36a9fc81eeb227366a2e44171be9 Thanks @shadcn! - add mcp init command
#7940 578f83cbefe1b3d70b8179a58c70c5729fd1982f Thanks @shadcn! - add support for namespaced registries
a80ab374830fa414bf3672fefc66b03ea4b8da78 Thanks @shadcn! - update file handling for monorepo#8081 fc27ba269217ade8ae3a87724259874da799cd03 Thanks @shadcn! - fix --defaults option
#7962 fc8927a1f9d7d1be3338e3d984de20355af61083 Thanks @shadcn! - fix monorepo init on nix system
### Minor Changes - #7902 `e6778dee87de1a183843f233b3f27fbfb1a700ec` Thanks @shadcn! - add support for envVars in schema - #7896 `97a8de1c1b2ae590cc9d
#7902 e6778dee87de1a183843f233b3f27fbfb1a700ec Thanks @shadcn! - add support for envVars in schema
#7896 97a8de1c1b2ae590cc9dbe17970a882990c35a59 Thanks @shadcn! - add support for envVars in registry
d891132f2a0121e12c92839e19f5d90252f9a640 Thanks @shadcn! - clean up tests#7902 e6778dee87de1a183843f233b3f27fbfb1a700ec Thanks @shadcn! - add support for envVars in schema
#7896 97a8de1c1b2ae590cc9dbe17970a882990c35a59 Thanks @shadcn! - add support for env vars in registry
d891132f2a0121e12c92839e19f5d90252f9a640 Thanks @shadcn! - remove init tests### Patch Changes - #7837 `20e913d8e1df1acddc7bd4b8328088a25869ba7c` Thanks @shadcn! - fix handling of themes
20e913d8e1df1acddc7bd4b8328088a25869ba7c Thanks @shadcn! - fix handling of themesNothing published for this version
### Patch Changes - #7833 `d9cdc3f7ae69e571de7dc116effc381ad76685c3` Thanks @shadcn! - Revert "fix: handling of shouldOverwriteCssVars"
d9cdc3f7ae69e571de7dc116effc381ad76685c3 Thanks @shadcn! - Revert "fix: handling of shouldOverwriteCssVars"### Patch Changes - #7829 `ed5237c231f3b70107131bd7ba517e73b8c9014d` Thanks @shadcn! - fix handling of shouldOverwriteCssVars
ed5237c231f3b70107131bd7ba517e73b8c9014d Thanks @shadcn! - fix handling of shouldOverwriteCssVars### Minor Changes - #7782 `06d03d64f437b543bf5fa07ccbc559f285538ffd` Thanks @shadcn! - add universal registry items support ### Patch Changes - #7795
06d03d64f437b543bf5fa07ccbc559f285538ffd Thanks @shadcn! - add universal registry items support#7795 6c341c16aeaf5ade177a4a1ba4fb9afcd33d5fee Thanks @shadcn! - fix safe target handling
#7757 db93787712fe51346bf87dbae8b4cf4e38ed8c27 Thanks @shadcn! - implement registry path validation
Nothing published for this version
Nothing published for this version
### Minor Changes - #7720 `d544a7f7a519cd5b171d9ee7cb2fd1a226659ece` Thanks @shadcn! - refactor registry dependencies resolution - #7717 `48fe0d709fd2
#7720 d544a7f7a519cd5b171d9ee7cb2fd1a226659ece Thanks @shadcn! - refactor registry dependencies resolution
#7717 48fe0d709fd2b244314f95f56e7afb38b117ed8a Thanks @shadcn! - add support for local registry item
#6330 ed244ea0b5abf7db50ac5fcf26e2993133fe94f7 Thanks @KitsuneDev! - add support for vinxi based framework
Nothing published for this version
Nothing published for this version
### Minor Changes - #7540 `cb19ab84646fc017c15fadc81fc47b695560a04c` Thanks @mrzachnugent! - add support for expo - #7640 `7c3d34cdc91681815f889770991
#7540 cb19ab84646fc017c15fadc81fc47b695560a04c Thanks @mrzachnugent! - add support for expo
#7640 7c3d34cdc91681815f8897709917ec9fbcd69245 Thanks @shadcn! - add support for @plugin in css
5b8ee41511fb5ff468d9218f97b8545e145d773c Thanks @xabierlameiro! - fix typo in function name unnsetSpreadElementsNothing published for this version
### Patch Changes - #7601 `c86c27a2ffb8d186770afa42bfb62ab46e3db975` Thanks @schiller-manuel! - fix tanstack start detection
c86c27a2ffb8d186770afa42bfb62ab46e3db975 Thanks @schiller-manuel! - fix tanstack start detection### Patch Changes - #7594 `431af4f7ff294af032c0687b8b655ed6db2e690f` Thanks @shadcn! - fix: semicolon in code style
431af4f7ff294af032c0687b8b655ed6db2e690f Thanks @shadcn! - fix: semicolon in code style### Patch Changes - #7586 `c5d90c718a186dd6fd90e022c56089eb569a1c10` Thanks @shadcn! - add migrate-radix - See the docs - #7590 `92cfb9a30e976697ab877
#7586 c5d90c718a186dd6fd90e022c56089eb569a1c10 Thanks @shadcn! - add migrate-radix - See the docs
#7590 92cfb9a30e976697ab8770f00393bd5325f9a16a Thanks @shadcn! - fix flacky tests
#7586 c5d90c718a186dd6fd90e022c56089eb569a1c10 Thanks @shadcn! - add migrate-radix
#7590 92cfb9a30e976697ab8770f00393bd5325f9a16a Thanks @shadcn! - fix flacky tests
### Patch Changes - #7573 `3119f94d47426dae860001a4cfb4ef23396dd41d` Thanks @shadcn! - update npm flag
3119f94d47426dae860001a4cfb4ef23396dd41d Thanks @shadcn! - update npm flag### Minor Changes - #7497 `df91b528871e258d548e4ea318b0376ac78676e0` Thanks @shadcn! - add registry:build command ### Patch Changes - #6885 `2773f9e2e
df91b528871e258d548e4ea318b0376ac78676e0 Thanks @shadcn! - add registry:build command2773f9e2e29cf67e521632d15d1ba302a82e39e9 Thanks @Joshua-hypt! - resolved prefixing issue for Tailwind CSS v4 compatibilityNothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
### Minor Changes - #7220 `d0306774fe0ecc1eae9ef1e918bf7862e866a9e8` Thanks @shadcn! - resolve imports from anywhere ### Patch Changes - #6985 `f1e5cc
d0306774fe0ecc1eae9ef1e918bf7862e866a9e8 Thanks @shadcn! - resolve imports from anywhere#6985 f1e5cc4666ced2166a859660d769ccee16cde46e Thanks @nrjdalal! - move tw-animate-css to devDependencies
#6899 6f702f5fbf2b82a388e7da6ea08bcc84c2ec19c6 Thanks @justjavac! - start working on deno support
d0306774fe0ecc1eae9ef1e918bf7862e866a9e8 Thanks @shadcn! - resolve imports from anywhere#6985 f1e5cc4666ced2166a859660d769ccee16cde46e Thanks @nrjdalal! - move tw-animate-css to devDependencies
#6899 6f702f5fbf2b82a388e7da6ea08bcc84c2ec19c6 Thanks @justjavac! - add deno support
Nothing published for this version
### Patch Changes - #7196 `617483fe9c26d607665fcaf79ee26e35d9825d7c` Thanks @shadcn! - do not throw if empty dir
617483fe9c26d607665fcaf79ee26e35d9825d7c Thanks @shadcn! - do not throw if empty dir### Minor Changes - #6507 `5234c46722750f964d69c92ccbef2c4d260c211d` Thanks @shadcn! - add support for TanStack Start - #6487 `5ef2bc5f455dfc394116267
#6507 5234c46722750f964d69c92ccbef2c4d260c211d Thanks @shadcn! - add support for TanStack Start
#6487 5ef2bc5f455dfc394116267788c0514b696e13b0 Thanks @shadcn! - add theme vars support
#6478 8f6a64f176defdb1f9c493598d952fb4e9844cd0 Thanks @shadcn! - add tailwind version detection
#6864 19665adeeddc4ddb34e91fca219753d15bd46480 Thanks @shadcn! - add --base-color flag
#6490 9a14c1d0925d3df2c8f57a3381d212cc3e54f4a6 Thanks @shadcn! - add support for tailwind v4
#6707 3db8a07b3f132d396d7fb2e50da96156efcb4138 Thanks @shadcn! - default to css vars. add --no-css-variables
#6968 205bfc637e093717908ebd2c591b215672950558 Thanks @shadcn! - replace tailwindcss-animate with tw-animate-css
#6574 1e357cb20d6024b2bc9766fb15f61cb989eb7024 Thanks @shadcn! - default for new-york for v4
#6515 d1eb24e23a973646d78cf101fa1e0a22861ac9fd Thanks @shadcn! - fix handling of sidebar colors
#6693 3740373f99e39943514a45f5808ecb5f17faf700 Thanks @shadcn! - add oklch base color
#6571 c74a094f14a6e338124709547932dbb20c8d1324 Thanks @shadcn! - hotswap style for v4
#6576 9f4d65fc8fe72f632706fafd4036f63fd9317780 Thanks @shadcn! - add warning for deprecated components
#6811 bc7df68620f242ce6aa640839c80ddc8afc7e091 Thanks @shadcn! - add support for route install for react-router and laravel
#7016 b3b2fe2755e0ec1271c41a2a61b1a6933af42bc6 Thanks @shadcn! - add theme prop to registry-item schema
#6724 a3fe5074c1375cbd92e1ccdaab38d6808bfec696 Thanks @Kaikaikaifang! - support for version detection in monorepo
#6414 202131cd7bf8829b962ae4027545afbdfe79e688 Thanks @palmithor! - upgrade @antfu/ni
#6965 69fc8e23cc0631aac6b708ba0481509f1125d3d7 Thanks @jherr! - allow silent mode with npm
#6814 8539dd6eec948e7a6218c7ca3372d2b1f349d7c0 Thanks @shadcn! - do not add ring for v3
#6732 839afa714f61e2c0f83e9417354ea6ba8246c177 Thanks @shadcn! - cache registry calls
#6863 c16c58d0f9e672edddd554269fdd0eb0d412cb9d Thanks @shadcn! - add --template flag
#6721 a5122f9029c91963f493e7348ef7681dad4834e5 Thanks @shadcn! - do not overwrite user defined vars
#6530 d6159023ed0817adf14b4398874b1f5f05a73b02 Thanks @zwarunek! - fix cn import bug in monorepo
#6617 bd8533bd265de7765831d398f4db687483a0e53a Thanks @shadcn! - filter out deprecated from --all
#6733 779517a1d46f567c8e3fa8fcdea4c75c65ad4eb4 Thanks @shadcn! - check for empty css vars
#6967 9eae13639c10f0219872b5fd28f523a4c25f40df Thanks @shadcn! - only show deprecated for new projects
#6590 16d4d38f564c75d4187977275f04d5999ee9e2f4 Thanks @prateekkumarweb! - fix tanstack check
One column per month.