Repository files navigation

This package handles the build process and creates the runtime environment for Next.js sites onNetlify. You should not normally need to install it yourself, as it is used automatically duringbuilds of Next.js sites. Seethe docs for using Next.js on Netlify formore details.

Next.js is supported natively on Netlify, and in most cases you will not need to install orconfigure anything. This repo includes the packages used to support Next.js on Netlify.

• Next.js 13.5 or later
• Node.js 18 or later
• The latest version of theNetlify CLI

If you build on Netlify, the Next.js Runtime will work with no additional configuration.

The Next.js Runtime installs automatically for new Next.js sites on Netlify. You can also install itmanually in the following ways:

You can go to theUI and choosethe site to install the Next.js Runtime on. This method is recommended because you will benefit fromauto-upgrades to important fixes and feature updates.

npm install -D @netlify/plugin-nextjs

...then add the following to yournetlify.toml file:

[[plugins]]package ="@netlify/plugin-nextjs"

This method is recommended if you wish to pin the Next.js Runtime to a specific version.

If you are using Next.js 10-13.4 or Node.js < 18, you must use v4 of the Next.js Runtime.

If you are still using v4, you can findits README here and thev4 Runtime docs here.

To upgrade from v4 to v5, please visitthe v5 documentation.

If you think you have found a bug in Next.js on Netlify,please open an issue. If you havecomments or feature requests,see the discussion board

Please note that v4 will only receive security fixes and critical bug fixes.