1. 打开文件夹
cd helion可使用解压后的模板目录或你克隆的仓库。
快速开始
安装依赖并在本地运行模板。
2. 安装依赖
bun install因为本模板自带 bun.lock，所以推荐使用 Bun。
3. 启动开发
bun dev服务启动后，打开 http://localhost:3000 即可访问。
包管理器
只选用一个包管理器，并保持 lockfile 干净。
本模板优先支持 Bun。如果切换到 npm、pnpm 或 Yarn，请删除 node_modules，并避免在同一项目中提交多个 lockfile。
Bun
推荐bun install
bun dev
bun run build
bun run lintnpm
可选npm install
npm run dev
npm run build
npm run lintpnpm
可选pnpm install
pnpm dev
pnpm build
pnpm lintYarn
可选yarn install
yarn dev
yarn build
yarn lint项目脚本
package.json 中可用的命令。
dev用 Next.js 启动本地开发服务器。
build生成可发布的生产构建。
start构建成功后启动生产服务器。
lint对项目运行 ESLint 检查。
定制
在哪里修改内容、布局、图片与全局 UI。
页面
所有路由都位于 app 目录下。修改首页请编辑 app/page.tsx，其他页面对应 app/product/page.tsx、app/careers/page.tsx 等。
app/*/page.tsx页头与页脚
导航与页脚是共享组件。链接、文案、CTA 跳转与页脚分区都在这里维护。
app/site-header.tsx, app/site-footer.tsx行业内容
行业卡片与详情页是数据驱动的。标题、描述、指标与路由别名都在这两个文件中维护。
app/industries/industry-data.ts, app/industries/detail-content.ts图片与 Logo
静态资源由 public 目录提供。生产图片尽量使用 WebP，让模板更轻量。
public/全局样式
HeroUI 主题变量、基础颜色与 Tailwind 引入都在全局样式中。
app/globals.css路由
模板内置的所有页面。
升级指南
安全升级 React、Next.js 与模板依赖。
Next.js 16 需要 Node.js 20.9 或更高，以及 TypeScript 5.1 或更高。请小步升级，每次升级后都跑 lint 与 build，发布大版本前务必阅读官方发布说明。
1. 检查当前技术栈
node -v
bun -v
bun outdated2. 升级常规依赖
bun update
bun run lint
bun run build3. 升级 Next.js 与 React
bun add next@latest react@latest react-dom@latest
bun add -d @types/react@latest @types/react-dom@latest
bun run lint
bun run build4. Next.js 大版本升级
bunx @next/codemod@canary upgrade latest
bun run lint
bun run build主要依赖的 npm 等效命令
npm outdated
npm install next@latest react@latest react-dom@latest @heroui/react@latest @heroui/styles@latest
npm install -D @types/react@latest @types/react-dom@latest typescript@latest eslint@latest eslint-config-next@latest tailwindcss@latest @tailwindcss/postcss@latest
npm run lint
npm run build进行大版本升级时，建议使用独立的 git 分支。升级前先提交一次，再运行官方 codemod，修复警告，最后在浏览器中逐一验证每个路由。
部署
把模板交付给买家之前，先完成一次构建。
生产构建是最后的质量关。把模板上架到市场或部署到托管平台之前，请先修掉 lint、类型、图片与路由相关的问题。
bun run lint
bun run build
bun start官方链接