This build plugin is a utility for supporting Next.js on Netlify. To enable server-side rendering and other framework-specific features in your Next.js application on Netlify, you will need to install this plugin for your app.
As of v3.0.0, all new sites deployed to Netlify with Next.js will automatically install this plugin for a seamless experience deploying Next.js on Netlify!
This means that you don't have to do anything — just build and deploy your site to Netlify as usual and we'll handle the rest.
You're able to remove the plugin at any time by visiting the Plugins tab for your site in the Netlify UI.
If your Next.js project was already deployed to Netlify pre-3.0.0, use the Netlify UI to install the Essential Next.js Build Plugin in a few clicks.
1. Create a netlify.toml in the root of your project. Your file should include the plugins section below:
[build]
command = "npm run build"
publish = "out"
[[plugins]]
package = "@netlify/plugin-nextjs"Note: the plugin does not run for statically exported Next.js sites (aka sites that use next export). To use the plugin, you should use the [build] config in the .toml snippet above. Be sure to exclude next export from your build script.
You can also add context-specific properties and environment variables to your netlify.toml. Read more about deploy contexts in our docs. For example:
[context.production.environment]
NEXT_SERVERLESS = "true"
NODE_ENV = "production"2. From your project's base directory, use npm, yarn, or any other Node.js package manager to add this plugin to devDependencies in package.json.
npm install --save @netlify/plugin-nextjs
or
yarn add @netlify/plugin-nextjs
Read more about file-based plugin installation in our docs.
- CLI Usage
- Custom Netlify Functions
- Image Handling
- Monorepos and Nx
- Custom Netlify Redirects
- Local Files in Runtime
- FAQ
- Caveats
This package extends the project next-on-netlify, authored originally by Finn Woelm.