Docs
CLI
CLI
使用命令行(CLI)向您的项目添加组件。
init
使用 ini
命令初始化新项目的配置和依赖。
init
命令会安装依赖项,添加 cn
实用工具,配置 tailwind.config.js
以及项目的 CSS 变量。
pnpm dlx shadcn@latest init
您将被询问几个问题以配置 components.json
:
Which style would you like to use? › New York
Which color would you like to use as base color? › Zinc
Do you want to use CSS variables for colors? › no / yes
选项
使用示例: shadcn init [options] [components...]
初始化您的项目并安装依赖项
Arguments:
components the components to add or a url to the component.
Options:
-y, --yes skip confirmation prompt. (default: true)
-d, --defaults, use default configuration. (default: false)
-f, --force force overwrite of existing configuration. (default: false)
-c, --cwd <cwd> the working directory. defaults to the current directory. (default: "/Users/shadcn/Desktop")
-s, --silent mute output. (default: false)
--src-dir use the src directory when creating a new project. (default: false)
--no-src-dir do not use the src directory when creating a new project.
--css-variables use css variables for theming. (default: true)
--no-css-variables do not use css variables for theming.
-h, --help display help for command
add
使用 add
命令向您的项目添加组件和依赖。
pnpm dlx shadcn@latest add [component]
您将看到一个组件列表供选择:
您希望添加哪些组件? › 空格选择。A 切换全部。
输入以提交
◯ accordion
◯ alert
◯ alert-dialog
◯ aspect-ratio
◯ avatar
◯ badge
◯ button
◯ calendar
◯ card
◯ checkbox
选项
使用示例: shadcn add [options] [components...]
向您的项目添加一个组件
Arguments:
components the components to add or a url to the component.
Options:
-y, --yes skip confirmation prompt. (default: false)
-o, --overwrite overwrite existing files. (default: false)
-c, --cwd <cwd> the working directory. defaults to the current directory. (default: "/Users/shadcn/Desktop")
-a, --all add all available components (default: false)
-p, --path <path> the path to add the component to.
-s, --silent mute output. (default: false)
--src-dir use the src directory when creating a new project. (default: false)
--no-src-dir do not use the src directory when creating a new project.
--css-variables use css variables for theming. (default: true)
--no-css-variables do not use css variables for theming.
-h, --help display help for command
build
Use the build
command to generate the registry JSON files.
pnpm dlx shadcn@latest build
This command reads the registry.json
file and generates the registry JSON files in the public/r
directory.
Options
Usage: shadcn build [options] [registry]
build components for a shadcn registry
Arguments:
registry path to registry.json file (default: "./registry.json")
Options:
-o, --output <path> destination directory for json files (default: "./public/r")
-c, --cwd <cwd> the working directory. defaults to the current directory. (default:
"/Users/shadcn/Code/shadcn/ui/packages/shadcn")
-h, --help display help for command
To customize the output directory, use the --output
option.
pnpm dlx shadcn@latest build --output ./public/registry