shadcn registry - shadcn/ui

The registry command helps you manage custom registries and add registry items to your registry.

Usage

npx shadcn@latest registry <command> [options]

Subcommands

add

Add an item to your registry:

npx shadcn@latest registry add <name>

Options

string

required

The name of the registry item to add

string

The working directory. Defaults to the current directory.

Examples

Add item to registry

npx shadcn@latest registry add button

Adds the button component to your custom registry.

Add multiple items

npx shadcn@latest registry add button card dialog

What it does

When you run registry add:

Validates item - Checks that the component exists in your project
Generates schema - Creates registry item JSON with metadata
Updates registry - Adds the item to your registry.json
Includes dependencies - Automatically tracks component dependencies

Use cases

The registry command is useful when you’re:

Building a custom registry - Creating your own component library
Sharing components - Distributing components to other projects
Managing internal libraries - Maintaining company-wide design systems

shadcn add - Add components from registries
shadcn build - Build your registry

Learn more

Registry Documentation - Complete guide to registries
Getting Started with Registries - Create your first registry
Registry Schema - Registry item JSON format

⌘I