NextUI 到 HeroUI
HeroUI 是 NextUI 的新身份，保留了您喜爱的强大组件和功能，只是换了个新名字。本指南将帮助您将现有的 NextUI 项目迁移到 HeroUI。
自动迁移（推荐）
迁移 NextUI 项目到 HeroUI 最简便的方法是使用官方 codemod：
运行迁移
在项目目录中执行 codemod：
**注意：**如果您使用 monorepo，请在根目录运行 codemod。
这将自动完成：
- 将所有包名从
@nextui-org/*更新为@heroui/* - 重命名组件导入和引用
- 更新 TailwindCSS 配置
- 转换 provider 组件
- 调整任何 NextUI 特定的工具或钩子
- 仅针对 pnpm 更新
.npmrc文件
安装依赖
运行 codemod 后，安装新依赖：
手动迁移
如果您更愿意手动迁移，请按以下步骤操作：
更新依赖
用 HeroUI 等价包替换 NextUI 包：
更新 TailwindCSS 配置
更新您的 tailwind.config.js：
更新 Provider 组件
将 NextUI provider 替换为 HeroUI 的 provider：
更新导入
将所有组件导入改为新包名：
单独包
如果您使用单独包，请相应更新每个包名：
Npmrc 仅 pnpm
如果您使用 pnpm，需要更新 .npmrc 以使用新包名：
验证
迁移后，请验证以下几点：
- 所有组件正常渲染
- 主题自定义保持不变
- 代码库中不再存在 NextUI 的导入
- 您的应用程序可以无错误构建
所有组件的功能和 API 保持不变——仅包名和导入发生了变化。
故障排除
如果在迁移过程中遇到问题，请尝试以下步骤：
NPM 用户
如果您使用 npm，可能需要：
- 删除
node_modules文件夹 - 删除
package-lock.json文件 - 使用
npm install重新安装所有包
Package.json 检查
确保在 package.json 的 dependencies 或 devDependencies 中没有残留的 @nextui-org 包。
需要帮助？
加入我们的 Discord 社区，位于 #nextui-to-heroui 频道 https://discord.gg/9b6yyZKmH4 — 我们的团队很高兴为您提供帮助！
如果在迁移过程中遇到任何问题，请在我们的 GitHub 仓库中 提出问题。
