diff --git a/apps/v4/content/docs/changelog/2026-03-cli-v4.mdx b/apps/v4/content/docs/changelog/2026-03-cli-v4.mdx index db6553d370..c64ae93e7b 100644 --- a/apps/v4/content/docs/changelog/2026-03-cli-v4.mdx +++ b/apps/v4/content/docs/changelog/2026-03-cli-v4.mdx @@ -6,7 +6,7 @@ date: 2026-03-06 We're releasing version 4 of shadcn/cli. More capable, easier to use. Built for you and your coding agents. Here's everything new. -### shadcn/skills +## shadcn/skills shadcn/skills gives coding agents the context they need to work with your components and registry correctly. It covers both Radix and Base UI primitives, updated APIs, component patterns and registry workflows. The skill also knows how to use the shadcn CLI, when to invoke it and which flags to pass. Agents make fewer mistakes and produce code that actually matches your design system. @@ -20,7 +20,7 @@ You can ask your agent things like: npx skills add shadcn/ui ``` -### Introducing --preset +## Introducing --preset A preset packs your entire design system config into a short code. Colors, theme, icon library, fonts, radius. One string, everything included. @@ -32,7 +32,7 @@ npx shadcn@latest init --preset a1Dg5eFl Use it to scaffold projects from custom config, share with your team or publish in your registry. Drop it in prompts so your agent knows where to start. Use it across Claude, Codex, v0, Replit. Take your preset with you. -### Switching presets +## Switching presets When you're working on a new app, it can take a few tries to find something you like so we've made switching presets really easy. Run init --preset in your app, and the cli will take care of reconfiguring everything including your components. @@ -40,18 +40,18 @@ When you're working on a new app, it can take a few tries to find something you npx shadcn@latest init --preset ad3qkJ7 ``` -### Skills + Presets +## Skills + Presets Your agent knows how to use presets. Scaffold a project, switch design systems, try something new. - "create a new next app using --preset adtk27v" - "let's try --preset adtk27v" -### New shadcn/create +## New shadcn/create To help you build custom presets, we rebuilt [shadcn/create](/create). It now includes a library of UI components you can use to preview your presets. See how your colors, fonts and radius apply to real components before you start building. -### New --dry-run, --diff, and --view flags +## New --dry-run, --diff, and --view flags Inspect what a registry will add to your project before anything gets written. Review the payload yourself or pipe it to your coding agent for a second look. @@ -61,7 +61,7 @@ npx shadcn@latest add button --diff npx shadcn@latest add button --view ``` -### Updating primitives +## Updating primitives You can use the `--diff` flag to check for registry updates. Or ask your agent: "check for updates from @shadcn and merge with my local changes". @@ -69,7 +69,7 @@ You can use the `--diff` flag to check for registry updates. Or ask your agent: npx shadcn@latest add button --diff ``` -### shadcn init --template +## shadcn init --template `shadcn init` now scaffolds full project templates for Next.js, Vite, Laravel, React Router, Astro and TanStack Start. Dark mode included for Next.js and Vite. @@ -91,7 +91,7 @@ Use `--monorepo` to set up a monorepo. npx shadcn@latest init -t next --monorepo ``` -### shadcn init --base +## shadcn init --base Pick your primitives. Use `--base` to start a project with Radix or Base UI. @@ -99,7 +99,7 @@ Pick your primitives. Use `--base` to start a project with Radix or Base UI. npx shadcn@latest init --base radix ``` -### shadcn info +## shadcn info The `info` command now shows the full picture: framework, version, CSS vars, which components are installed, and where to find docs and examples for every component. Great for giving coding agents the context they need to work with your project. @@ -107,7 +107,7 @@ The `info` command now shows the full picture: framework, version, CSS vars, whi npx shadcn@latest info ``` -### shadcn docs +## shadcn docs Get docs, code and examples for any UI component right from the CLI. Gives your coding agent the context to use your primitives correctly. @@ -120,7 +120,7 @@ combobox - api https://base-ui.com/react/components/combobox ``` -### registry:base and registry:font +## registry:base and registry:font Registries can now distribute an entire design system as a single payload using `registry:base`. Components, dependencies, CSS vars, fonts, config. One install, everything set up.