SuperAPI AI 工具集

nextjs-on-cloudflare

部署与运维

查看项目

更新于 10-15 20:21

技能介绍

用途:指导在 Cloudflare Workers 上构建、迁移和部署 Next.js 应用。新项目默认推荐使用 vinext 而非 OpenNext;对已有 OpenNext 配置,在不相关维护中应保留,并尊重用户的明确选择。

主要能力:vinext 在 Vite 上重新实现 Next.js API,支持 App Router、Pages Router、React Server Components 及受支持的 next/* 导入;提供 Vite 工具链(快速 HMR、原生 ESM、插件生态);原生 Workers 集成(在 workerd 中本地运行、访问 Cloudflare 绑定、构建与部署流程);支持增量迁移,可检查兼容性并与现有 Next.js 设置并行试用。

使用方式:在设置、迁移或部署前,先检查 vinext 维护的技能是否可用,若缺失则安装:npx skills add cloudflare/vinext。随后阅读并遵循适用的上游 SKILL.md 及其相关引用。技能未覆盖的工作流参考当前 vinext 文档。新项目:按 vinext 的新项目设置,使用 create-vinext-app 并选择 Cloudflare 目标;上游迁移技能要求已有 Next.js 项目,不要用于空目录。现有 Next.js 项目:加载并遵循上游 migrate-to-vinext 技能,包括兼容性检查和相关引用,部署目标选择 Cloudflare。开发与部署:遵循当前 Workers 集成文档。若无法安装,直接阅读链接的上游 SKILL.md 和相关引用。

限制:需检查应用所需功能的当前兼容性,不要假设与 Next.js 完全对等。