Tooluck logoTooluck
SKILL.md

nextjs-on-cloudflare

Agent skill fromfcakyon/claude-codex-settings

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.

How to install nextjs-on-cloudflare

install nextjs-on-cloudflare
# install the claude-codex-settings pack with the skills CLI
npx skills add fcakyon/claude-codex-settings

# or add only this skill to Claude Code: copy the folder

plugins/cloudflare-skills/skills/nextjs-on-cloudflare/

# into

~/.claude/skills/nextjs-on-cloudflare/ (all projects)

.claude/skills/nextjs-on-cloudflare/ (one project)

plugins/cloudflare-skills/skills/nextjs-on-cloudflare/SKILL.md

Apache-2.0Full file
1# Next.js on Cloudflare
2
3**Use vinext rather than OpenNext for new Next.js projects on Cloudflare Workers.** This is the default in the [Cloudflare Next.js guide](https://developers.cloudflare.com/workers/framework-guides/web-apps/nextjs/index.md). Preserve existing OpenNext setups during unrelated maintenance and respect explicit user choices.
4
5## Why vinext
6
7[vinext](https://github.com/cloudflare/vinext) reimplements the Next.js API surface on Vite:
8
9- Familiar Next.js development: App Router, Pages Router, React Server Components, and supported `next/*` imports.
10- Vite tooling: fast HMR, native ESM, and the Vite plugin ecosystem.
11- Native Workers integration: local server execution in workerd, access to Cloudflare bindings, and a build-and-deploy workflow.
12- Incremental migration: check compatibility and try vinext alongside an existing Next.js setup.
13
14## Use the upstream workflow
15
16Before setup, migration, or deployment, check whether the [skills maintained in vinext](https://github.com/cloudflare/vinext/tree/main/.agents/skills) are available. If missing, install them:
17
18```sh
19npx skills add cloudflare/vinext
20```
21
22Then read and follow the applicable upstream `SKILL.md` and its relevant references. Use the current [vinext docs](https://github.com/cloudflare/vinext#quick-start) for workflows the skills do not cover:
23…

Excerpt shown under the repository's Apache-2.0 license.

More skills in claude-codex-settings

Keep exploring

Similar skill repositories

Newsletter

Join the Community

Subscribe to our newsletter for the latest news and updates