shadcn/ui

Frameworks & LibrariesMIT

Components you copy into your app, distributed through a registry rather than installed as a dependency.

Latest 4.21.0 · by shadcnWritten in TypeScriptWebsiteRSS

Release activity

Release activity — 81 releases across 65 days in the last year. Each cell is one day; darker means more releases that day. Older weeks are hidden at this screen width.
JunJulAugSep
SundayNo releases on May 24, 20262 releases on May 31, 2026No releases on Jun 7, 2026No releases on Jun 14, 2026No releases on Jun 21, 2026No releases on Jun 28, 2026No releases on Jul 5, 2026No releases on Jul 12, 2026No releases on Jul 19, 2026No releases on Jul 26, 2026No releases on Aug 2, 2026No releases on Aug 9, 2026No releases on Aug 16, 2026No releases on Aug 23, 2026No releases on Aug 30, 2026No releases on Sep 6, 2026
MondayNo releases on May 25, 20262 releases on Jun 1, 20261 release on Jun 8, 2026No releases on Jun 15, 2026No releases on Jun 22, 2026No releases on Jun 29, 2026No releases on Jul 6, 2026No releases on Jul 13, 2026No releases on Jul 20, 20261 release on Jul 27, 2026No releases on Aug 3, 2026No releases on Aug 10, 2026No releases on Aug 17, 20261 release on Aug 24, 20261 release on Aug 31, 2026No releases on Sep 7, 2026
Tuesday2 releases on May 26, 2026No releases on Jun 2, 2026No releases on Jun 9, 2026No releases on Jun 16, 2026No releases on Jun 23, 2026No releases on Jun 30, 2026No releases on Jul 7, 20261 release on Jul 14, 2026No releases on Jul 21, 2026No releases on Jul 28, 2026No releases on Aug 4, 20261 release on Aug 11, 2026No releases on Aug 18, 2026No releases on Aug 25, 2026No releases on Sep 1, 2026No releases on Sep 8, 2026
Wednesday1 release on May 27, 2026No releases on Jun 3, 2026No releases on Jun 10, 2026No releases on Jun 17, 2026No releases on Jun 24, 2026No releases on Jul 1, 2026No releases on Jul 8, 2026No releases on Jul 15, 20261 release on Jul 22, 2026No releases on Jul 29, 20261 release on Aug 5, 20261 release on Aug 12, 2026No releases on Aug 19, 2026No releases on Aug 26, 20262 releases on Sep 2, 2026No releases on Sep 9, 2026
ThursdayNo releases on May 28, 2026No releases on Jun 4, 2026No releases on Jun 11, 2026No releases on Jun 18, 2026No releases on Jun 25, 20261 release on Jul 2, 2026No releases on Jul 9, 2026No releases on Jul 16, 20262 releases on Jul 23, 2026No releases on Jul 30, 20261 release on Aug 6, 20261 release on Aug 13, 2026No releases on Aug 20, 2026No releases on Aug 27, 20261 release on Sep 3, 2026
Friday1 release on May 29, 2026No releases on Jun 5, 2026No releases on Jun 12, 2026No releases on Jun 19, 20263 releases on Jun 26, 20261 release on Jul 3, 20261 release on Jul 10, 20262 releases on Jul 17, 2026No releases on Jul 24, 20262 releases on Jul 31, 2026No releases on Aug 7, 2026No releases on Aug 14, 20261 release on Aug 21, 2026No releases on Aug 28, 20261 release on Sep 4, 2026
SaturdayNo releases on May 30, 2026No releases on Jun 6, 2026No releases on Jun 13, 2026No releases on Jun 20, 2026No releases on Jun 27, 2026No releases on Jul 4, 2026No releases on Jul 11, 2026No releases on Jul 18, 20261 release on Jul 25, 2026No releases on Aug 1, 2026No releases on Aug 8, 2026No releases on Aug 15, 2026No releases on Aug 22, 2026No releases on Aug 29, 2026No releases on Sep 5, 2026

81 releases in the last year, busiest day 3

Changelog

4.21.0

Latest
Added 1
  • Install `cn` package and generate `export { cn } from "cn"` for `lib/utils` on init
Changed 2
  • Registry components now import `cn` from the `cn` package
  • Use `twMerge` from `cn` instead of `tailwind-merge` internally

From shadcn/ui

Minor Changes
Patch Changes
View originalPermalink
How 4.21.0 went

September 2026 - cn

Components now import cn from the cn package. One dependency instead of two, and no local helper to maintain.

Changed 1
  • Components now import cn from the cn package instead of maintaining a local helper
View originalPermalink
How September 2026 - cn went

4.20.0

Added 1
  • Add `npx shadcn migrate cn` command to replace `clsx`, `tailwind-merge` and `cnfast` in Tailwind CSS v4 projects

From shadcn/ui

Minor Changes
View originalPermalink
How 4.20.0 went

August 2026 - Private GitHub Registries

Install registry items from private GitHub repositories using the GitHub CLI or a token.

Added 1
  • Support for installing registry items from private GitHub repositories using the GitHub CLI or a token
View originalPermalink
How August 2026 - Private GitHub Registries went

4.19.0

Added 2
  • Add private repository support to GitHub registries via GitHub CLI credentials or GH_TOKEN
  • Add npx shadcn migrate base-color command to switch a project's base color

From shadcn/ui

Minor Changes
View originalPermalink
How 4.19.0 went

4.18.0

Added 1
  • Support adding registries to package.json when components.json is not present
Changed 2
  • Merge registries from package.json and components.json
  • Resolve registries declared in package.json when adding components, and shadcn add, search, view and init now resolve registries from package.json in memory without persisting them to components.json
Fixed 3
  • Skip unreadable directories during file scans instead of failing with EACCES
  • Skip unreadable directories when resolving monorepo targets
  • Fix shadcn for projects with unreadable permission files

From shadcn/ui

Minor Changes
Patch Changes
View originalPermalink
How 4.18.0 went

August 2026 - Human in the Loop

Mock paused tool calls, approvals, and continuations for the AI SDK with @shadcn/helpers.

Added 1
  • Mock paused tool calls, approvals, and continuations for the AI SDK with @shadcn/helpers
View originalPermalink
How August 2026 - Human in the Loop went

4.17.0

Added 1
  • Add SOCKS4/SOCKS5 proxy support to the registry HTTP stack via ALL_PROXY environment variable using the socks:// URL scheme

From shadcn/ui

Minor Changes

  • #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.

View originalPermalink
How 4.17.0 went

August 2026 - Questionnaire

A new component for building multi-step question flows with fixed, freeform, multiple, and skippable answers.

Added 1
  • New component for building multi-step question flows with fixed, freeform, multiple, and skippable answers
View originalPermalink
How August 2026 - Questionnaire went

4.16.1

Changed 1
  • forward search params to registries for server-side dynamic search
Fixed 1
  • fix shadcn build failing with ENOENT when registry item names contain path segments by creating nested output directories before writing

From shadcn/ui

Patch Changes
View originalPermalink
How 4.16.1 went

4.16.0

Added 1
  • Add getRegistriesConfig and registries in package.json support
Changed 1
  • Make addRegistryItems accept explicit registry configuration instead of loading components.json

From shadcn/ui

Minor Changes
View originalPermalink
How 4.16.0 went

4.15.0

Added 1
  • Add a public addRegistryItems API for installing registry items programmatically without invoking the CLI

From shadcn/ui

Minor Changes
View originalPermalink
How 4.15.0 went

July 2026 - Toast

A new Toast component built on Base UI primitives.

View originalPermalink
How July 2026 - Toast went

4.13.1

Added 1
  • Add React Aria support
Security 3
  • Drop custom registry headers on cross-origin redirects to prevent credential leakage
  • Validate file paths for registry items without an explicit target to prevent path traversal
  • Prevent flag injection from registry-supplied dependency strings during install

From shadcn/ui

Patch Changes
View originalPermalink
How 4.13.1 went

July 2026 - React Aria

React Aria is now available as a component base in shadcn/ui.

View originalPermalink
How July 2026 - React Aria went

July 2026 - Introducing @shadcn/helpers

Small, focused helpers for developing apps, starting with AI SDK and TanStack AI.

Added 1
  • Introduce @shadcn/helpers, a package of small, focused helpers for developing apps
View originalPermalink
How July 2026 - Introducing @shadcn/helpers went

July 2026 - Introducing shadcn/typeset

A complete typography system for HTML, from blog posts to streaming chat. One CSS file you own.

Added 1
  • Introduce shadcn/typeset, a complete typography system for HTML supporting blog posts and streaming chat
View originalPermalink
How July 2026 - Introducing shadcn/typeset went

July 2026 - Base UI as the Default

New projects now use Base UI by default. Radix is still fully supported.

View originalPermalink
How July 2026 - Base UI as the Default went

4.11.1

Changed 1
  • Replace node-fetch with native fetch
Fixed 1
  • Preserve existing dependency specifiers in package.json when running shadcn add

From shadcn/ui

Patch Changes
View originalPermalink
How 4.11.1 went

June 2026 - Components for Chat Interfaces

MessageScroller, Message, Bubble, Attachment, and Marker. Components for building chat interfaces.

Added 5
  • MessageScroller component for scrolling through chat messages
  • Message component for displaying individual chat messages
  • Bubble component for message bubbles in chat interfaces
  • Attachment component for handling message attachments
  • Marker component for marking positions in chat conversations
View originalPermalink
How June 2026 - Components for Chat Interfaces went

June 2026 - GitHub Registries

Turn any public GitHub repository into a shadcn registry.

View originalPermalink
How June 2026 - GitHub Registries went

May 2026 - shadcn eject

Inline shadcn/tailwind.css and remove the shadcn dependency.

View originalPermalink
How May 2026 - shadcn eject went

May 2026 - Introducing Rhea

A more compact Luma. Smaller spacing. Denser surfaces. Built for focused product interfaces.

Changed 2
  • Reduce spacing in the Luma design system to create more compact layouts
  • Increase surface density in the design system for more focused product interfaces
View originalPermalink
How May 2026 - Introducing Rhea went

4.8.0

Added 2
  • Add shadcn registry validate command
  • Add include to registry.json
Fixed 1
  • Fix failing version derivation test

From shadcn/ui

Minor Changes
Patch Changes
View originalPermalink
How 4.8.0 went

May 2026 - Registry Include and Validate

Organize and validate source registries.

View originalPermalink
How May 2026 - Registry Include and Validate went

4.7.0

Added 2
  • Support for package imports
  • Allow alias placeholders in target for registry items
Fixed 1
  • Add previous version error suggestion

From shadcn/ui

Minor Changes
Patch Changes
View originalPermalink
How 4.7.0 went

May 2026 - Package Imports and Target Aliases

Configure shadcn/ui with package.json imports and portable registry target aliases.

Added 2
  • Support for configuring shadcn/ui with package.json imports
  • Portable registry target aliases for component configuration
View originalPermalink
How May 2026 - Package Imports and Target Aliases went

4.6.0

Added 2
  • Add shadcn preset commands
  • Add preset info to npx shadcn info
Changed 1
  • Update docs and info URLs
Fixed 1
  • Fix apply in monorepo

From shadcn/ui

Minor Changes
Patch Changes
View originalPermalink
How 4.6.0 went

April 2026 - shadcn preset

Decode, share, open, and resolve preset codes from the shadcn CLI.

View originalPermalink
How April 2026 - shadcn preset went

April 2026 - Pointer Cursor

Add cursor pointer behavior for buttons during project setup.

View originalPermalink
How April 2026 - Pointer Cursor went

April 2026 - Partial Preset Apply

Apply only the theme or fonts from a preset while keeping your existing components.

Added 1
  • Support for partial preset application to apply only theme or fonts from a preset while keeping existing components
View originalPermalink
How April 2026 - Partial Preset Apply went

4.3.1

Changed 1
  • Send Accept: application/vnd.shadcn.v1+json, application/json;q=0.9 and User-Agent: shadcn headers on registry fetches for proper HTTP content negotiation
Fixed 1
  • Ensure init only runs template post-init hooks for newly created projects

From shadcn/ui

Patch Changes
View originalPermalink
How 4.3.1 went

4.0.0

Added 11
  • Add --monorepo flag and monorepo support for vite, start and react-router
  • Add new base colors: mauve, olive, mist and taupe
  • Add --preset flag to init command
  • Add shadcn/skills
  • Add astro template support
  • Add --reinstall flag for init
Changed 4
  • Use multiplicative instead of addition for --radius calc
  • Refactor shadcn info command to output llm-friendly output
  • Refactor ordering of updaters
  • getTailwindCssFile fallback to config.tailwind.css
Fixed 2
  • Fix kbd display in tooltip
  • Warn if in monorepo and cwd not set
Deprecated 4
  • Deprecate --base-color, --src-dir, --no-base-style flags
  • Deprecate create and make it an alias of init
  • Deprecate --css-variables flag from shadcn add
  • Deprecate registry:build and registry:mcp

From shadcn/ui

Major Changes
Patch Changes
View originalPermalink
How 4.0.0 went

3.5.1

Changed 1
  • Update color value detection for cssVars
Fixed 2
  • Do not install base style when adding themes
  • Fix utils import transform when workspace alias does not start with @

From shadcn/ui

Patch Changes
View originalPermalink
How 3.5.1 went
3.4.1

shadcn 3.4.1

Added 1
  • Add support for color as var
Fixed 2
  • Fix support for universal registry items that only have dependencies without files
  • Fix adding registry item with CSS at-property

From shadcn/ui

Patch Changes
View originalPermalink
How 3.4.1 went

3.3.0

Added 1
  • Add getRegistriesIndex
Fixed 2
  • Fix transformCssVars function with prefix
  • Fix async imports not being transformed when installing components

From shadcn/ui

Minor Changes
Patch Changes
View originalPermalink
How 3.3.0 went

3.0.0

Added 4
  • Add view and search commands
  • Copy registry.json on build
  • Add getRegistry
  • Add support for namespaced registries
Changed 6
  • Bump all dependencies
  • Update getRegistry, getRegistryItems and resolveRegistryItems APIs
  • Move schema to shadcn/schema
  • Update signatures for getRegistry, getRegistryItems, resolveRegistryItems and searchRegistries
  • Update registry dependencies resolution algorithm
  • Update file handling for monorepo
Fixed 2
  • Fix --defaults option
  • Fix monorepo init on nix system
Deprecated 1
  • Deprecate fetchRegistry and resolveRegistryTree

From shadcn/ui

Major Changes
Minor Changes
Patch Changes
View originalPermalink
How 3.0.0 went

2.10.0

Added 2
  • Add support for envVars in schema
  • Add support for envVars in registry

From shadcn/ui

Minor Changes
Patch Changes
View originalPermalink
How 2.10.0 went

2.9.0

Added 1
  • Add universal registry items support
Fixed 2
  • Fix safe target handling
  • Implement registry path validation

From shadcn/ui

Minor Changes
Patch Changes
View originalPermalink
How 2.9.0 went

2.8.0

Added 2
  • Add support for local registry item
  • Add support for vinxi based framework
Changed 1
  • Refactor registry dependencies resolution

From shadcn/ui

Minor Changes
View originalPermalink
How 2.8.0 went

2.7.0

Added 2
  • add support for expo
  • add support for @plugin in css
Fixed 1
  • fix typo in function name unnsetSpreadElements

From shadcn/ui

Minor Changes
Patch Changes
View originalPermalink
How 2.7.0 went

2.5.0

Added 2
  • Resolve imports from anywhere
  • Start working on deno support
Changed 1
  • Move tw-animate-css to devDependencies

From shadcn/ui

Minor Changes
Patch Changes
View originalPermalink
How 2.5.0 went

2.4.0

Added 11
  • Add support for TanStack Start
  • Add theme vars support
  • Add tailwind version detection
  • Add --base-color flag
  • Add support for tailwind v4
  • Add --no-css-variables flag
Changed 2
  • Default to css vars
  • Default to new-york for v4
Fixed 7
  • Fix handling of sidebar colors
  • Add warning for deprecated components
  • Support for version detection in monorepo
  • Allow silent mode with npm
  • Do not add ring for v3
  • Cache registry calls
  • Do not overwrite user defined vars

From shadcn/ui

Minor Changes
Patch Changes
View originalPermalink
How 2.4.0 went

More in Frameworks & Libraries

View all
React

The library for web and native user interfaces.

Meta
Vue

The progressive JavaScript framework for building user interfaces.

Vue.js
react-native

react-native release notes.

Meta
D3

Bring data to life with SVG, Canvas and HTML.

Observable
Electron

Framework for building cross-platform desktop apps with Chromium and Node.js.

OpenJS Foundation
Three.js

A JavaScript 3D library.

Three.js

Discussion