JSPM

@netlify/plugin-nextjs

3.6.3
  • ESM via JSPM
  • ES Module Entrypoint
  • Export Map
  • Keywords
  • License
  • Repository URL
  • TypeScript Types
  • README
  • Created
  • Published
  • Downloads 252865
  • Score
    100M100P100Q174842F
  • License MIT

Run Next.js seamlessly on Netlify

Package Exports

  • @netlify/plugin-nextjs

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

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.

Table of Contents

Installation and Configuration

For new Next.js sites

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.

For existing Next.js sites

UI Installation

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.

Manual installation

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 dependencies 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.

Docs

Credits

This package extends the project next-on-netlify, authored originally by Finn Woelm.