SuperAPI AI 工具集

dev-workflow

部署与运维

查看项目

更新于 10-15 20:28

技能介绍

用途:本技能用于在本地搭建并运行 kickstart-next-ssr 仓库,执行 npm 脚本,以及理解该项目的 CI 与贡献流程。

适用时机:首次克隆仓库并运行应用;运行构建、开发服务器或 lint;了解 GitHub Actions 对该项目做了什么、没做什么。

前置条件:需要 Node.js 与 npm(版本与所在组织保持一致;据 package.json,本仓库使用 Next.js 16 与 React 19);需要一个 Contentstack stack、delivery/preview token,以及 README.md 中说明的 .env 值。

搭建步骤:克隆仓库,地址为 https://github.com/contentstack/kickstart-next-ssr(见 package.json 的 repository.url);执行 npm install;按 README.md 复制或创建 .env / .env.local 并填入 NEXT_PUBLIC_* 变量,切勿提交密钥;执行 npm run dev 启动带热重载的 App Router 应用。

常用命令:npm run dev 启动 Next.js 开发服务器;npm run build 执行生产构建;npm start 在构建后启动生产服务器;npm run lint 通过 next lint 运行 ESLint。

CI 与自动化:.github/workflows/policy-scan.yml 在 PR 上做安全策略/许可证检查;.github/workflows/sca-scan.yml 做软件成分分析;.github/workflows/issues-jira.yml 做 issue 自动化。注意:本仓库默认没有运行 npm ci、npm run build 或 npm run lint 的工作流,因此修改应用代码后推送前应在本地执行这些命令。

拉取请求:遵循所在组织的分支与评审规则;保持改动范围聚焦;若环境变量或搭建步骤有变化,需更新 README.md。

限制:资料未提供具体 Node/npm 版本号、环境变量清单细节及分支命名规则,需以 README.md 和组织规范为准。