n naroドキュメント

Next.js

naro は Next.js のビルド成果物を Cloudflare Workers 上で動く形に変換します。Next.js 16 以上はまず vinext を試し、うまくいかない場合は @opennextjs/cloudflare に戻します。それ以外は最初から @opennextjs/cloudflare です。サーバーコンポーネント・ルートハンドラ・ミドルウェアはすべてエッジで動きます。

検出条件
next
ビルドコマンド
npm run build
出力ディレクトリ
.open-next
ランタイム
サーバー (Cloudflare Worker)
SPA フォールバック
なし
ビルドキャッシュ
.next/cache

対応バージョン

Next.js 15 以上。14 以下はビルド前に拒否します。

15.0〜15.5.20 はビルドできますが、ログに警告が出ます。Cloudflare アダプタが明示する対応範囲の外だからです。

ビルドキャッシュ

同じブランチのデプロイ間で .next/cache を引き継ぎます。変更のないページは再ビルドされません。

デプロイする

プロジェクトのディレクトリで実行します。最初のデプロイが作成と紐付けまで行います。

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

既定値を変える

フレームワークの既定に従わないプロジェクトは、プロジェクト設定 → ビルド設定でビルドスクリプトと出力ディレクトリを変更できます。