nextjs-on-cloudflare

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

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Deploying Next.js applications to Cloudflare Workers requires choosing between frameworks and following the correct setup or migration path, which is easy to get wrong without guidance. ## Core Features & Use Cases - Framework Selection Guidance: Recommends vinext over OpenNext for new Next.js projects on Cloudflare Workers while preserving existing OpenNext setups. - Migration Workflow: Directs existing Next.js projects through the upstream migrate-to-vinext skill, including compatibility checks and Cloudflare as the deployment target. - New Project Setup: Points to create-vinext-app with the Cloudflare target for starting fresh projects. - Use Case: You have an existing Next.js app and want to move it to Cloudflare Workers. This Skill installs the upstream vinext skills via npx skills add cloudflare/vinext and walks you through the migration and deployment workflow. ## Quick Start Ask the assistant to migrate your existing Next.js application to Cloudflare Workers using vinext and follow the upstream migration skill it installs.

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 to 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 recommended default for new Next.js projects on Cloudflare Workers, offering Vite tooling and native workerd execution. Existing OpenNext setups should be preserved during unrelated maintenance unless the user explicitly chooses to migrate.

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

Install the upstream vinext skills, then follow the migrate-to-vinext skill, which includes a compatibility check. Select Cloudflare as the deployment target and consult the relevant references for your app's features.

Does vinext support all Next.js features?

vinext supports App Router, Pages Router, React Server Components, and supported next/* imports, but full Next.js parity is not guaranteed. Check current compatibility for your application's required features before migrating.

Can I create a new Next.js project directly on Cloudflare Workers?

Yes, use create-vinext-app with the Cloudflare target to scaffold a new project. Do not apply the migration skill to an empty directory, as it requires an existing Next.js project.