n naroDocs

Next.js

naro adapts the Next.js build to run on Cloudflare Workers. Next.js 16 and newer try vinext first and fall back to @opennextjs/cloudflare when it does not work out; everything else goes straight to @opennextjs/cloudflare. Server components, route handlers and middleware all run at the edge.

Detected by
next
Build command
npm run build
Output directory
.open-next
Runtime
Server (Cloudflare Worker)
SPA fallback
No
Build cache
.next/cache

Supported versions

Next.js 15 and newer. Next.js 14 and below are rejected before the build starts.

Versions between 15.0 and 15.5.20 build, but the log carries a warning: they sit outside the range the Cloudflare adapter declares support for.

Build cache

.next/cache is carried between deploys of the same branch, so an unchanged page does not rebuild.

Deploy it

Run this inside the project. The first deploy creates and links it.

npx naro-cli deploy
npx naro-cli deploy --prod

Overrides

Project settings → Build configuration changes the build script and output directory for a project that does not follow its framework's defaults.