Package Exports

@netlify/plugin-nextjs
@netlify/plugin-nextjs/lib/index.js

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (@netlify/plugin-nextjs) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

Next.js on Netlify Build Plugin

Essential Next.js Build Plugin (beta)

⚠️ This is the beta version of the Essential Next.js plugin. For the stable version, refer to Essential Next.js plugin v3 ⚠️

What's new in this version

Version 4 is a complete rewrite of the Essential Next.js plugin. For full details of everything that's new, check out the v4 release notes

Installing the beta

Install the module:

npm install -D @netlify/plugin-nextjs@beta

Change the publish directory to .next and add the plugin to netlify.toml if not already installed:

[build]
publish = ".next"

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

If you previously set a custom distDir in your next.config.js, or set node_bundler or external_node_modules in your netlify.toml these are no longer needed and can be removed.

The serverless and experimental-serverless-trace targets are deprecated in Next 12, and all builds with this plugin will now use the default server target. If you previously set the target in your next.config.js, you should remove it.

If you are using a monorepo you will need to change publish to point to the full path to the built .next directory, which may be in a subdirectory. If you have changed your distDir then it will need to match that.

If you are using Nx, then you will need to point publish to the folder inside dist, e.g. dist/apps/myapp/.next.

If you currently use redirects or rewrites on your site, see the Rewrites and Redirects guide for information on changes to how they are handled in this version.

If you want to use Next 12's beta Middleware feature, this will mostly work as expected but please read the docs on some caveats and workarounds that are currently needed.

Beta feedback

Please share any thoughts, feedback or questions about the beta in our discussion.