Never miss a release that matters
AI-powered summaries of every GitHub release.
AI Summaries
Changelogs condensed into clear, actionable insights.
Always Free
Track up to 5 packages at no cost, forever.
Weekly Digest
A curated summary of every release, delivered weekly.
TL;DR
Turbopack continues to receive significant improvements, notably in its analyzer for more accurate code analysis and faster build times, alongside ongoing fixes for edge cases and enhanced tooling support.
New
- Instant Navigation Improvements: The instant navigation overlay has been redesigned with separate tabs for Errors and Insights, improving debugging.
- Image Optimization: An experimental
imgOptOperationCacheflag has been added for image optimization, potentially improving performance. - Docker Deployment Guide: Documentation for deploying with the new Next.js Docker official guide has been updated.
Fixes Worth Knowing
- Fixes address issues with
import.meta.urlon Windows when using Turbopack. - Resolved a bug causing incorrect search parameters to be stored in the cache.
- Improved handling of short-circuit evaluation in the Turbopack analyzer for more accurate builds.
- Fixed an issue where the debug channel wasn’t closing correctly.
Before You Upgrade
If you are using Turbopack, be aware that the analyzer has undergone substantial changes. While generally improving performance, it’s good practice to review your build output after upgrading to ensure expected behavior.
TL;DR
Next.js now correctly handles FormData submissions and resolves issues with caching, rewrites, and server actions, improving application stability.
Fixes Worth Knowing
- Resolved an issue where
FormDataentries were being dropped during submission. - Fixed hydration failures when serving pages from an HTTP cache.
- Corrected a bug causing query corruption with
basePathandrewrites. - Server actions with middleware rewrites no longer cause forwarding loops.
- Non-ASCII characters are now properly encoded in cache tags.
Before You Upgrade
Ensure your project uses the latest playwright-core version to avoid potential issues with request failures.
TL;DR
This release addresses multiple critical security vulnerabilities in Next.js, impacting Server Components, middleware, and caching, requiring immediate attention.
Breaking
- Server Component Security: Several fixes address denial of service and cache poisoning vulnerabilities in Server Components (code that runs on the server).
- Middleware Bypass: Multiple vulnerabilities were resolved preventing attackers from bypassing middleware and proxy protections (security layers).
- WebSocket Security: A server-side request forgery vulnerability in WebSocket upgrades has been patched.
Fixes Worth Knowing
- XSS Prevention: Cross-site scripting (XSS) vulnerabilities were addressed in App Router applications using CSP nonces and
beforeInteractivescripts. - Image Optimization: A denial of service vulnerability in the Image Optimization API has been fixed.
Before You Upgrade
Update to this version as soon as possible to mitigate the identified security risks. No specific migration steps are required beyond a standard Next.js upgrade.
TL;DR
Next.js has been patched to address critical security vulnerabilities (CVE-2025-59471, CVE-2025-59472, CVE-2026-23864) that could allow for denial of service.
Before You Upgrade
Update to this canary release as soon as possible to mitigate the identified security risks.
TL;DR
Next.js has been updated with critical security patches; immediate upgrades are recommended to protect your applications.
Fixes Worth Knowing
Security vulnerabilities have been addressed, protecting against potential exploits.
Before You Upgrade
Review the Next.js Security Update (https://nextjs.org/blog/security-update-2025-12-11) for details on the patched vulnerabilities and their potential impact.
TL;DR
Next.js now includes a critical security patch (CVE-2025-29927) and improved handling of subrequests, ensuring consistent behavior between Edge and Node.js environments.
Fixes Worth Knowing
- Subrequest handling is now consistent across Edge and Node.js deployments (server-side rendering).
- Security vulnerability (CVE-2025-29927) addressed, improving application security.
Before You Upgrade
Update to this version to apply the critical security patch.
TL;DR
Next.js now includes a critical security patch (CVE-2025-29927) and improved handling of middleware subrequests, ensuring more reliable behavior across Edge and Node.js environments.
Fixes Worth Knowing
- Resolved an issue with middleware subrequests, improving reliability when using middleware (request handling in Next.js).
- Improved subrequest handling consistency between Edge and Node.js environments.
TL;DR
Next.js now disables automatic fetch caching by default, requiring explicit opt-in for improved control and predictability, alongside continued improvements to the experimental app router (PPR).
Breaking
- Disable Automatic Fetch Caching: Automatic caching of
fetchrequests is now disabled. You must now explicitly opt-in to caching using thecacheproperty in yourfetchoptions. (Data fetching)
New
- Turbopack Client Entry: A dedicated client entry point has been added for Turbopack builds, potentially improving performance. (Build tool)
- Experimental PPR Improvements: The experimental app router (PPR - Parallel Routes & Rendering) has seen numerous fixes and is now more stable, with the canary requirement removed. (App Router)
Fixes Worth Knowing
- Fixed issues with prefetch data routes not always being added when using PPR.
- Resolved a crash in dev mode for edge runtime pages using
unstable_after. - Corrected issues with metadata routes skipping static optimization.
- Improved handling of
typeof windowin Turbopack builds.
Before You Upgrade
- Review your
fetchcalls and explicitly manage
TL;DR
Next.js now supports Server Actions in both React Server Components (RSC) and Client Components with Turbopack, significantly expanding their usability and improving performance.
Breaking
- The
domainsprop innext/imageis deprecated; useremotePatternsinstead. next exporthas been removed in favor of theoutput: exportsetting innext.config.js.
New
- Server Actions: Now work seamlessly with both RSC and Client Components, and are improved for the Edge runtime.
- Partial Prerendering (PPR): Introduced for faster initial page loads.
- Turbopack Improvements: Enhanced error handling, support for parallel routes, and improved invalidations.
Fixes Worth Knowing
- Resolved issues with middleware and CSS file handling.
- Fixed problems with dynamic route determination and server action errors.
- Addressed several issues related to Turbopack stability and functionality, including invalidations and HMR.
- Improved error messages and logging for better debugging.
Before You Upgrade
- Migrate from the
domainsprop toremotePatternsin `next
TL;DR
Next.js gains a new, more flexible App Router (formerly experimental) with significant performance improvements and a new data fetching model, but introduces breaking changes around configuration and React version support.
Breaking
- React 17 is no longer supported. Upgrade to React 18 or later.
browsersListForSwcis removed, defaulting tolegacyBrowsers: false. Update your build configuration accordingly.target: serverlessis removed. Use a different deployment target.- New
next/linkbehavior enabled. This changes how<Link>components function; review your usage.
New
- App Router: A new, more performant way to build applications with server components, streaming, and improved data fetching.
- Edge Runtime Updates: Support for
AsyncLocalStorageand upgraded to version 1.1.0. next/imageImprovements: Enhanced SVG placeholder support and configuration options, includingimages.loaderFile.
Fixes Worth Knowing
- Middleware now supports larger request bodies (over 16KiB).
- Improved error messages for common
TL;DR
Next.js now includes improved stability and performance updates as part of a patch release addressing issues identified after v12.0.5.
Fixes Worth Knowing
- Fixed an issue causing crashes when using
next/image(image optimization component) with certain image formats. - Resolved a bug where static exports would fail when using custom server configurations.
TL;DR
Next.js now uses SWC (Speedy Web Compiler - a Rust-based platform for fast JavaScript/TypeScript compilation) by default when a custom Babel configuration isn’t present, significantly improving build performance.
Breaking
- The
targetconfiguration option is deprecated. - Middleware now uses SWC, potentially requiring adjustments if you have existing custom tooling relying on the previous implementation.
New
- Middleware: A new, flexible way to modify requests before they reach your routes.
- Output File Tracing: Provides detailed insights into the files generated during the build process, aiding in debugging and optimization.
- URL Imports: Experimental support for importing URLs directly into your code.
Fixes Worth Knowing
- Improved error messages for common configuration issues (e.g., missing
images.pathwhenimages.loaderis defined). - Fixed issues with image optimization, including priority props and styling.
- Resolved problems with middleware functionality on Windows and with minification.
Before You Upgrade
- If you are using a custom Babel configuration, be aware that SWC will not be used automatically.
- Review your middleware implementation for
TL;DR
Next.js now supports an optimized image loading strategy with a placeholder=blur option for improved perceived performance, and has significantly enhanced ESLint integration.
Breaking
- Deprecated features have been removed, potentially requiring code updates if you were using them.
- React version checks and warnings are no longer present.
New
- Optimized Image Loading: A new loading strategy and
placeholder=bluroption improve image loading performance. - Enhanced ESLint Integration: Improved ESLint support, including updates and bug fixes, and a migration guide for existing configurations.
- Create React App (CRA) Transform: An experimental codemod transforms CRA projects to Next.js.
Fixes Worth Knowing
- Fixed a Firefox image decoding error.
- Resolved issues with image placeholder delays and static image headers.
- Corrected scroll behavior with shallow routing.
- Fixed issues with environment variable destructuring in examples.
- Resolved peer dependency and TypeScript issues in examples.
Before You Upgrade
- If you were using deprecated features, review the changes and update your code accordingly.
- Ensure you are using a supported TypeScript version to avoid warnings.
TL;DR
Next.js now includes built-in ESLint with a default rule-set, improving code quality and developer experience.
Breaking
- Font Optimization: Changes to font loading may require opting out of the new optimizations if you experience issues with existing font setups.
New
- ESLint Integration: A default ESLint configuration is now included, helping to catch potential errors and enforce code style.
- Image Component: Added an experimental blurry placeholder for improved perceived loading speed.
- TypeScript Support: Improved type checking with caching for faster incremental builds and better event logging.
Fixes Worth Knowing
- Image Component: Resolved compatibility issues with the
sizesprop. - Rewrites: Fixed several regressions related to rewrites, improving reliability.
- Router: Corrected
asPathusage in the router for accurate path information. - Custom Servers: Fixed an issue preventing correct compression for custom server renders.
Before You Upgrade
- Review your font loading configuration and opt-out of the new font optimizations if necessary.
- Consider reviewing and addressing any new ESLint warnings or errors after upgrading.
TL;DR
The next/image component received significant updates, including default lazy-loading, support for width/height props, quality control, and improved handling of various image types and CDNs (like Akamai).
Breaking
unstable_redirectandunstable_notFoundhave been renamed toredirectandnotFoundrespectively.unstable_blockingis now simplyblocking.- The
iconSizesconfiguration option for images has been replaced withdeviceSizes.
New
- Internationalized (i18n) routing is now supported, with documentation and examples added.
getServerSidePropsandgetStaticPropscan now returnnotFound: trueto render a 404 page.
Fixes Worth Knowing
- Fixed a browser back issue with redirects from
getServerSideProps/getStaticProps. - Resolved a flashing issue with images using
next/image. - Corrected 404 rendering with Static Site Generation (SSG).
- Improved handling of trailing slashes for the default image loader.
Before You Upgrade
- If you were using the unstable redirect or notFound functions,
TL;DR
Next.js now includes a critical security fix for an open redirect vulnerability, and upgrading is highly recommended to protect against potential phishing attacks.
Breaking
- Open Redirect Vulnerability: A security flaw allowing redirects to external sites via specially encoded paths has been patched. Deployments on Vercel and using
next exportare not affected, but all other users should upgrade.
New
- GS(S)P Data Reloading: Editing GetStaticProps or GetServerSideProps methods now triggers automatic reloading during development for faster iteration.
- CSS Module Value Imports: Support for importing CSS Module values directly into JavaScript has been added.
Fixes Worth Knowing
- Href Resolution: Several fixes improve the accuracy of
hrefresolution, especially when using dynamic routes, rewrites, and trailing slashes. - Build Output: The
next exportcommand now displays build progress in segments for better visibility. - Documentation Improvements: Numerous documentation updates clarify concepts and address reported issues, including dynamic routing, asset prefixes, and Gatsby migration.
Before You Upgrade
- Run
npm install next@latest --saveto update to the latest version.
TL;DR
Next.js now supports serverless builds for API routes, improving performance and scalability for backend functionality (server-side code).
Breaking
next/dynamicmodules are deprecated (code for loading components only when needed).- TypeScript projects no longer default to
strict: true(TypeScript compiler setting).
New
exportTrailingSlashis now stable (controls trailing slashes in URLs).prerenderPageConfig option added (allows specifying pages to prerender at build time).
Fixes Worth Knowing
- API routes now work correctly with serverless deployments (cloud functions).
getInitialPropscan now be a synchronous function (simplifies data fetching).- Styled-jsx (CSS-in-JS library) now renders correctly when used within
node_modules.
Before You Upgrade
- If using
next/dynamic, plan to migrate to a different code-splitting solution.
TL;DR
Next.js now supports AMP (Accelerated Mobile Pages) on a per-page basis, enabling incremental adoption of this performance-focused framework.
New
- AMP Support: Implement AMP pages individually for improved mobile performance.
useRouterHook: Access the Next.js router object for programmatic navigation and page data retrieval.- Flying Shuttle v1: (Experimental caching system) Improves build times by caching modules.
Fixes Worth Knowing
- Fixed an issue where re-rendering occurred on the client after navigating back from external sites.
- Resolved a problem with page resolution, ensuring correct page loading.
- Corrected handling of AMP page reloading for a better user experience.
Before You Upgrade
- If using AMP, review the updated documentation for the new
withAmp(Comp)syntax, as the previous.amp.jsapproach has been removed.
TL;DR
Next.js now uses terser-webpack-plugin (JavaScript compression tool) for improved production bundle sizes.
Fixes Worth Knowing
Production builds are now smaller due to improved JavaScript compression, resulting in faster page load times.
TL;DR
Next.js now supports serverless deployments, enabling easier scaling and cost optimization for web applications.
New
- Serverless Next.js support has been added.
- New examples demonstrate integration with tools like Carlo (cross-platform desktop apps), MobX (state management), Jest & TypeScript (testing), and React Testing Library.
Fixes Worth Knowing
- Corrected examples for custom documents and universal configuration.
- Updated dependencies including React, React DOM, webpack, and styled-jsx.
Before You Upgrade
Ensure your dependencies are compatible with the latest React and webpack versions.
TL;DR
Next.js now fully supports styled-components v4, enabling users to leverage the latest features and improvements in that styling library.
Fixes Worth Knowing
- Updated dependencies to improve compatibility and stability.
TL;DR
Next.js now throws an error if getInitialProps is incorrectly defined as an instance method, preventing a common misconfiguration.
Fixes Worth Knowing
next/linkis now more reliable in asynchronous scenarios.- Webpack 4 compatibility is improved with a fix for
emit-file-loader. - WASM (WebAssembly) files now load correctly during server-side rendering.
TL;DR
Next.js saw significant performance improvements, with page resolution now 102x faster, and introduces configurable environment variables and a new plugin system for greater flexibility.
Breaking
_documentis server-side only: Code relying on client-side execution in_document.jswill need to be adjusted.- Powered By Header disabled by default: The default "Powered by Next.js" header is now disabled.
New
- Environment Configuration: Define environment-specific settings for builds and runtime.
- Plugin System: Extend Next.js functionality with custom plugins.
- Configurable Page Extensions: Customize the file extensions Next.js recognizes as pages.
Fixes Worth Knowing
- Improved error handling and more reliable error page loading.
- Corrected static asset serving and export functionality.
- Fixed issues with hot module replacement (HMR) and overlay display.
- Resolved several bugs related to server-side rendering (SSR) and dynamic imports.
Before You Upgrade
- Review your
_document.jsfile and move any client-side logic to a different component. - If
TL;DR
Next.js now disables the default Hot Module Replacement (HMR) error overlay, improving the development experience by reducing visual clutter.
Fixes Worth Knowing
- Fixed an issue where React and React-DOM weren’t always bundled correctly in development mode.
- Corrected a typo in custom server routing examples.
- Updated example projects to use
npxandyarn createfor easier setup (package managers). - Added a configuration option to disable ETags (web caching).
TL;DR
This release mirrors the changes in Next.js 4.2.3, offering improvements and fixes detailed in that release’s notes (a JavaScript framework for React).
Before You Upgrade
Review the Next.js 4.2.3 release notes at https://github.com/zeit/next.js/releases/tag/4.2.3 to understand all changes and potential impacts before upgrading.
TL;DR
Next.js now correctly handles dynamic import() statements, resolving a critical issue with code splitting and improving application performance.
Fixes Worth Knowing
Dynamic import() statements now work as expected, allowing for more efficient code loading and smaller initial bundle sizes.
Before You Upgrade
If you were working around issues with dynamic imports, verify your implementation after upgrading to ensure it functions correctly.
TL;DR
Upgrade to the latest Next.js to address a critical directory traversal vulnerability (security flaw) that could allow attackers to access sensitive files.
Breaking
- A directory traversal issue under the
/_nextrequest namespace has been fixed, requiring an upgrade to prevent potential sensitive data exposure.
Fixes Worth Knowing
- Filtering logs for
..(excluding quotes) can help assess if sensitive code was exposed prior to upgrading.
Before You Upgrade
- Run
npm install next@latest --saveto update to the patched version.
TL;DR
Next.js now correctly serves static assets and internal URLs, resolving issues with file access and site structure.
Fixes Worth Knowing
Resolved issues with serving files from the /static directory and internal URLs within the /_next directory. This ensures static content (images, CSS, etc.) loads as expected and internal routing functions correctly.
TL;DR
Next.js now correctly initializes even after the DOM (Document Object Model - page structure) is fully loaded, resolving issues with dynamic content.
Fixes Worth Knowing
- Resolved an issue where Next.js would fail to initialize if the DOM finished loading before the framework was ready. This ensures dynamic content and interactive elements render as expected.