shadcn-registry

What This Skill Covers

This skill enables you to fully set up, build, and manage a custom shadcn/ui component registry — from scaffolding the project and writing components, to building the JSON output and guiding the user through hosting/deployment. When something requires manual action from the user (e.g. deploying to Vercel, pushing to GitHub), you will clearly call it out with a 🙋 USER ACTION REQUIRED block.

Mental Model

A shadcn registry is simply:

1. Source components living in a registry/ folder in your project
2. A registry.json manifest that lists all items and their metadata
3. A build step (npx shadcn build) that reads registry.json and emits one JSON file per item into public/r/[name].json
4. A static file server (Next.js, any static host) that serves those JSON files over HTTP
5. Users install components via: npx shadcn@latest add https://your-domain.com/r/component-name.json

Step 1 — Project Setup

Option A: Start from the official template (recommended for new registries)