Files
agent-skills/skills/shadcn-ui/references/ui-reference.md
Jason Woltje f6bcc86881 feat: Add 5 curated skills for Mosaic Stack
New skills:
- next-best-practices: Next.js 15+ RSC, async patterns, self-hosting (vercel-labs)
- better-auth-best-practices: Official Better-Auth with Drizzle adapter (better-auth)
- verification-before-completion: Evidence-based completion claims (obra/superpowers)
- shadcn-ui: Component patterns with Tailwind v4 adaptation note (developer-kit)
- writing-skills: TDD methodology for skill authoring (obra/superpowers)

README reorganized by category with Mosaic Stack alignment section.
Total: 9 skills (4 existing + 5 new).

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-02-16 16:17:40 -06:00

40 KiB

Add All shadcn/ui Components using CLI

Source: https://ui.shadcn.com/docs/installation/tanstack

This command installs all available shadcn/ui components into your TanStack Start project using the shadcn/ui CLI. It requires a package manager like pnpm, npm, yarn, or bun.

pnpm dlx shadcn@latest add --all

Create TanStack Start Project with shadcn/ui

Source: https://ui.shadcn.com/docs/installation/tanstack

This command initializes a new TanStack Start project and integrates shadcn/ui, including Tailwind CSS. It requires pnpm, npm, yarn, or bun to run.

pnpm create @tanstack/start@latest --tailwind --add-ons shadcn

Custom Block Installation

Source: https://ui.shadcn.com/docs/registry/examples

Specifies a custom block to be installed from the shadcn/ui registry. In this example, it installs the 'login-01' block.

{
 "$schema": "https://u"
}

Example: Multiple Registry Setup in components.json

Source: https://ui.shadcn.com/docs/components-json

Demonstrates a complex components.json configuration with multiple registries, including public, private with authentication, and team-specific resources. This setup allows for flexible installation of components and utilities from diverse sources.

{
 "registries": {
 "@shadcn": "https://ui.shadcn.com/r/{name}.json",
 "@company-ui": {
 "url": "https://registry.company.com/ui/{name}.json",
 "headers": {
 "Authorization": "Bearer ${COMPANY_TOKEN}"
 }
 },
 "@team": {
 "url": "https://team.company.com/{name}.json",
 "params": {
 "team": "frontend",
 "version": "${REGISTRY_VERSION}"
 }
 }
 }
}

Universal Item with Multiple Files (JSON)

Source: https://ui.shadcn.com/docs/registry/examples

An example of a universal registry item that installs multiple files, including dependencies. This is useful for starter templates or comprehensive configurations, with explicit target paths for each file.

{
 "$schema": "https://ui.shadcn.com/schema/registry-item.json",
 "name": "my-custom-start-template",
 "type": "registry:item",
 "dependencies": [
 "better-auth"
 ],
 "files": [
 {
 "path": "/path/to/file-01.json",
 "type": "registry:file",
 "target": "~/file-01.json",
 "content": "..."
 },
 {
 "path": "/path/to/file-02.vue",
 "type": "registry:file",
 "target": "~/pages/file-02.vue",
 "content": "..."
 }
 ]
}

Create Gatsby Project using npm

Source: https://ui.shadcn.com/docs/installation/gatsby

Initializes a new Gatsby project using the npm command. This command is the starting point for setting up a new Gatsby application.

npm init gatsby

Create React Project with Vite (TypeScript)

Source: https://ui.shadcn.com/docs/installation/vite

Command to create a new React project using Vite with the TypeScript template. This is the initial step for setting up the project.

pnpm create vite@latest 
 --template react-ts

Install Component from Private Registry

Source: https://ui.shadcn.com/docs/components-json

Command-line instruction to install a component from a private registry using its alias. This example, @private/button, demonstrates fetching resources from a protected registry defined in components.json.

npx shadcn@latest add @private/button

Install Component from Configured Registry

Source: https://ui.shadcn.com/docs/components-json

Command-line instruction to install a component using a configured registry alias. The @v0/dashboard syntax specifies the registry and the resource name, leveraging the components.json setup.

npx shadcn@latest add @v0/dashboard

Install Tailwind CSS

Source: https://ui.shadcn.com/docs/installation/remix

Commands to install Tailwind CSS and Autoprefixer as development dependencies in a Remix project using pnpm, npm, or yarn.

pnpm add -D tailwindcss@latest autoprefixer@latest

Universal Item for ESLint Configuration (JSON)

Source: https://ui.shadcn.com/docs/registry/examples

This example shows a universal registry item for installing a custom ESLint configuration. It uses an explicit target to place the .eslintrc.json file in the user's home directory, ensuring framework independence.

{
 "$schema": "https://ui.shadcn.com/schema/registry-item.json",
 "name": "my-eslint-config",
 "type": "registry:item",
 "files": [
 {
 "path": "/path/to/your/registry/default/custom-eslint.json",
 "type": "registry:file",
 "target": "~/.eslintrc.json",
 "content": "..."
 }
 ]
}

Install Switch Component (Manual)

Source: https://ui.shadcn.com/docs/components/switch

Manual installation instructions for the Switch component, providing alternative methods using pnpm, npm, or yarn. This approach is useful if the CLI method is not preferred or feasible.

pnpm add switch
npm install switch
yarn add switch

Installing shadcn/ui Spinner Component

Source: https://ui.shadcn.com/docs/components/spinner

Shows how to add the Spinner component to your project using the shadcn-ui CLI. This command-line installation method simplifies dependency management and setup.

pnpm dlx shadcn@latest add spinner

Install Switch Component (CLI)

Source: https://ui.shadcn.com/docs/components/switch

Instructions for installing the Switch component using the shadcn-ui CLI. This is the recommended method for adding components to your project. Ensure you have the shadcn-ui CLI installed and configured.

pnpm dlx shadcn@latest add switch

shadcn/ui Select Component Installation (CLI)

Source: https://ui.shadcn.com/docs/components/select

Instructions for installing the shadcn/ui Select component using the pnpm, npm, or yarn package managers. This command-line interface method simplifies the process of adding the component to your project. Ensure you have the shadcn/ui CLI installed globally.

pnpm dlx shadcn@latest add select
npx shadcn@latest add select
yarn dlx shadcn@latest add select

Installing Components from Namespaced Registries

Source: https://ui.shadcn.com/docs/changelog

Demonstrates how to install components using the shadcn CLI from different registered namespaces. This enables decentralized component distribution and management.

pnpm dlx shadcn add @acme/button @internal/auth-system

Custom Style from Scratch

Source: https://ui.shadcn.com/docs/registry/examples

Creates a custom style from scratch without extending shadcn/ui. It installs specific npm packages and registry items, and defines new CSS variables for theme colors.

{
 "$schema": "https://ui.shadcn.com/schema/registry-item.json",
 "extends": "none",
 "name": "new-style",
 "type": "registry:style",
 "dependencies": [
 "tailwind-merge",
 "clsx"
 ],
 "registryDependencies": [
 "utils",
 "https://example.com/r/button.json",
 "https://example.com/r/input.json",
 "https://example.com/r/label.json",
 "https://example.com/r/select.json"
 ],
 "cssVars": {
 "theme": {
 "font-sans": "Inter, sans-serif"
 },
 "light": {
 "main": "#88aaee",
 "bg": "#dfe5f2",
 "border": "#000",
 "text": "#000",
 "ring": "#000"
 },
 "dark": {
 "main": "#88aaee",
 "bg": "#272933",
 "border": "#000",
 "text": "#e6e6e6",
 "ring": "#fff"
 }
 }
}

Import and Use Button Component in React

Source: https://ui.shadcn.com/docs/installation/vite

Example of importing the 'Button' component from shadcn/ui and using it within a React component. Assumes the Button component has been added via the CLI.

import { Button } from "@/components/ui/button"

function App() {
 return (
 Click me
 )
}

export default App

Add Dependencies to Project (npm, pnpm, yarn, bun)

Source: https://ui.shadcn.com/docs/installation/manual

Installs the required dependencies for shadcn/ui using package managers. Ensure Tailwind CSS is already set up in your project.

pnpm add class-variance-authority clsx tailwind-merge lucide-react tw-animate-css

shadcn/ui Tooltip Installation (CLI)

Source: https://ui.shadcn.com/docs/components/tooltip

This command installs the shadcn/ui Tooltip component using the shadcn CLI. This is the recommended method for adding components to your project, ensuring proper dependency management.

pnpm dlx shadcn@latest add tooltip

Install Multiple Resources from Different Registries

Source: https://ui.shadcn.com/docs/components-json

Command-line instruction to install multiple resources from various configured registries simultaneously. This showcases the flexibility of installing components like @acme/header and @internal/auth-utils in one go.

npx shadcn@latest add @acme/header @internal/auth-utils

shadcn/ui Alert Component Import Example

Source: https://ui.shadcn.com/docs/components/alert

Example of how to import the Alert, AlertDescription, and AlertTitle components from shadcn/ui after installation. This allows you to use them in your React components.

import { Alert, AlertDescription, AlertTitle } from "@/components/ui/alert"

Initialize shadcn/ui Project with CLI

Source: https://ui.shadcn.com/docs/cli

Initializes your project with shadcn/ui, installing necessary dependencies and configuring the project. This command sets up the cn utility and CSS variables.

pnpm dlx shadcn@latest init

shadcn/ui CLI Installation Commands

Source: https://ui.shadcn.com/docs/cli

Shows the commands for installing shadcn/ui dependencies using different package managers (PNPM, NPM, Yarn, Bun).

pnpm dlx shadcn@latest init
npm dlx shadcn@latest init
yarn dlx shadcn@latest init
bun dlx shadcn@latest init

shadcn/ui Empty Component Installation (CLI)

Source: https://ui.shadcn.com/docs/components/empty

Shows how to install the Empty component using the shadcn/ui CLI. This involves running a specific command to add the component to your project.

pnpm dlx shadcn@latest add empty

Add Tailwind CSS and Vite Plugin

Source: https://ui.shadcn.com/docs/installation/vite

Installs Tailwind CSS and its Vite plugin. These are necessary for styling components with Tailwind utility classes.

pnpm add -D tailwindcss postcss autoprefixer
pnpm add -D @tailwindcss/vite

Import and Use 'Button' Component in React

Source: https://ui.shadcn.com/docs/installation/tanstack

Demonstrates how to import and use the 'Button' component from shadcn/ui within a React component in a TanStack Start application. Assumes the 'Button' component has been added via the CLI.

import { Button } from "@/components/ui/button"

function App() {
 return (
 Click me
 )
}

shadcn/ui Alert Component Installation (CLI)

Source: https://ui.shadcn.com/docs/components/alert

Instructions for installing the Alert component using the shadcn/ui CLI. This command adds the necessary dependencies and component files to your project.

pnpm dlx shadcn@latest add alert

Universal Item for Python Rules (JSON)

Source: https://ui.shadcn.com/docs/registry/examples

An example of a universal registry item designed to install custom Python rules for the Cursor editor. It specifies an explicit target path for the rule file, making it framework-agnostic.

{
 "$schema": "https://ui.shadcn.com/schema/registry-item.json",
 "name": "python-rules",
 "type": "registry:item",
 "files": [
 {
 "path": "/path/to/your/registry/default/custom-python.mdc",
 "type": "registry:file",
 "target": "~/.cursor/rules/custom-python.mdc",
 "content": "..."
 }
 ]
}

Calendar Installation (CLI)

Source: https://ui.shadcn.com/docs/components/calendar

Provides commands for installing the Calendar component using different package managers like pnpm, npm, yarn, and bun. This is a prerequisite for using the component in your project.

pnpm dlx shadcn@latest add calendar

Dropdown Menu Basic Usage (JavaScript/React)

Source: https://ui.shadcn.com/docs/components/dropdown-menu

This snippet shows the minimal setup for a dropdown menu component. It requires importing the necessary components from shadcn/ui and defining a trigger and content. This is a foundational example for integrating dropdown menus.

import { DropdownMenu, DropdownMenuContent, DropdownMenuItem, DropdownMenuLabel, DropdownMenuSeparator, DropdownMenuTrigger, } from "@/components/ui/dropdown-menu"

OpenMy Account
 Profile
 ⇧⌘P
 Billing
 B
 Settings
 S
 Keyboard shortcuts
 K
 Team

 Invite users

 New Team...
 +T
 GitHub

 Support

 API

 Log out
 ⇧⌘Q


Install Progress Component using CLI

Source: https://ui.shadcn.com/docs/components/progress

Command to add the Progress component to your project using the shadcn-ui CLI. This is the recommended way to install components.

pnpm dlx shadcn@latest add progress

Separator Component Installation (CLI)

Source: https://ui.shadcn.com/docs/components/separator

Shows the command to install the Separator component using the shadcn-ui CLI. This is the recommended method for adding components.

pnpm dlx shadcn@latest add separator

Add CSS Import with URL Syntax

Source: https://ui.shadcn.com/docs/registry/examples

This example demonstrates importing CSS files using the url() syntax, including importing from external sources like Google Fonts and local files.

{
 "$schema": "https://ui.shadcn.com/schema/registry-item.json",
 "name": "font-import",
 "type": "registry:item",
 "css": {
 "@import url("https://fonts.googleapis.com/css2?family=Inter:wght@400;500;600&display=swap")": {},
 "@import url('./local-styles.css')": {}
 }
}

React Card Component Example (shadcn/ui)

Source: https://ui.shadcn.com/docs/components/card

This code snippet demonstrates how to use the Card component from shadcn/ui in a React application. It includes examples for header, title, description, content, footer, and action elements. Ensure you have the 'card' component installed via the shadcn/ui CLI or manually imported.

import { Button } from "@/components/ui/button"
import { Card, CardAction, CardContent, CardDescription, CardFooter, CardHeader, CardTitle, } from "@/components/ui/card"
import { Input } from "@/components/ui/input"
import { Label } from "@/components/ui/label"

export function CardDemo() {
 return (
 Login to your accountEnter your email below to login to your account

Name

Framework

CancelDeploy
 )
}

Install shadcn/ui Toggle Component

Source: https://ui.shadcn.com/docs/components/toggle

Instructions for installing the shadcn/ui Toggle component using pnpm. This command adds the necessary package and dependencies to your project.

pnpm dlx shadcn@latest add toggle

Create a Simple Component (TypeScript/React)

Source: https://ui.shadcn.com/docs/registry/getting-started

An example of a basic component file, hello-world.tsx, intended to be part of a registry. This component uses a Button from @/components/ui/button. It should be placed within a structured directory like registry/[NAME]/[COMPONENT_NAME]/.

import { Button } from "@/components/ui/button"

export function HelloWorld() {
 return (
 Hello World
 )
}

shadcn/ui Alert Dialog Installation

Source: https://ui.shadcn.com/docs/components/alert-dialog

Instructions for installing the Alert Dialog component using the shadcn-ui CLI. This command adds the necessary component files to your project, allowing you to import and use them.

pnpm dlx shadcn@latest add alert-dialog

Install Remote Component using URL (CLI)

Source: https://ui.shadcn.com/docs/changelog

Installs a remote component by providing its registry URL to the shadcn CLI. This allows for easy integration of components from external sources. It requires the shadcn CLI to be installed.

npx shadcn add https://acme.com/registry/navbar.json

Add Functional CSS Utilities

Source: https://ui.shadcn.com/docs/registry/examples

This example demonstrates functional CSS utilities using a wildcard. The 'tab-*' utility allows for dynamic application of 'tab-size' based on the value provided.

{
 "$schema": "https://ui.shadcn.com/schema/registry-item.json",
 "name": "custom-component",
 "type": "registry:component",
 "css": {
 "@utility tab-*": {
 "tab-size": "var(--tab-size-)"
 }
 }
}

Install shadcn/ui Registry Item via CLI

Source: https://ui.shadcn.com/docs/registry/getting-started

Installs a registry item using the shadcn CLI by providing the URL of the registry item. This command allows developers to easily add components from a remote registry to their project.

pnpm dlx shadcn@latest add http://localhost:3000/r/hello-world.json

shadcn/ui Drawer Component Usage Example

Source: https://ui.shadcn.com/docs/components/drawer

Provides a basic import statement for using the Drawer component and its associated sub-components from shadcn/ui. This snippet is intended for developers who have installed the component and need to integrate it into their React application.

import { Drawer, DrawerClose, DrawerContent, DrawerDescription, DrawerFooter, DrawerHeader, DrawerTitle, DrawerTrigger, } from "@/components/ui/drawer"


Toggle Group Component Documentation

Source: https://ui.shadcn.com/docs/components/toggle-group

This section details the Toggle Group component, its installation, usage, and various examples demonstrating its functionality and appearance.

## Toggle Group Component

### Description
A set of two-state buttons that can be toggled on or off. Provides "single" and "multiple" selection modes.

### Installation
Use the shadcn-ui CLI to add the component to your project:
```bash
pnpm dlx shadcn@latest add toggle-group

Usage

Import the necessary components and use them in your React application.

import { ToggleGroup, ToggleGroupItem } from "@/components/ui/toggle-group";

function MyToggleGroup() {
 return (

 A

 B

 C

 );
}

Examples

Outline

import { Bold, Italic, Underline } from "lucide-react";
import { ToggleGroup, ToggleGroupItem } from "@/components/ui/toggle-group";

export function ToggleGroupOutline() {
 return (

 );
}

Single

import { Bold, Italic, Underline } from "lucide-react";
import { ToggleGroup, ToggleGroupItem } from "@/components/ui/toggle-group";

export function ToggleGroupSingle() {
 return (

 );
}

Small

import { Bold, Italic, Underline } from "lucide-react";
import { ToggleGroup, ToggleGroupItem } from "@/components/ui/toggle-group";

export function ToggleGroupSmall() {
 return (

 );
}

Large

import { Bold, Italic, Underline } from "lucide-react";
import { ToggleGroup, ToggleGroupItem } from "@/components/ui/toggle-group";

export function ToggleGroupLarge() {
 return (

 );
}

Disabled

import { Bold, Italic, Underline } from "lucide-react";
import { ToggleGroup, ToggleGroupItem } from "@/components/ui/toggle-group";

export function ToggleGroupDisabled() {
 return (

 );
}

Spacing

Use spacing={2} to add spacing between toggle group items.

import { BookmarkIcon, HeartIcon, StarIcon } from "lucide-react";
import { ToggleGroup, ToggleGroupItem } from "@/components/ui/toggle-group";

export function ToggleGroupSpacing() {
 return (

 );
}

API Reference

ToggleGroup

The main component that wraps toggle group items.

Prop Type Default
type `"single" "multiple"`
variant `"default" "outline"`
size `"default" "sm"
spacing number 0
className string ''

ToggleGroupItem

Individual toggle items within a toggle group. Remember to add an aria-label to each item for accessibility.

Prop Type Default
value string Required
className string ''

--------------------------------

### Use shadcn/ui Button Component in Remix

Source: https://ui.shadcn.com/docs/installation/remix

Example of importing and using the shadcn/ui Button component within a Remix route component. Demonstrates basic component integration.

```typescript
import { Button } from "~/components/ui/button"

export default function Home() {
 return (
 Click me
 )
}

Override Primitives with a Block

Source: https://ui.shadcn.com/docs/registry/examples

Demonstrates how to define a custom login block that overrides existing primitives like 'button', 'input', and 'label' with remote versions. This allows for customization during installation.

{
 "$schema": "https://ui.shadcn.com/schema/registry-item.json",
 "name": "custom-login",
 "type": "registry:block",
 "registryDependencies": [
 "login-01",
 "https://example.com/r/button.json",
 "https://example.com/r/input.json",
 "https://example.com/r/label.json"
 ]
}

Initialize Project with shadcn CLI

Source: https://ui.shadcn.com/docs/changelog

Initializes a new project with shadcn/ui components. The command automatically detects the project's framework and can even set up a new Next.js application. It is a convenient way to start integrating shadcn/ui.

npx shadcn init
pnpm dlx shadcn init sidebar-01 login-01

shadcn CLI Commands

Source: https://ui.shadcn.com/docs/changelog

Demonstrates the usage of the shadcn CLI for managing UI components. The commands shown are 'init' for project setup and 'add' for incorporating new components, along with an experimental 'diff' command. These are essential for integrating and managing shadcn/ui within a project.

npx shadcn-ui@latest init
npx shadcn-ui@latest add
npx shadcn-ui@latest diff (experimental)

Install shadcn/ui Tabs Component

Source: https://ui.shadcn.com/docs/components/tabs

Instructions for installing the Tabs component using pnpm and the shadcn-ui CLI. This ensures the component is correctly added to your project's dependencies and configuration.

pnpm dlx shadcn@latest add tabs

Install shadcn/ui Badge Component (CLI)

Source: https://ui.shadcn.com/docs/components/badge

Command-line instructions for adding the shadcn/ui Badge component to your project using pnpm. This command fetches and installs the necessary component files.

pnpm dlx shadcn@latest add badge

Define a Login Block

Source: https://ui.shadcn.com/docs/registry/examples

This example shows how to define a 'login-01' block, specifying its type, description, dependencies, and the files it comprises. The 'page.tsx' and 'login-form.tsx' are included as part of the block.

{
 "$schema": "https://ui.shadcn.com/schema/registry-item.json",
 "name": "login-01",
 "type": "registry:block",
 "description": "A simple login form.",
 "registryDependencies": [
 "button",
 "card",
 "input",
 "label"
 ],
 "files": [
 {
 "path": "blocks/login-01/page.tsx",
 "content": "import { LoginForm } ...",
 "type": "registry:page",
 "target": "app/login/page.tsx"
 },
 {
 "path": "blocks/login-01/components/login-form.tsx",
 "content": "...",
 "type": "registry:component"
 }
 ]
}

Menubar Component Installation (pnpm)

Source: https://ui.shadcn.com/docs/components/menubar

Instructions for installing the Menubar component from shadcn/ui using the pnpm package manager. This command-line interface (CLI) command fetches and adds the necessary component files to your project.

pnpm dlx shadcn@latest add menubar

shadcn/ui Card Component - Installation

Source: https://ui.shadcn.com/docs/components/card

Instructions for installing the Card component in your project using the shadcn/ui CLI. This command automates the process of adding the necessary files to your components directory.

pnpm dlx shadcn@latest add card

Custom Theme Example

Source: https://ui.shadcn.com/docs/registry/examples

Defines a custom theme with specific color variables for both light and dark modes. This allows for a unique color palette across the application.

{
 "$schema": "https://ui.shadcn.com/schema/registry-item.json",
 "name": "custom-theme",
 "type": "registry:theme",
 "cssVars": {
 "light": {
 "background": "oklch(1 0 0)",
 "foreground": "oklch(0.141 0.005 285.823)",
 "primary": "oklch(0.546 0.245 262.881)",
 "primary-foreground": "oklch(0.97 0.014 254.604)",
 "ring": "oklch(0.746 0.16 232.661)",
 "sidebar-primary": "oklch(0.546 0.245 262.881)",
 "sidebar-primary-foreground": "oklch(0.97 0.014 254.604)",
 "sidebar-ring": "oklch(0.746 0.16 232.661)"
 },
 "dark": {
 "background": "oklch(1 0 0)",
 "foreground": "oklch(0.141 0.005 285.823)",
 "primary": "oklch(0.707 0.165 254.624)",
 "primary-foreground": "oklch(0.97 0.014 254.604)",
 "ring": "oklch(0.707 0.165 254.624)",
 "sidebar-primary": "oklch(0.707 0.165 254.624)",
 "sidebar-primary-foreground": "oklch(0.97 0.014 254.604)",
 "sidebar-ring": "oklch(0.707 0.165 254.624)"
 }
 }
}

Install Form Component - CLI

Source: https://ui.shadcn.com/docs/components/form

Command to add the Form component to your project using the shadcn-ui CLI. This command installs the necessary dependencies and component files.

pnpm dlx shadcn@latest add form

Navigation Menu Installation (CLI)

Source: https://ui.shadcn.com/docs/components/navigation-menu

Provides instructions for adding the Navigation Menu component to your project using the shadcn/ui CLI with pnpm, npm, or yarn package managers.

pnpm dlx shadcn@latest add navigation-menu

shadcn/ui Popover Installation Commands

Source: https://ui.shadcn.com/docs/components/popover

Provides commands for installing the shadcn/ui Popover component. It includes instructions for pnpm, npm, and yarn package managers, as well as a command to add the Popover component using the shadcn CLI.

pnpm
npm
yarn
bun
pnpm dlx shadcn@latest add popover

Install Calendar Blocks using shadcn-ui CLI

Source: https://ui.shadcn.com/docs/components/calendar

Instructions to install the latest version of the calendar blocks using the shadcn-ui CLI. This command fetches and adds the necessary calendar components to your project.

pnpm dlx shadcn@latest add calendar-02

Initialize Project from Local File using shadcn CLI

Source: https://ui.shadcn.com/docs/changelog

This command initializes a project using a local JSON file as a template. It's useful for zero-setup workflows and testing registry items locally.

npx shadcn init ./template.json

Avatar Component Installation

Source: https://ui.shadcn.com/docs/components/avatar

Provides instructions for installing the Avatar component using the shadcn/ui CLI. This typically involves running a command like 'pnpm dlx shadcn@latest add avatar' after setting up the project.

pnpm dlx shadcn@latest add avatar

shadcn/ui Slider Component Installation

Source: https://ui.shadcn.com/docs/components/slider

Instructions for installing the shadcn/ui Slider component. This includes methods using pnpm, npm, yarn, and bun, as well as a command-line instruction to add the slider dependency using the shadcn CLI.

pnpm dlx shadcn@latest add slider

Install shadcn/ui Button Component

Source: https://ui.shadcn.com/docs/components/button

Instructions for installing the shadcn/ui Button component using package managers like pnpm, npm, or yarn. It also includes the command to add the button component to your project.

pnpm dlx shadcn@latest add button

Install Sidebar Component using PNPM

Source: https://ui.shadcn.com/docs/components/sidebar

Installs the 'sidebar.tsx' component using the pnpm package manager. This is the recommended method for adding the component to your project.

pnpm dlx shadcn@latest add sidebar

Custom Style Extending shadcn/ui

Source: https://ui.shadcn.com/docs/registry/examples

Defines a custom style that extends shadcn/ui, installing specific dependencies and components. It also sets custom CSS variables for fonts and a brand color in both light and dark modes.

{
 "$schema": "https://ui.shadcn.com/schema/registry-item.json",
 "name": "example-style",
 "type": "registry:style",
 "dependencies": [
 "@tabler/icons-react"
 ],
 "registryDependencies": [
 "login-01",
 "calendar",
 "https://example.com/r/editor.json"
 ],
 "cssVars": {
 "theme": {
 "font-sans": "Inter, sans-serif"
 },
 "light": {
 "brand": "20 14.3% 4.1%"
 },
 "dark": {
 "brand": "20 14.3% 4.1%"
 }
 }
}

Install shadcn/ui Table Component (CLI)

Source: https://ui.shadcn.com/docs/components/table

This command installs the Table component and its dependencies into your shadcn/ui project using the pnpm package manager. Ensure you have shadcn/ui CLI set up.

pnpm dlx shadcn@latest add table

Install Textarea Component with shadcn/ui

Source: https://ui.shadcn.com/docs/components/textarea

Instructions for installing the Textarea component using different package managers (pnpm, npm, yarn, bun). This is a prerequisite for using the Textarea component in your project.

pnpm dlx shadcn@latest add textarea

Create Remix Project

Source: https://ui.shadcn.com/docs/installation/remix

Command to create a new Remix project using pnpm, npm, or yarn. Ensures a fresh project structure for integration.

pnpm dlx create-remix@latest my-app

Sheet Component Installation (CLI)

Source: https://ui.shadcn.com/docs/components/sheet

Provides instructions for installing the Sheet component using the shadcn-ui CLI. This command-line approach simplifies the process of adding the component to your project, ensuring all necessary dependencies are handled.

pnpm dlx shadcn@latest add sheet

SidebarHeader Component Example

Source: https://ui.shadcn.com/docs/components/sidebar

Shows how to incorporate the SidebarHeader component to add a sticky header. The example includes a dropdown menu for workspace selection.

import { SidebarHeader } from "@/components/ui/sidebar"

export function AppSidebar() {
 return (





 Acme Inc.
 Acme Corp.


 )
}

shadcn/ui Drawer Component Installation Command

Source: https://ui.shadcn.com/docs/components/drawer

Shows the command-line interface (CLI) command to install the Drawer component into a shadcn/ui project. This command uses pnpm dlx to execute the shadcn@latest add drawer command, ensuring the latest version is added.

pnpm dlx shadcn@latest add drawer


Add CSS Import with Media Queries

Source: https://ui.shadcn.com/docs/registry/examples

This configuration shows how to use CSS imports with media queries, allowing for conditional loading of styles based on print or screen size.

{
 "$schema": "https://ui.shadcn.com/schema/registry-item.json",
 "name": "responsive-import",
 "type": "registry:item",
 "css": {
 "@import "print-styles.css" print": {},
 "@import url("mobile.css") screen and (max-width: 768px)": {}
 }
}

SidebarFooter Component Example

Source: https://ui.shadcn.com/docs/components/sidebar

Demonstrates the use of the SidebarFooter component for adding a sticky footer. This example includes user account and billing links, and a sign-out option.

import { SidebarFooter } from "@/components/ui/sidebar"

export function AppSidebar() {
 return (


CN

shadcnm@example.com

More optionsAccountBillingSettingsSign out
 )
}

shadcn/ui Dialog Component Installation (CLI)

Source: https://ui.shadcn.com/docs/components/dialog

Provides the command to install the Dialog component using the shadcn/ui CLI with pnpm. This command adds the necessary files and dependencies for the Dialog component to your project. It's a prerequisite for using the component in your application.

pnpm dlx shadcn@latest add dialog

shadcn CLI init Command Usage

Source: https://ui.shadcn.com/docs/cli

Illustrates the usage of the shadcn init command, including its arguments for specifying component names, URLs, or local paths, and available options like --template. This command is crucial for setting up the project's components and configuration.

Usage: shadcn init [options] [components...]

initialize your project and install dependencies

Arguments:
 components name, url or local path to component

Options:
 -t, --template

Install shadcn/ui Accordion Component

Source: https://ui.shadcn.com/docs/components/accordion

Provides commands for installing the Accordion component using different package managers (pnpm, yarn, bun). It also shows the command to add the component using the shadcn-ui CLI.

pnpm dlx shadcn@latest add accordion

SidebarMenuAction - DropdownMenu Example

Source: https://ui.shadcn.com/docs/components/sidebar

An example of integrating a DropdownMenu with the SidebarMenuAction component. This allows for contextual actions or sub-options.

[Home](#)
Edit Project
Delete Project

shadcn/ui Checkbox Installation

Source: https://ui.shadcn.com/docs/components/checkbox

Provides instructions for installing the Checkbox component using different package managers (pnpm, npm, yarn, bun). It also includes the command to add the component using the shadcn-ui CLI.

pnpm dlx shadcn@latest add checkbox

Install Hover Card Component using pnpm

Source: https://ui.shadcn.com/docs/components/hover-card

Command to install the Hover Card component and its dependencies into your project using pnpm and the shadcn-ui CLI.

pnpm dlx shadcn@latest add hover-card

Create React Router Project

Source: https://ui.shadcn.com/docs/installation/react-router

This command initializes a new React Router project using pnpm. It's the first step in setting up your application before integrating shadcn/ui.

pnpm dlx create-react-router@latest my-app

Create Astro Project with Tailwind CSS

Source: https://ui.shadcn.com/docs/installation/astro

Command to create a new Astro project with Tailwind CSS, React integration, package installation, and Git initialization.

pnpm dlx create-astro@latest astro-app --template with-tailwindcss --install --add react --git

Express.js Example for Registry Authentication

Source: https://ui.shadcn.com/docs/registry/authentication

Example of an Express.js route handler for registry authentication, checking the Authorization header for a Bearer token.

## Express.js Example

### Description
This Express.js example demonstrates a basic route handler for authenticating requests to your component registry. It checks the `Authorization` header for a Bearer token.

### Method
GET

### Endpoint
`/registry/:name.json`

### Parameters
#### Path Parameters
- **name** (string) - Required - The name of the component to retrieve.

#### Query Parameters
N/A

#### Request Body
N/A

### Request Example
N/A (GET request)

### Response
#### Success Response (200)
- **component** (object) - The requested component data.

#### Error Responses
- **401 Unauthorized**: If the provided token is invalid.
- **404 Not Found**: If the component is not found.

### Code Example
```javascript
app.get("/registry/:name.json", (req, res) => {
 const token = req.headers.authorization?.replace("Bearer ", "")

 if (!isValidToken(token)) {
 return res.status(401).json({ error: "Unauthorized" })
 }

 const component = getComponent(req.params.name)
 if (!component) {
 return res.status(404).json({ error: "Component not found" })
 }

 res.json(component)
})

function isValidToken(token) {
 // Add your token validation logic here.
 // Example: return token === process.env.VALID_TOKEN;
 return true; // Placeholder
}

function getComponent(componentName) {
 // Replace with your actual logic to fetch the component.
 // Example: return { name: componentName, data: "component data" };
 return null; // Placeholder
}

--------------------------------

### shadcn/ui Context Menu Installation (CLI)

Source: https://ui.shadcn.com/docs/components/context-menu

Instructions for adding the shadcn/ui Context Menu component to your project using the command-line interface. This command will automatically download and update the necessary dependencies for the component.

```bash
pnpm dlx shadcn@latest add context-menu

Add Complex CSS Utility

Source: https://ui.shadcn.com/docs/registry/examples

This example defines a more complex CSS utility called 'scrollbar-hidden'. It targets the scrollbar pseudo-elements to hide them.

{
 "$schema": "https://ui.shadcn.com/schema/registry-item.json",
 "name": "custom-component",
 "type": "registry:component",
 "css": {
 "@utility scrollbar-hidden": {
 "scrollbar-hidden": {
 "&::-webkit-scrollbar": {
 "display": "none"
 }
 }
 }
 }
}

shadcn/ui Label Component Installation

Source: https://ui.shadcn.com/docs/components/label

Provides instructions for installing the Label component into a shadcn/ui project using different package managers like pnpm, npm, yarn, and bun. It also shows the command to add the component using the shadcn CLI.

pnpm dlx shadcn@latest add label

Install Aspect Ratio Component using pnpm

Source: https://ui.shadcn.com/docs/components/aspect-ratio

Command to install the Aspect Ratio component using the pnpm package manager. This command adds the component to your project, making it available for use.

pnpm dlx shadcn@latest add aspect-ratio

React ButtonGroup Installation using pnpm

Source: https://ui.shadcn.com/docs/components/button-group

Provides the command to install the 'button-group' component from shadcn/ui using the pnpm package manager. This command downloads and integrates the necessary files into your project.

pnpm dlx shadcn@latest add button-group

Switch Component Usage Example (React)

Source: https://ui.shadcn.com/docs/components/switch

This code snippet demonstrates how to use the Switch component in a React application. It requires the Label and Switch components from '@/components/ui/label' and '@/components/ui/switch' respectively. The example shows a basic implementation with a label and the switch itself.

import { Label } from "@/components/ui/label"
import { Switch } from "@/components/ui/switch"

export function SwitchDemo() {
 return (


Airplane Mode

 )
}