nextjs-on-cloudflare

Build, migrate, and deploy Next.js applications on Cloudflare Workers using vinext.

Updated Sep 1, 2026
One-click install
npx skills add https://github.com/jpmoya/claude-agents --skill nextjs-on-cloudflare-jpmoya
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: nextjs-on-cloudflare
Source: https://github.com/jpmoya/claude-agents/tree/main/skills/nextjs-on-cloudflare
Command: npx skills add https://github.com/jpmoya/claude-agents --skill nextjs-on-cloudflare-jpmoya

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Choosing and configuring the right toolchain to run Next.js applications on Cloudflare Workers is confusing, with competing options like vinext and OpenNext and incomplete feature parity to navigate. ## Core Features & Use Cases - Toolchain Guidance: Defaults to vinext for new Next.js projects on Cloudflare Workers while preserving existing OpenNext setups during unrelated maintenance. - Upstream Skill Delegation: Installs and follows vinext's official skills via npx skills add cloudflare/vinext for setup, migration, and deployment workflows. - Migration Support: Guides moving an existing Next.js app to Workers using the upstream migrate-to-vinext skill, including its compatibility check. - Use Case: You have an existing Next.js app and want to deploy it on Cloudflare Workers. This Skill checks for the upstream vinext skills, installs them if missing, and walks you through the migration with Cloudflare as the deployment target. ## Quick Start Ask the assistant to migrate your existing Next.js project to Cloudflare Workers using vinext, or to scaffold a new Next.js project targeting Workers.

Frequently Asked Questions about nextjs-on-cloudflare

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I deploy a Next.js app on Cloudflare Workers?

Use vinext, which reimplements the Next.js API surface on Vite with native Workers integration. Install the upstream skills with npx skills add cloudflare/vinext, then follow the Workers integration docs for build and deployment.

vinext vs OpenNext for Cloudflare Workers?

vinext is the default for new Next.js projects on Cloudflare Workers, offering Vite tooling, fast HMR, and native workerd execution. Existing OpenNext setups should be preserved during unrelated maintenance, and explicit user choices are respected.

How do I migrate an existing Next.js app to Cloudflare Workers?

Install the upstream vinext skills and follow the migrate-to-vinext skill, including its compatibility check, selecting Cloudflare as the deployment target. Do not apply the migration skill to an empty directory; new projects use create-vinext-app instead.

Does vinext support all Next.js features?

No, vinext does not guarantee complete Next.js parity. It supports App Router, Pages Router, React Server Components, and supported next/* imports, but you should check current compatibility for the specific features your application requires.

What if the vinext skills installation fails?

If npx skills add cloudflare/vinext is unavailable, read the upstream SKILL.md files and references directly from the vinext GitHub repository. The current vinext docs cover workflows the skills do not.