[!WARNING]

⚠️ 🚧 ⚠️

The next-on-pages package is deprecated, if you want to deploy a Next.js application on Cloudflare, please use the OpenNext Cloudflare adapter instead. If you have a Next.js application that already uses next-on-pages the OpenNext getting started guide for existing applications presents instructions on how to migrate to the OpenNext adapter.

⚠️ 🚧 ⚠️

⚡▲ @cloudflare/next-on-pages ▲⚡

Build, develop, and deploy Next.js apps for Cloudflare Pages.

[!NOTE] The best way to run Next.js apps on Cloudflare is to use @opennextjs/cloudflare. If you're coming from Vercel, you can migrate your Next.js app easily using Diverce, which can also help you migrate from @cloudflare/next-on-pages

@cloudflare/next-on-pages is a CLI tool that you can use to build and develop Next.js applications so that they can run on the Cloudflare Pages platform.

Alongside the @cloudflare/next-on-pages there is an additional package eslint-plugin-next-on-pages implementing an Eslint plugin which aim is to aid developers at using the @cloudflare/next-on-pages more efficiently and improve their overall developer experience when working with it.

You can see the packages contents (with their documentation) in their respective package directories:

• @cloudflare/next-on-pages
• eslint-plugin-next-on-pages

Additionally there is also the next-dev submodule which is implemented as a separate package in this repository but included as a submodule of the main @cloudflare/next-on-pages package, you can see the submodule's content here:

• @cloudflare/next-on-pages/next-dev

Contributing

If you want to contribute to this project (both to the main package and the eslint one) please refer to the Contributing document.

References

Extra references you might be interested in:

• Blog post

  The original blog post introducing @cloudflare/next-on-pages (24/10/2022), it goes into details on the inspiration for this package and provides some details on how it works.

• Cloudflare Next.js Guide

  Cloudflare guide on how to create and deploy a Next.js application. The application can be either static (and deployed as simple static assets) or dynamic using the edge runtime (using @cloudflare/next-on-pages).

• Caching and Data Revalidation

  Documentation on how the caching and data revalidation for applications built using @cloudflare/next-on-pages works.

• Technical Documentation

  Explanations and insights into how @cloudflare/next-on-pages works, design decisions behind different aspects, and how it handles different Next.js features.