# shadcn-ui/ui · RepoSense Release & Migration Intelligence

> Ships `shadcn@shadcn@4.23.0` with upstream runtime refinem. Drop-in upgrade. Migration: None.

## Metadata
- **Repository URL**: https://github.com/shadcn-ui/ui
- **Primary Package**: `shadcn` (NPM)
- **Categories**: `STYLING`, `UI_PRIMITIVES`
- **Latest Version**: `shadcn@4.23.0`
- **Semantic Status**: `COMPATIBLE`
- **Bundle Size Impact (unavailable)**: `Size Unavailable`
- **Atom Ingestion Feed**: https://github.com/shadcn-ui/ui/releases.atom

## The Human Context (Plain-English Pitch)
shadcn/ui is a collection of accessible, ready-to-use UI components that you copy directly into your own codebase rather than installing as a locked npm dependency. It solves the frustration of fighting rigid third-party component library styles by giving you 100% ownership of the underlying Tailwind and Radix UI source code.

## Stage 1 Executive Summary ([Core Change] + [Required Action] + [Migration Effort])
Ships `shadcn@shadcn@4.23.0` with upstream runtime refinem. Drop-in upgrade. Migration: None.

## Breaking Changes & Required Actions
- Ships `shadcn@shadcn@4.23.0` with upstream runtime refinements and stability fixes from `shadcn-ui/ui`.
- Updates TypeScript declarations and internal module exports for `shadcn@4.23.0`.

## Migration Snippet
```ts
npm install shadcn@shadcn@4.23.0
```

## Ecosystem Compatibility Matrix & Graph Warnings
- **TypeScript 5.x** [`COMPATIBLE`]: Ships standard TypeScript declaration files without type regressions.
- **Graph Conflict (tailwindcss ↔ shadcn)**: Tailwind v4 replaces `tailwind.config.js` with CSS-first `@theme` blocks, breaking HSL plugin variables in legacy `shadcn/ui` registries. Run the OKLCH token codemod and upgrade `shadcn` to `v2.4.0`. Migration: Moderate. | Resolution: `npx @tailwindcss/upgrade@latest && npx shadcn@latest add --overwrite`

## Zero-Noise Release Timeline
- **shadcn@4.23.0** (2026-10-27) [COMPATIBLE]: Ships `shadcn@shadcn@4.23.0` with upstream runtime refinem. Drop-in upgrade. Migration: None.

## Upgrade & Migration Q&A (GEO Direct Answers)
### Is shadcn-ui/ui shadcn@4.23.0 safe to upgrade in production?
shadcn-ui/ui shadcn@4.23.0 is classified as COMPATIBLE (MINOR release). Ships `shadcn@shadcn@4.23.0` with upstream runtime refinem. Drop-in upgrade. Migration: None.

### What breaking changes or compatibility risks exist in shadcn-ui/ui shadcn@4.23.0?
tailwindcss with shadcn: Tailwind v4 replaces `tailwind.config.js` with CSS-first `@theme` blocks, breaking HSL plugin variables in legacy `shadcn/ui` registries. Run the OKLCH token codemod and upgrade `shadcn` to `v2.4.0`. Migration: Moderate.

### What is the bundle size impact of shadcn shadcn@4.23.0?
Measured bundle size telemetry is currently unavailable for shadcn shadcn@4.23.0; verify build output locally before deploying.

### How do I upgrade shadcn to shadcn@4.23.0?
Upgrade shadcn to shadcn@4.23.0 by running "npm install shadcn@shadcn@4.23.0" and applying the migration steps: npm install shadcn@shadcn@4.23.0