mcpField
N
nextjs-on-cloudflare

nextjs-on-cloudflare

github.com/cloudflare云与 DevOps3.2k44.9k 次安装今天更新
代码仓库

关于 nextjs-on-cloudflare

用于在 Cloudflare 上开发和部署 Next.js 项目的技能:新项目采用 vinext,处理无关维护时保留现有 OpenNext 配置,并指引查阅上游技能与兼容性资料。

主要功能

  1. 01新项目采用 vinext 的指引
  2. 02现有项目迁移指引
  3. 03Cloudflare 部署流程参考
  4. 04兼容性检查
  5. 05查找和安装上游技能

适用场景

  1. 01为 Cloudflare Workers 创建 Next.js 项目
  2. 02评估迁移现有 Next.js 应用
  3. 03检查所需 Next.js 功能是否受支持
  4. 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