@next/mdx
16.4.6 · 9 Nov 2026MIT2.2M / weekRepositoryHomepagenpmAtom feed
12.3.7 is the newest release of 12.x.
In short
1 breaking1 removed2 deprecated62 new2 faster99 fixed110 changed176 internal
- Breaking
middleware: Forbids middleware response body
- Removed
Drop the unstable web vital hook and remove exports of flush effects
- Deprecated
Deprecate nested Middleware in favor of root middleware
- Deprecated
Edge Functions: Deprecate access to
request.page
Release note
Core Changes
Flush initial styled-jsx in gIP first in concurrent rendering
Add falling back to wasm swc build on native load failure
next-swc: Introduce experimental tracing support for swc
Add initial handling for routing tests
Fix asPath handling for data route revalidation in minimal mode
React root enabled properly in custom server
Route Loader Trusted Types Violation Fix
Update components in GitHub Actions
Fix various Trusted Types violations without use of policy
Add experimental wildcard
remotePatternsconfig for upstream imagesTweak routing tests
Update renderOpts.dev handling and fix check
Duplicate app server
Add route loader
Fix leftover todo in loader
Leverage pageExtensions for resolving in loader
Use react dom server node api to detect react root is enabled
Replace use-subscription with use-sync-external-store
Add flight render starting point
Better cookies API for Edge Functions
Clarify variables being used during rendering
Update x-nextjs-cache header in minimal mode
Add experimental flag to force SWC transforms
Update root component handling
Add final newline to package-lock.json
Move FlightManifestPlugin to server compilers
Update moduleNameMapper jest config and remove extra deps
Wait for shell resolve with gIP is customized in react 18
Build x86_64-freebsd SWC binary
Don't convert error to string
#36534: Enable interopClientDefaultExport for next/jest
#30300: Force export 404.html
Telemetry: Track usage of 'experimental/nextScriptWorkers'
Eagerly load swc bindings for wasm fallback for jest
Add experimental config for basePath testing
Enable html post optimization for react 18
Update client router for tests
Fix return type of middleware
req.cookies.get()Make esm default interpolation work with jest mock
Decouple entries for server components and client components
#36855/#30300: Export 404.html correctly
- Removed
Drop the unstable web vital hook and remove exports of flush effects
Update swc
Add additional layer for server components case
Support graceful shutdowns
Update @types/node-fetch to latest
Fix SWC dynamic transform with suspense but without ssr
#36651: Disable reactRemoveProperties in jest transform
Update swc
Update lockfile patching for different versions
Add support for browserslist and legacyBrowsers experimental option
Remove optional chaining from eslint rule to support older node versions
Escape flight response values
middleware: False positive dynamic code detection at build time
Fix interopDefault on jest object-proxy
Simplify the logic for static flight response generation
Fixes
beforeInteractivescripts failing in custom documentChange experimental
layout=rawto use native img lazy loadingDon't add locale to client side redirects from data fetching
Edge Cookies: Add
.getWithOptionsmethod- Deprecated
Deprecate nested Middleware in favor of root middleware
Fix styled-jsx not working in client components in the edge runtime when SSR
Update to latest version of @vercel/nft
Fixes beforeInteractive inline scripts don't run
Update swc
- Breaking
middleware: Forbids middleware response body
Extract and refactor
getPageStaticInfoKeep custom app as non server component
Ensure hydration error doc link is shown with react 18
Stabilize SWC emotion transform plugin
DecodeError from invalid URI causes 500 with middleware (vs 400 without)
Opt-out Error page from dark scheme color
Properly await for this.hasPage() in base-server
Enable Trusted Types Compatibility in Webpack
Fix Trusted Types violations from dangerouslySetInnerHTML on style elements
Remove invalid attrs for head html element
Fix next/link can't jump to non-latin anchors
Cleaner error message when importing sass without it being installed in dev
#33081: Handle relative path correctly
Place the charset meta tag at the top of the head
Keep method when cloning Request, fixes #36522
Catch hash change errors, and emit a
routeChangeErroreventShould listen for config file changes when specifying the app directory
Improve getStaticProps error message
next-swc: Improve error message for nested styled jsx tags
Add missing file in mini-css-extract-plugin
Fix NextApiRequestCookies and NextApiRequestQuery types
Add eslint rule for not allowing styled-jsx in _document.js
Scroll restoration bug caused by
idxreset to 0 on reloadAdd JSX.Element to styles type in DocumentInitialProps
Fix Type to solve issue found
Warn when building a TS project with composite: true and fallback to incremental
Support TS exactOptionalPropertyTypes (fixes #35280)
middleware: Issues warnings when using node.js global APIs in middleware
Run type check and eslint in parallel
Remove process.cwd usage from path polyfill
Add libc field to swc packages
typescript: Worker execution failed with custom
next.config.jsUpdate swc
Update swc
Fix client component hydration
Avoid anonymous function in next/link
Should render the correct sizes passed when a noscript is rendered
Use customized chunk loading implementation
Rename app paths folder
Fix experimental
remotePatternswildcardSplit useServerResponse for initial responses
Refactor fetchFlight
next/swc: Support experimental swc plugins
Small code improvements
Use deterministic module IDs in the client bundle
Execute middleware on Next.js internal requests
Preload chunks for next/dynamic in suspense mode
Refactor incremental cache to be extensible
Ignore popstate with invalid state
Show warning during build if page is returning a large amount of data
Add
swcMinifyDebugOptionsUpdate to leverage pnpm for monorepo
Refactor client component out of client runtime
Update to not trigger revalidation during prefetch
Upgrade amp optimizer to v2.8.3
Use Edge Runtime for running Edge Functions locally
Do not pass
legacyBehaviourtoaas propAdd router replace to experiment
Extract router utils to common functions
Include router context as rsc shared dep
Update to leverage turbo for build/prepublish
Update of @babel/core
Migrate prerender lru cache into fs cache handler
Support
runtime: edgein api endpointsRevert "support
runtime: edgein api endpoints"Ensure type check/link worker does not retry
Revert "Revert "support
runtime: edgein api endpoints""Revert Edge API endpoints
Handle link with back/forward navigation
- Deprecated
Edge Functions: Deprecate access to
request.page Fix bloat in main bundle from amp
Add Suspense boundary to demo
Update webpack and watchpack
Fix next dev not working for server components in app
Use the new moduleMap option in the flight client during SSR
Remove unused id rsc cache cleaning and avoid rsc refresh existed in client chunk
Allow Middleware to set its matcher
Skip loading unused plugins in
next devFix
next/imageusinglayout=rawwithpriorityFix document head with react 18
Set
swcMinifyas an attribute onterser-webpack-plugin-optimizespanAllowing hiding the ReactDevOverlay
Ensure ENOENT error is not ignored when loading pages
Upgrade node-html-parser
Fix invalid middleware regexp in manifest
Avoid unnecessary router state changes
Enable externalHelpers swc option
Add check for duplicate locales
Add method to measure Interaction to Next Paint (INP)
Update to latest version of @swc/helpers
Support any
methodwhen fetching aRequestinstanceMigrate head side effects to hooks
#37106: Middleware can not be loaded from src folder
Remove Middleware Preflight
eslint: False positive for legit next/server imports
Revert "Avoid unnecessary router state changes"
Middleware: Remove
req.uaSupport destructuring for env vars in static analysis
Fix react root env missing in NextServer
Fix client entry unexpectedly created in app dir
Ensure check-precompiled exits correctly on failure
Revert "Revert "Avoid unnecessary router state changes""
Update to process redirects/rewrites for _next/data with middleware
Bump @vercel/nft 0.20.0
Strip next internal queries for flight response
next export: Add warning if using getInitialProps
Update matched path params priority
Re-introduce Edge API Endpoints
Fix rewrite/dynamic interpolation E2E cases
Fix Image Optimization cache-control regression with external images
Adds consistency to ESLint rules.
Ensure custom middleware matcher is used correctly in client manifest
Optimize middleware regex handling
Revert "Revert "Revert "Avoid unnecessary router state changes"""
Add test combining middleware & config rewrites
ts: Expose
DynamicOptionsLoadingPropstypeImprove Middleware errors
Ensure navigating with middleware parses route params correctly
Fix shallow routing with rewrites/middleware
Ensure rewrite query params with middleware are available in router
Update pre-compiled
eslint: Allow in conjunction with
Warn dynamic WASM compilation
Update to skip middleware for unstable_revalidate
Remove previous query param deleting warning
Enhance experimental feature warning
Add
images.unoptimized: truefor easynext exportEnsure eslint-config warning/errors are correct
Refactor server routing
Ensure query params are populated correctly with middleware
Use SVG blur technique for raw layout images
config: Only warn experimental feature when used
Display full refresh warning even when error has occurred
Detect pnpm correctly when installing missing dependencies
Throw an error when
target: 'serverless'is used with MiddlewareEnable
externalHelperswhen pre compiling Next.js' codeRevert "Enable
externalHelperswhen pre compiling Next.js' code"Allow Edge Functions to receive body
Add hard navigation guard and fix middleware rewrite cases
Allow wasm usage
Include i18 and basePath on middleware with custom matchers
Fix compile time log after error
Fix
<Image/>'slazyRootand other optimizationsResolve swc-plugin paths
Update swc
Ensure next-server tracing uses tracing root config
Migrate middleware ssr to edge functions
Fix styled-jsx types when package is not hoisted
Remove full reload overlay and warn in CLI instead
Remove NextResponse.json as we already have it defined from inheriting Response
Keep _ssgManifest.js output uniform
Fix next/head in _app in RSC pages
Ensure resolvedUrl is correct with fallback rewrites
Ensure special chars in middleware matcher is handled
Drop experimental.reactRoot in favor of auto detection
Enable configuration of
styled-componentstransform and enablecssprop supportEnable styled-components css prop swc transform by default
Ensure cache-control is correct when returning redirect
Move styled-jsx type reference
Add experimental
next/future/imagecomponentRemove Middleware warning message
Fix hard navigation guard on popstate and handle fetching fresh data
Fixes for middleware compilation errors
Fix npm publish to include
futurefolderMove outputStandalone config
Move
rimraffrom root packages using itOn-demand ISR updates
Hardcoded protocol in request url
Fix eslint-config-next peer dep issue
#37981: Handle legacy link behavior with number type children
Fix invalid warning for existing experimental flag
cli: Allow configuration of http-server's timeout configuration
Remove
no-server-import-in-pageruleEnsure we do not ignore module not found errors during build
Rename page runtime edge to experimental-edge
Remove layout raw image experiment
Allow
next/scriptto be placed in_documentbodyAvoid fetching a chunk for api endpoints on middleware redirect
Upgrade Edge Runtime
cli: Report
eslint-config-nextversion innext infoAdd invariant with debug information when failing to load static file
Add error for renaming of unstable_revalidate
next: Bind new stream functions with base incomingMessage object
Add
initto someNextResponsemethodsFix resolving dynamic routes when on returns a redirect
Remove unnecessary
<noscript>fromnext/future/imageEnsure history navigation is correct after query update
Ensure client cache keys match between prefetch and transition
Upgrade Edge Runtime
Documentation Changes
Missing parentheses
Example Changes
with-tailwindcss-emotion: 'theme' of undefined
Markdown format for the blog-starter example
Add correct type to with-styled-coponents
38043: Replace double slashes with hashtag for comment lines in …
Misc Changes
Enable disabled tests that pass
Fix copying local swc binary for pnpm test
Fixed anotation param name
Add typedef for next-bundle-analyzer
Add tests for getStaticProps and getServerSideProps
Fix example extraction when branch name contains slash
Fix build-wasm CI job
Fix memory allocation issue on linux gnu platform
Add type definitions for next/mdx
Ensure all bench dependencies are added
Add version step for publish
Ensure pnpm is available during publish
Fix font-optimization snapshot test
Removes invalid path from doc
Add middleware size stats
Fix failing swc builds
Allow passing FileRef directly to createNext
Add bug report field to issue template
Fix a couple flakey next-script and unoptimized image tests
Add a test that verifies that NextResponse can be cloned
cli: Support examples without
package.jsonEnsure repo is checked out before running validate issue action
Fix issue-validator path
A whole project to check? Paste its package.json in the dependency check: every deprecated, outdated or vulnerable dependency, with what to upgrade to. Free, no account.