HeroUI CLI


以下是 HeroUI CLI 的 API 参考文档。

安装 CLI 后,运行以下命令显示可用命令:

要获取可用的 CLI 命令列表,请在项目目录中运行以下命令:

这将生成以下帮助输出:

命令

Init

使用官方模板初始化新的 HeroUI 项目。

Init 选项

  • -t --template [字符串] 用于新项目的模板,例如:app、laravel、pages、remix、vite
  • -p --package [字符串] 用于新项目的包管理器(默认:npm
示例

输出:

Add

  1. 向项目添加 HeroUI 组件。
  2. 向项目添加 HeroUI Chat 代码库。

功能特性

  1. 自动向项目添加缺失的必要 依赖项
  2. 自动向项目添加必要的 tailwindcss.config.js 配置
  3. 检测是否使用 pnpm,如果是则向 .npmrc 文件添加必要配置
  4. 向项目添加 HeroUI Chat 代码库

Add 选项

  • -a --all [布尔值] 添加所有组件(默认:false
  • -p --packagePath [字符串] package.json 文件的路径
  • -tw --tailwindPath [字符串] tailwind.config 配置文件的路径
  • -app --appPath [字符串] App.tsx 文件的路径
  • --prettier [布尔值] 在添加内容时使用 prettier 格式化(需要已安装 prettier)-(默认:false
  • --addApp [布尔值] 添加 App.tsx 文件内容(需要 provider)-(默认:false
  • -b --beta [布尔值] 添加 Beta 版组件(默认:false
  • -d --directory [字符串] 将 HeroUI Chat 代码库添加到指定目录
示例

不指定具体组件时,add 命令将显示可用组件列表。

输出:

如果要添加特定组件,可以指定组件名称。

输出:

Upgrade

将 HeroUI 组件升级到最新版本。

Upgrade 选项

  • -p --packagePath [字符串] package.json 文件的路径
  • -a --all [布尔值] 升级所有 HeroUI 组件(默认:false
  • -w --write [布尔值] 将升级版本写入 package.json 文件(默认:false
  • -b --beta [布尔值] 升级 Beta 版组件(默认:false
  • -h --help 显示命令帮助信息
示例

Button 组件升级到最新版本。

输出:

Remove

从项目中移除 HeroUI 组件。

注意: 如果移除后没有 HeroUI 组件,相关必要内容也会被移除

Remove 选项

  • -p --packagePath [字符串] package.json 文件的路径
  • -a --all [布尔值] 移除所有 HeroUI 组件(默认:false
  • -tw --tailwindPath [字符串] tailwind.config 配置文件的路径
  • --prettier [布尔值] 在添加内容时使用 prettier 格式化(需要已安装 prettier)-(默认:false
示例

从项目中移除 Button 组件。

输出:

List

列出所有当前已安装的组件。

List 选项

  • -p --packagePath [字符串] package.json 文件的路径
  • -r --remote 列出所有远程可用的组件
示例

输出:

Doctor

使用 doctor 命令检查项目中存在的问题。

功能特性

  1. 检查项目中是否存在 冗余依赖
  2. 检查 HeroUI 组件 所需依赖是否已安装
  3. 检查必要的 tailwind.config.js 文件及其内容是否正确
  4. 使用 pnpm 时检查 .npmrc 是否正确
  5. 检查 所需版本的同级依赖 是否已安装在项目中

Doctor 选项

  • -p --packagePath [字符串] package.json 文件的路径
  • -tw --tailwindPath [字符串] tailwind.config 配置文件的路径
  • -app --appPath [字符串] App.tsx 文件的路径
  • -ca --checkApp [布尔值] 启用 App 检查(默认:true
  • -ct --checkTailwind [布尔值] 启用 tailwind.config 文件检查(默认:true
  • -cp --checkPnpm [布尔值] 启用 Pnpm 检查(默认:true

示例

输出:

如果项目中存在问题,doctor 命令将显示问题信息。

如果没有问题,doctor 命令将显示以下信息。

Env

显示关于本地环境的调试信息。

Env 选项

  • -p --packagePath [字符串] package.json 文件的路径

示例

使用 env 命令显示本地环境信息。

输出: