组件
init
使用 init 命令来初始化新项目的配置和依赖。
🌐 Use the init command to initialize configuration and dependencies for a new project.
init 命令会安装依赖,添加 cn 工具并为项目配置 CSS 变量。
🌐 The init command installs dependencies, adds the cn util and configures CSS variables for the project.
pnpm dlx shadcn-vue@latest init
选项
🌐 Options
Usage: shadcn-vue init [options] [components...]
initialize your project and install dependencies
Arguments:
components the components to add or a url to the component.
Options:
-t, --template <template> the template to use. (next, next-monorepo)
-b, --base-color <base-color> the base color to use. (neutral, gray, zinc, stone, slate)
-y, --yes skip confirmation prompt. (default: true)
-f, --force force overwrite of existing configuration. (default: false)
-c, --cwd <cwd> the working directory. defaults to the current directory. (default:
"/Users/shadcn/Code/shadcn/ui/packages/shadcn")
-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 commandadd
使用 add 命令将组件和依赖添加到你的项目中。
🌐 Use the add command to add components and dependencies to your project.
pnpm dlx shadcn-vue@latest add [component]
选项
🌐 Options
Usage: shadcn-vue add [options] [components...]
add a component to your project
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 commandbuild
使用 build 命令生成注册表 JSON 文件。
🌐 Use the build command to generate the registry JSON files.
pnpm dlx shadcn-vue@latest build
此命令读取 registry.json 文件并在 public/r 目录中生成注册表 JSON 文件。
🌐 This command reads the registry.json file and generates the registry JSON files in the public/r directory.
选项
🌐 Options
Usage: shadcn-vue 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要自定义输出目录,请使用 --output 选项。
🌐 To customize the output directory, use the --output option.
pnpm dlx shadcn-vue@latest build --output ./public/registry