SkillsAdd

cloudflare/skills · Official

nextjs-on-cloudflare

Build, migrate, and deploy Next.js apps on Cloudflare Workers with vinext.

All-time #4317 Trending #327 Hot #6586
8-week activity · all time api

Installation

$ npx skills add cloudflare/skills --skill nextjs-on-cloudflare
View on skills.sh ↗ GitHub repository ↗

Summary

  • Build, migrate, and deploy Next.js apps on Cloudflare Workers with vinext.
  • Use when starting a Next.js project on Cloudflare, moving an existing app to Workers, choosing between vinext and OpenNext, or setting up vinext for Workers.
  • For setup, migration, or deployment, install vinext's upstream skills with `npx skills add cloudflare/vinext` if missing, then read and follow the applicable skill and docs.

Similar popular skills

Related neighbors and high-traction skills in the same topics — useful to compare before installing.

vercel-react-best-practices Shared topics
vercel-labs/agent-skills 697.8K installs
prisma-compute Shared topics
prisma/skills

Prisma Compute deployment and hosting guide. Use whenever the user mentions Prisma Compute, `pr…

253.4K installs
cloudflare-deploy Similar name
openai/skills

Deploy applications and infrastructure to Cloudflare using Workers, Pages, and related platform…

3.4K installs
sentry-cloudflare-sdk Similar name
getsentry/sentry-for-ai

Full Sentry SDK setup for Cloudflare Workers and Pages. Use when asked to "add Sentry to Cloudf…

2.4K installs
cloudflare-worker-builder Similar name
jezweb/claude-skills

Scaffold and deploy Cloudflare Workers with Hono routing, Vite plugin, and Static Assets. Descr…

1.4K installs
cloudflare-api Similar name
jezweb/claude-skills

Hit the Cloudflare REST API directly for operations that wrangler and MCP can't handle well. Bu…

952 installs

Also in this package

Other skills from cloudflare/skills · top by installs.

npx skills add cloudflare/skills
cloudflare 82.5K wrangler 79.9K workers-best-practices 73K durable-objects 66.2K web-perf 66.3K agents-sdk 63.9K cloudflare-email-service 59.4K turnstile-spin 51K cloudflare-one 48.7K cloudflare-one-migrations 48K

Browse all from cloudflare/skills

More details

Agent compatibility

Declared targets from SKILL.md / docs. Unmarked agents are not listed — the skill may still install via the CLI.

Claude Code Not declared
Cursor Not declared
Codex Not declared
GitHub Copilot Not declared
Windsurf Not declared
Gemini CLI Not declared
Cline Not declared
OpenCode Not declared

Repository health

Stars 2.8K
License LICENSE
Default branch main
Open issues 8
Status Active

Package contents

Files included with this skill beyond the listing page.

  • skill md SKILL.md 2,703 B
  • docs SUMMARY.md 2,672 B

History

  1. First recorded snapshot · 3,012 installs

SKILL.md

Next.js on Cloudflare

Use vinext rather than OpenNext for new Next.js projects on Cloudflare Workers. This is the default in the Cloudflare Next.js guide. Preserve existing OpenNext setups during unrelated maintenance and respect explicit user choices.

Why vinext

vinext reimplements the Next.js API surface on Vite:

  • Familiar Next.js development: App Router, Pages Router, React Server Components, and supported next/* imports.
  • Vite tooling: fast HMR, native ESM, and the Vite plugin ecosystem.
  • Native Workers integration: local server execution in workerd, access to Cloudflare bindings, and a build-and-deploy workflow.
  • Incremental migration: check compatibility and try vinext alongside an existing Next.js setup.

Use the upstream workflow

Before setup, migration, or deployment, check whether the skills maintained in vinext are available. If missing, install them:

npx skills add cloudflare/vinext

Then read and follow the applicable upstream SKILL.md and its relevant references. Use the current vinext docs for workflows the skills do not cover:

  • New project: follow vinext's new-project setup using create-vinext-app with the Cloudflare target. The upstream migration skill requires an existing Next.js project; do not apply it to an empty directory.
  • Existing Next.js project: load and follow the upstream migrate-to-vinext skill, including its compatibility check and relevant references. Select Cloudflare as the deployment target.
  • Development and deployment: follow the current Workers integration docs.

If installation is unavailable, read the linked upstream SKILL.md and relevant references directly. Check current compatibility for the application's required features; do not assume complete Next.js parity.