关于 nextjs-on-cloudflare
用于在 Cloudflare 上开发和部署 Next.js 项目的技能:新项目采用 vinext,处理无关维护时保留现有 OpenNext 配置,并指引查阅上游技能与兼容性资料。
主要功能
- 01新项目采用 vinext 的指引
- 02现有项目迁移指引
- 03Cloudflare 部署流程参考
- 04兼容性检查
- 05查找和安装上游技能
适用场景
- 01为 Cloudflare Workers 创建 Next.js 项目
- 02评估迁移现有 Next.js 应用
- 03检查所需 Next.js 功能是否受支持
- 04查找当前开发与部署说明
安装
复制下面的命令,在终端中运行。
$
npx skills add https:/ / github.com/ cloudflare/ skills --skill nextjs-on-cloudflare安装后在 Claude Code 中输入/nextjs-on-cloudflare确认已加载。
详细介绍
Cloudflare 上的 Next.js
对于在 Cloudflare Workers 上创建的新 Next.js 项目,请使用 vinext,而不是 OpenNext。 这是 Cloudflare Next.js 指南中的默认选择。对于现有 OpenNext 配置,在无关维护期间应予以保留,并尊重用户的明确选择。
为什么选择 vinext
vinext 基于 Vite 重新实现了 Next.js API 表面:
- 熟悉的 Next.js 开发体验:App Router、Pages Router、React Server Components,以及受支持的
next/*导入。 - Vite 工具链:快速 HMR、原生 ESM,以及 Vite 插件生态系统。
- 原生 Workers 集成:在 workerd 中执行本地服务、访问 Cloudflare 绑定,以及构建和部署工作流。
- 渐进式迁移:检查兼容性,并尝试在现有 Next.js 配置旁使用 vinext。
使用上游工作流
在设置、迁移或部署之前,检查 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 完全兼容。
评论
支持 Markdown