CHANGELOG.md

Changelog

4.3.0 (2022-03-23)

Features

• allow skipping of middleware handling (#1277) (63070da)

Bug Fixes

• deps: update dependency @vercel/node-bridge to v2.2.0 (#1246) (3637fff)

4.2.8 (2022-03-21)

Bug Fixes

• add new /trace to HIDDEN_PATHS (#1259) (84345a8)
• chdir to site root (#1265) (8463bbc)
• deps: update dependency @netlify/ipx to ^0.0.10 (#1237) (16e067d)
• use correct publishDir when building from CLI with cwd option (#1264) (e441c97)

4.2.7 (2022-02-18)

Bug Fixes

• correctly cache when using next export (#1223) (a8030ca)
• deps: update dependency @netlify/functions to ^0.11.1 (#1217) (e17892b)
• deps: update dependency @netlify/functions to v1 (#1219) (af841cd)

4.2.6 (2022-02-14)

Bug Fixes

• prepend basePath to static file URLs (#1213) (8236b38)

4.2.5 (2022-02-07)

Bug Fixes

• remove confusing error log (#1199) (7974849)

4.2.4 (2022-02-03)

Bug Fixes

• correctly disable ISR disk flushing (#1190) (e8067bf)

4.2.3 (2022-02-02)

Bug Fixes

• don't use ODB for routes that match middleware (#1171) (bbcdfbd)

4.2.2 (2022-01-31)

Bug Fixes

• deps: update dependency @netlify/ipx to ^0.0.9 (#1181) (2e55a9e)

4.2.1 (2022-01-24)

Bug Fixes

• deps: update dependency @netlify/functions to ^0.11.0 (#1146) (4da630b)
• deps: update dependency core-js to v3.20.3 (#1155) (043ad36)
• provide hostname and port to server (#1149) (02053fd)

4.2.0 (2022-01-17)

Features

• add request logging (#1127) (010e86c)

4.1.3 (2022-01-13)

Bug Fixes

• handle routes-manifests without staticRoutes defined (#1120) (96f3ccb)

4.1.2 (2022-01-11)

Bug Fixes

• add specific rewrites for all SSR routes (#1105) (6fd7bcc)
• deps: update dependency core-js to v3.20.2 (#1095) (41966ca)

4.1.1 (2021-12-21)

Bug Fixes

• fix bug that caused ISR pages to sometimes serve first built version (#1051) (62660b2)
• force React to use production env (#1056) (eca0bee)

4.1.0 (2021-12-17)

Features

• add support for use with next export (#1012) (76edc53)

Bug Fixes

• prevent infinite loop when / is ISR (#1020) (55b18e6)

4.0.0 (2021-12-14)

This is a full rewrite of the Essential Next.js plugin, with a new architecture that gives greater compatibility and stability.

What's new

• Full support for incremental static regeneration (ISR).
• Full support for Next.js rewrites, redirects and headers.
• Beta support for Next 12 Middleware
• Faster builds and deploys. Instead of generating one function per route, there are just three functions per site and a much smaller list of rewrites.
• Full support for Netlify's new persistent On-Demand Builders. Return fallback: "blocking" from getStaticPaths and your rendering will be deferred until the first page load, then persisted globally.
• A new image server for next/image, built on Nuxt's ipx. This is a high-performance, framework-agnostic image server based on sharp. This implementation uses On-Demand Builders to persist transformed images globally. Improved source image caching reduces time-to-first-byte for new transforms.
• Simplified configuration. You no longer need to set any Netlify-specific configuration options. For example, in a monorepo all you need to do is set publish to point to your .next directory and you can build the site in any way you like.
• Removes requirement for the target to be set to serverless, which is deprecated in Next 12.
• Bundling now uses Next.js's own node-file-trace, giving more predictable results and smaller uploads.

Breaking changes

The publish directory should point to the site's .next directory or distDir if set, rather than out as in previous versions of the plugin.

Migration guide

Change the publish directory to .next:

[build]
publish = ".next"

If you previously set these values, they're no longer needed and can be removed:

• target: "serverless" in your next.config.js
• distDir in your next.config.js
• node_bundler = "esbuild" in netlify.toml
• external_node_modules in netlify.toml

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.

4.0.0-rc.1 (2021-12-07)

Features

• enable TTL for all sites (#916) (152cf03)

Bug Fixes

• bypass preview for static files (#918) (ecb3cc8)
• work around a bug that caused a full response to be sent for images, even if the etag matched
• deps: update dependency @netlify/ipx to ^0.0.8 (#902) (25f375f)

4.0.0-rc.0 (2021-12-06)

Bug Fixes

• copy public directory output instead of input when using Nx (#856) (d959f82)
• correct root redirect when trailingSlash = false (#879) (3c6b10b)

4.0.0-beta.13 (2021-12-02)

Bug Fixes

• correct handling of data route JSON files (#864) (adea889)
• move locale detection to netlify redirects (#861) (964637b)

4.0.0-beta.12 (2021-11-30)

Features

• add experimental support for TTL (#833) (14ca14a)
• add support for Next env vars (#842) (24fd88a)

Miscellaneous Chores

• deps: update dependency @netlify/build to v19 (#840) (d927524)

4.0.0-beta.11 (2021-11-24)

Bug Fixes

• handle missing i18n object (#837) (3b6d293)

4.0.0-beta.10 (2021-11-24)

Bug Fixes

• replace node-fetch with builtin (#834) (6ff3100)
• correct redirect priority and correctly handle ISR pages assets (#826) (6b61643)
• deps: update dependency @netlify/functions to ^0.10.0 (#830) (3256839)
• don't move files to the CDN if they match redirect/rewrite rules (#832) (9e3dd0e)

4.0.0-beta.9 (2021-11-19)

Bug Fixes

• gracefully handle mssing middleware (#821) (4cee35d)

4.0.0-beta.8 (2021-11-19)

Features

• don't move files to CDN if they match middleware (#812) (615c97a)
• move static pages by default (#816) (12ce69e)

4.0.0-beta.7 (2021-11-17)

Features

• add docs on middleware (#795) (3b4a8c4)
• log warning if old functions exist (#801) (01faf58)

Bug Fixes

• deps: update dependency @netlify/functions to ^0.9.0 (#807) (3deec1d)
• ensure path is encoded (#800) (b0f666e)
• use forced catchall for preview mode (#793) (fd7130f)

Miscellaneous Chores

• add docs on rewrites and redirects (#767) (b32a08c)

4.0.0-beta.6 (2021-11-08)

Bug Fixes

• handle static file glob on Windows (#778) (1cc222a)
• use glob to select files to move (#768) (faeb703)

4.0.0-beta.5 (2021-11-03)

Bug Fixes

• add missing middleware runtime file (#762) (83378b4)
• deps: update dependency node-fetch to v2.6.6 (#758) (759915b)
• don't force rewrite in preview mode (#761) (c88a504)

4.0.0-beta.4 (2021-10-27)

Bug Fixes

• correctly resolve zip path (#744) (68b5662)
• deps: update dependency @netlify/functions to ^0.8.0 (#747) (2c87e30)
• exclude electron by default (#746) (887b90a)

4.0.0-beta.3 (2021-10-26)

Features

• support moving static pages out of function bundle (#728) (3da9c77)
• warn if zip is too large, and log the largest files (#730) (9989c0a)

Bug Fixes

• disable serverless targets (#739) (01fa113)
• ensure stale-while-revalidate headers are not sent (#737) (ef2da0d)
• typo in readme (#731) (bfc016f)
• use nft for ipx bundle (#725) (0321f68)
• use platform-agnostic paths, and add test to be sure (#736) (d448b11)

4.0.0-beta.2 (2021-10-19)

Features

• Enable persistent builders by default (#716) (de07dc2)

Bug Fixes

• correctly exclude files (#720) (efba43e)
• pass query string to handler (#719) (ff09cae)

4.0.0-beta.1 (2021-10-15)

Bug Fixes

• pass correct path to odb (#702) (7c5a8ae)

Miscellaneous Chores

• update min build version (#704) (3e1930f)

4.0.0-beta.0 (2021-10-15)

A complete rewrite of the Essential Next plugin. See the README for details and migration instructions