HeroUiMobile

基于 HeroUI V2 扩展的适用于手机端的组件库，Monorepo 架构（pnpm workspace + Turbo）。 使用 Storybook 管理扩展组件，使用 Shadcn CLI 注册、安装组件示例。

使用 Plop 生成器创建新组件、Hook、工具包，组件名称小写，使用连字符，如 my-component

pnpm create:cmp
pnpm create:hook
pnpm create:pkg

安装依赖、启动开发环境、启动文档站点

pnpm install
pnpm dev
pnpm dev:docs

启动特定组件的开发模式（监听文件变化）

cd packages/components/your-component
pnpm dev

其他开发命令: 类型检查、代码检查、代码修复、运行测试、格式化代码

pnpm typecheck
pnpm lint
pnpm lint:fix
pnpm test
pnpm format:write

构建打包: 完整构建（包含类型定义）、快速构建（不包含类型定义，开发时使用）

pnpm build
pnpm build:fast

构建特定包

# 使用 turbo 过滤
pnpm --filter @heroui-mobile/button build

# 或进入组件目录
cd packages/components/your-component
pnpm build

构建文档

pnpm build:docs

构建注册表

pnpm build:registry

构建 Storybook

pnpm build:sb

发布到 npm: 登录 npm、创建 changeset、提交变更、版本号/CHANGELOG 更新并提交、构建项目、发布到 npm、推送代码（可选推送标签）

npm login

# 1) 创建 changeset（记录本次变更）
pnpm changeset
git add .
git commit -m "feat: 添加新组件"
git push

# 2) 生成版本号与 CHANGELOG（会修改很多 package.json/CHANGELOG）
# 注意：本仓库使用 `@changesets/changelog-github` 生成 changelog，本地执行需要设置 `GITHUB_TOKEN`（Personal Access Token，至少包含 `read:user` 和 `repo:status` 权限），否则会报错并不修改任何文件；
# 另外：`changelog-github` 需要能在 GitHub 上查到对应 commit 信息；建议先把 `.changeset/*.md` 提交并推送到远端，再执行此步骤；
pnpm run version
git add .
git commit -m "chore: release"

# 3) 创建 git tag
VER=$(node -p "require('./packages/core/react/package.json').version")
git tag -a "v$VER" -m "release v$VER" # echo $VER && git show "v$VER" --no-patch

# 4) 推送代码（如你手动创建了 git tag，可用 --follow-tags 一并推送）
git push --follow-tags

# 5) 构建并发布
pnpm build
pnpm run release

手动发布单个包

cd packages/components/your-component
pnpm build
npm publish

相关资源

• HeroUI 文档
• Changesets 文档
• Turbo 文档
• pnpm 文档