Bug Fixes

App Router

• include parallel slot params in useParams (#1904)
• preserve unstable_catchError boundaries (#1906)
• suppress redirect console errors in production onCaughtError (root-layout-redirect) (#1878)
• preload next/dynamic chunks with CSP nonce (#1594)
• extend OTel tracer provider for Cache Component span context (#1868)
• return HTTP 200 when notFound() is thrown from generateMetadata (#1864)
• discover parallel-slot pages inside route groups for catch-all + parallel-routes-group (#1865)

Pages Router

• support stream proxying in API routes (#1902)
• set x-nextjs-deployment-id on SSG _next/data responses (#1863)
• buffer SSR response for crawler/bot User-Agents (#1876)
• hard-navigate to App Router destinations from Pages Router links (#1879)
• bridge deprecated Router.on property callbacks (#1869)

Misc

• Router: support experimental gesture push (#1909)
• Prod Server: stop double-evaluating the server bundle when chunks import the entry back (#1924)
• Trailing Slash: canonical url trailing slash support (#1888)
• Edge Wasm: handle *.wasm?module imports in non-Cloudflare builds (#1877)
• Config: define cache components flag as boolean (#1903)
• Scss: preprocess SCSS CSS-module composes deps via SassAwareFileSystemLoader (#1882)
• Routing: normalize route root to forward slashes, drop downstream path workarounds (#1896)
• Middleware: clear nextUrl.basePath for absolute paths outside basePath (part of #1830) (#1872)
• Cloudflare: update cache adapter jsdoc and examples (#1898)
• Fonts: normalize shims dir so shim-skip guards match on Windows (#1885)
• Check: normalize scanned file paths to forward slashes on Windows (#1887)
• Shims: use path.posix.join in resolveShimModulePath for Windows (#1886)
• Scss: resolve tilde (~) imports from node_modules and project root (#1881)
• Build: define process.env.NEXT_RUNTIME for server bundles (#1880)
• Build: inline ../-relative font assets in OG routes (#1866)
• Use Cache: pass soft tags to cache lookup so revalidatePath invalidates use-cache entries in route handlers (#1867)

Performance

• Server: eliminate redundant per-request parsing in the request pipeline (#1929)
• Server: hoist per-request regex compilation out of SSR streaming and shim hot paths (#1915)

Contributors

• @Divkix
• @james-elicx
• @jgeurts
• @MaxtuneLee
• @NathanDrake2406
• @shulaoda

Contributors

• @jgeurts
• @james-elicx
• @Divkix
• @MaxtuneLee
• @NathanDrake2406
• @shulaoda

Bug Fixes

• Cloudflare: update cache adapter jsdoc and examples (#1898)

Contributors

• @james-elicx

Contributors

• @james-elicx

Bug Fixes

App Router

• match Pages navigation params in hybrid builds (#1741)
• include route pattern in repeated-slash Link warning (#1554) (#1855)
• scroll to top with hoisted children and loading.js (#1368) (#1857)
• resolve explicit parallel slot with no page (#1535) (#1852)
• propagate "use cache" tags to route-handler ISR entries (#1453) (#1848)
• resolve query-only Link href against current path (#1540) (#1844)
• render built-in fallback when global-error.tsx throws (#1548) (#1837)
• clear useLinkStatus pending after interrupted navigation (#1527) (#1839)
• respect reactMaxHeadersLength for preload Link header (#1552) (#1841)
• preserve _rsc query across redirects (#1529) (#1838)
• apply trailingSlash to route handler request URL (#1827) (#1835)
• restore scroll snapshots on back (#1743)
• isolate page CSS chunks in production (#1738)

Build

• correct CSS ordering for global-not-found (#1549) (#1858)
• exclude Vite build manifests from Cloudflare asset uploads (#1850)
• don't crash on benign floating asset-import errors (#1510) (#1846)
• expand require.context into import.meta.glob map (#1501) (#1836)
• don't path-resolve bare specifier aliases for esmExternals (#1507) (#1843)
• don't crash build when a PostCSS string plugin can't be resolved (#1509) (#1840)

Misc

• Pages Router: pass revalidateReason "on-demand" to gsp/gssp (#1462) (#1856)
• Actions: return 404 for MPA action on app with no server actions (#1340) (#1853)
• Routing: propagate middleware draft cookie to pages/api fallback (#1520) (#1845)
• Actions: enforce serverActions.bodySizeLimit on fetch actions (#1828) (#1834)
• support sibling-style interception routes (#1804)

Contributors

• @Divkix
• @james-elicx
• @NathanDrake2406

Contributors

• @james-elicx
• @Divkix
• @NathanDrake2406

Today's release contains several app router bundling improvements like code splitting and lazy loading for faster cold starts, and minification by default for smaller bundles. Several CLI crashes were fixed for large projects, and more Next.js parity gaps were addressed.

Vinext now supports additional configuration for caching -- the Vite plugin supports a cache object, where adapters for a data cache and a cdn cache can be supplied. The cdn adapter is intended to be used for route-level caching, while the data adapter is used for everything else, and is used for route caching in the absence of a cdn adapter. This is intended to replace manual setup in the Worker.

import vinext from "vinext";
import { kvDataAdapter } from "@vinext/cloudflare/cache/kv-data-adapter";
vinext({
 cache: { data: kvDataAdapter() },
});

Features

Cache

• extract Cloudflare cache adapters into @vinext/cloudflare (#1748)
• configure cache adapters from vite plugin config (#1733)
• split CDN and data cache adapters; add Cloudflare edge adapter (#1693)

Misc

• Deploy: honor Worker-entry cache setters for ISR deploys (#1821)
• PPR: add PPR fallback-shell render lifecycle tests (#1715)
• Release: commit-driven auto-generated changesets (#1753)
• improve dev error overlay source frames (#1746)
• Skip: omit proven static layouts from RSC transport (#1437)
• PPR: add encodePrerenderRouteParams and match kind exact payload tests (#1714)
• Skip: plumb client reuse manifests through the app request path (#1717)
• App Router: support useRouter bfcacheId semantics (#1588)

Bug Fixes

App Router

• preserve recent segment state with Activity BFCache (#1739)
• hard navigate streamed redirects (#1742)
• refetch same-page search navigations (#1744)
• match streaming metadata error responses (#1794)
• track searchParams access for static bailout (#1788)
• honor per-response dynamic stale times on the client (#1712)
• ensure streamed SSR body ends with (#1532) (#1624)
• emit per-page dynamic stale time metadata (#1711)
• prerender cacheComponents root-param fallback shells (#1702)

Build

• share one RSC compatibility ID across all plugin instances (#1814)
• write BUILD_ID via writeBundle so App Router builds emit it (#1810)
• bundle @vinext/cloudflare into vinext to break dependency cycle (#1797)
• emit Next client runtime manifests (#1735)

Pages Router

• collapse doubled basePath in client asset URLs (#1730)
• make req async-iterable for bodyParser: false (#1479) (#1678)
• run instrumentation-client.ts before hydration (#1474) (#1671)
• cancel in-flight nav on gSSP/gSP data redirect (#1465) (#1691)

Misc

• Check: only flag config options used as property keys (#1778)
• Image: scan image imports via AST instead of regex (#1779)
• Image Imports: normalize meta specifier separators on Windows (#1791)
• Font: resolve next/font/local paths inside node_modules packages (#1780)
• Check: prevent regex stack overflow / hang on very large files (#1776)
• Form: DISALLOWED_FORM_PROPS stripping, file input warning, viewport prefetch, pages-router E2E (#1752)
• Middleware Runtime: normalize trailing slash on plain-URL redirect locations (#1750)
• Routing: correct (.) interception target for nested slot subdirectories (#1751)
• OG: lazy-load @vercel/og to keep it out of the main worker entry (#1774)
• Config: avoid duplicate CJS global shims (#1771)
• Deploy: respect --env flag when invoking build (#1694)
• Pages: render custom errors for notFound results (#1737)
• client HMR dev overlay recovery (#1758)
• Server: define CJS path globals in bundled modules (#1740)
• Link: full-prefetch dynamic routes without loading shells (#1734)
• Skip: centralize final static-layout skip rejection (#1722)
• dev overlay browser sourcemap stacks (#1731)
• i18n: make locale sticky across client navigations (#1407)
• Cache: attach path tags to prerender-seeded entries so revalidatePath invalidates them (#1486) (#1688)
• CSS: preserve distinct media filenames for CSS url() assets (#1725)
• Metadata: omit unused parent arg for cached generateMetadata (#1719)

Performance

• OG: dedupe resvg/yoga wasm in server bundle (#1801)
• Router: lazy-load App Router page and route-handler modules (#1781)
• Build: minify server build environments by default (#1777)
• Utils: skip path separator replace on POSIX (#1766)

Contributors

• @aicayzer
• @Divkix
• @hyoban
• @james-elicx
• @manNomi
• @NathanDrake2406
• @shulaoda

Contributors

• @james-elicx
• @aicayzer
• @Divkix
• @hyoban
• @manNomi
• @NathanDrake2406
• @shulaoda

Features

• Cache: extract Cloudflare cache adapters into @vinext/cloudflare (#1748)

Contributors

• @james-elicx

Contributors

• @james-elicx

What's Changed

New Features

• Added experimental appShells configuration option with validation support
• Added support for Sparkle experimental flags: varyParams, optimisticRouting, and cachedNavigations
• Added layout safety observation foundations for improved skip optimization
• Added static layout reuse proof model for better performance analysis

Bug Fixes

• Fixed app router navigation to better align with Next.js behavior
• Fixed Pages Router to properly run _document.getInitialProps with renderPage enhancers
• Fixed Head component to preserve charset and viewport defaults during client hydration
• Fixed Pages Router to deduplicate in-flight _next/data fetches by URL to prevent redundant requests
• Fixed Head component to match Next.js charset/viewport ordering and properly merge _document.getInitialProps head elements
• Fixed TypeScript next.config loading to keep packages externalized
• Fixed TypeScript config resolution to properly handle baseUrl imports from tsconfig.json
• Fixed server-only imports to work correctly from 'use server' modules
• Fixed fnv1a64 hash function to produce consistent fixed-width output
• Fixed App Router to preserve forwarded action redirect wrappers
• Fixed App Router to reuse pending prefetched RSC payloads for better performance
• Fixed App Router to preserve middleware headers on metadata routes
• Fixed Pages Router to preserve import.meta.url source paths
• Fixed server-only imports to be properly rejected from client-reachable modules

Performance

• Improved memory management with bounded default cache size and LRU eviction
• Enhanced ISR cache key generation to include i18n context for better cache accuracy

Internal / Chores

• Updated @vitejs/plugin-rsc dependency to version 0.5.27
• Added regression test for parallel slot page-over-default priority

Contributors

@NathanDrake2406
@james-elicx
@southpolesteve
@Divkix

Contributors

• @southpolesteve
• @james-elicx
• @Divkix
• @NathanDrake2406

What's Changed

New Features

• Added support for inline CSS parity in App Router
• Implemented compiler.define and compiler.defineServer configuration options
• Added compiler.removeConsole build option to strip console statements

Bug Fixes

App Router

• Fixed static-sibling info inclusion in SSR responses
• Fixed caching for pages with revalidate=Infinity or revalidate=false
• Fixed module-only Vite reference errors now properly treated as action-not-found
• Fixed forbidden() and unauthorized() to properly escalate past intermediate layouts
• Fixed client prefetch cache to honor experimental.staleTimes configuration
• Fixed routing to treat @children as transparent so explicit pages win over catchalls
• Fixed action Set-Cookie header deduplication by name
• Fixed icons.other metadata to accept single descriptor format
• Fixed draftMode() reads inside cache scopes
• Fixed cookie and header propagation from server actions without JavaScript
• Fixed global-not-found chunk isolation to prevent CSS cascade issues
• Fixed unstable_rootParams propagation to actions and route handlers
• Fixed spacing in streamed error meta tags
• Fixed autoscroll preservation across page refreshes
• Fixed updateTag to throw proper error when called outside Server Actions
• Fixed source identity preservation for intercepted renders
• Fixed default autoscroll page target behavior

Pages Router

• Fixed Document.getInitialProps invocation so document props reach SSR
• Fixed app route detection during prefetch operations
• Fixed custom pages/500 rendering on SSR errors
• Fixed non-serializable getStaticProps/getServerSideProps error handling
• Fixed page script emission with defer attribute in <head> by default
• Fixed useParams snapshot stabilization for SSR
• Fixed static page responses to return 405 with proper Allow header for invalid methods
• Fixed 404 responses for invalid _next/static requests in worker deployment

General

• Fixed Next.js script stylesheets to emit proper <link rel="stylesheet"> tags
• Fixed unstable_retry to throw proper Pages Router parity error
• Fixed webpack loader side effects to apply process.env mutations
• Fixed build process to inline process.env.NEXT_DEPLOYMENT_ID for client and worker bundles
• Fixed OpenTelemetry to inject experimental.clientTraceMetadata into SSR head
• Fixed build to forward pageExtensions to Vite resolve extensions
• Fixed middleware to stop merging original query into rewrite targets
• Fixed Link component href/onClick forwarding in legacyBehavior mode
• Fixed React DOM prop name translation to HTML attributes in hoisted scripts
• Fixed route handler Set-Cookie default Path=/ when merging mutable cookies
• Fixed routing precedence when both pages/_foo.tsx and app/ directory exist
• Fixed development favicon.ico handling to avoid expensive 404 renders

Performance

• Moved normalizePathSeparators utility to shared path utils
• Reused normalizePathSeparators for static file cache path handling

Internal / Chores

• Added comprehensive test coverage for Link component onClick/preventDefault behavior
• Added regression tests for API route dispatch with middleware
• Added trailing slash enforcement tests for App Router
• Added regression tests for URL-encoded CSS paths
• Added shallow Router.push redirect bypass tests
• Added edge runtime and OG image API route tests
• Added metadata regression test for dynamic icon hrefs
• Added Link component OnNavigate fixture tests
• Added form action regression tests
• Added various other regression and edge case test coverage

Contributors

@Divkix
@NathanDrake2406
@james-elicx
@manNomi
@shulaoda

Contributors

• @james-elicx
• @Divkix
• @manNomi
• @NathanDrake2406
• @shulaoda

What's Changed

New Features

• Added support for nextConfig.instrumentationClientInject configuration option
• Pages Router now consumes _next/data JSON endpoint from the client, improving data fetching behavior

Bug Fixes

Security Fixes

• Fixed bodyParser configuration to be properly honored in Pages API routes
• Fixed x-forwarded-proto header handling in Edge API runtime when trustProxy is disabled
• Bounded cache key cardinality for x-vinext-mounted-slots to prevent potential issues
• Kept draft mode secrets out of client-side defines to prevent exposure

App Router

• Fixed RSC navigation scroll targeting to align with Next.js behavior
• Fixed prerender parameter encoding to be properly preserved
• Fixed dynamic route parameter key ordering to match expected behavior
• Fixed history index preservation when external state writes occur
• Fixed metadata file exports for static App Router builds
• Fixed metadata streaming for non-HTML bot requests
• Fixed Edge runtime header application across all App Router response paths
• Fixed Vary header emission on Edge RSC route responses
• Fixed 307 status code preservation on document loads during prerender
• Fixed router.prefetch to properly throw errors on invalid URLs
• Fixed inline beforeInteractive script hoisting above resource hints

Pages Router

• Fixed basePath error route rendering when masked
• Fixed revalidateReason parameter passing to getStaticProps and improved default Cache-Control headers
• Fixed Promise-shaped getServerSideProps props to be properly awaited
• Fixed dangerous URI scheme detection to throw errors synchronously
• Fixed query string preservation in Link component and router.push calls
• Fixed default Cache-Control headers on getServerSideProps responses
• Fixed router push/replace methods to properly return Promise
• Fixed head element attributes to use data-next-head instead of data-vinext-head

Other Fixes

• Fixed 404 page default copy to match Next.js exactly
• Fixed image optimization to emit proper /_next/image URLs
• Fixed server action redirects to properly resolve relative URLs
• Fixed Pages Router middleware redirect handling
• Fixed static file cache path normalization on Windows
• Fixed cache request data to be properly marked as private
• Fixed relative URL error handling in NextRequest to throw canonical errors
• Fixed font binding family preservation for local fonts
• Fixed stale build output cleanup before rebuilds
• Added warning when legacy middleware filename is detected
• Added warning for repeated forward slashes in Link href props

Contributors

@james-elicx
@NathanDrake2406
@Divkix
@jgeurts
@manNomi
@shulaoda
@ikxin

Contributors

• @jgeurts
• @james-elicx
• @Divkix
• @ikxin
• @manNomi
• @NathanDrake2406
• @shulaoda

What's Changed

New Features

• Added native App Router route type generation via CLI
• Introduced cache reuse proof system for static layout artifacts with cross-checks
• Implemented _next/data JSON endpoint for Pages Router
• Added support for onNavigate prop in Next.js Link components
• Exposed window.next.router on hydration in Pages Router
• Added experimental appShells configuration plumbing
• Added disabled ClientReuseManifest protocol support

Bug Fixes

Router & Navigation

• Fixed route hybrid pages API fallbacks to properly route through pages entry
• Fixed deployment fallback hard navigations in App Router
• Preserved default locale for unprefixed root links
• Fixed parameter isolation for root-params in prerendering and SSR
• Normalized trailing slash behavior for routing parity
• Fixed route priority preservation on middleware rewrite target resolution
• Rendered optimistic loading shells for dynamic App Router navigation
• Rendered loading shell for unlisted fallback: true paths in Pages Router

Internationalization (i18n)

• Normalized default-locale paths before route matching
• Stripped locale prefix for API routes
• Honored locale: false setting on rewrites/redirects with proper default-locale redirect
• Preserved i18n client root navigation in Pages Router

Middleware

• Allowed server-only imports in middleware
• Preserved query parameters on rewrite
• Fixed redirect protocol with relative Location and x-nextjs-redirect headers

App Router

• Parsed interception route markers in route scanner
• Resolved nested slot pages over default.tsx in parallel routes
• Emitted metadata from parallel route slots
• Prerendered layout static params
• Returned 404 + x-nextjs-action-not-found for missing actions

Pages Router

• Honored shallow prop on next/link
• Avoided getServerSideProps identifier collision during build
• Wrapped edge API requests in NextRequest with bare runtime export support
• Guarded navigation shim against SSR
• Executed edge API routes with Fetch Request

Caching & Performance

• Preserved Next.js cache headers for prerendered app pages
• Wired next/after to Workers ctx.waitUntil in deploy mode

Assets & Styling

• Set default assetsDir to _next/static for Next.js parity
• Supported data URL composes in CSS modules

Configuration & Base Path

• Enforced trailing slash configuration in routing and middleware redirects
• Enforced base path scoping on rewrites/redirects/routes
• Applied basePath and route via Pages Router for form soft navigation
• Added deprecation warning for experimental.rootParams

Metadata & URLs

• Matched Next.js metadata image route behavior
• Fixed usePathname to return canonical URL after middleware rewrite
• Warned on blocked javascript: URL navigation
• Passed params: null instead of {} for non-dynamic routes

Error Handling & Flight

• Matched Next.js default error page UI
• Returned flight payload (200) for RSC navigations on redirects
• Awaited top-level await module imports

Performance

• Pre-installed compatible React in deploy harness for faster e2e tests

Internal / Chores

• Migrated font-google tests from fetch hijacking to MSW
• Introduced MSW infrastructure for testing
• Extracted Playwright cache plumbing into composite action
• Split e2e compatibility testing by App Router vs Pages Router
• Refactored navigation runtime topology

Contributors

@Divkix
@JamesbbBriz
@NathanDrake2406
@james-elicx
@lyzno1

Contributors

• @james-elicx
• @Divkix
• @lyzno1
• @JamesbbBriz
• @NathanDrake2406

What's Changed

New Features

• Implemented assetPrefix config with full Next.js semantics (path-prefix and absolute-URL forms, basePath fallback)
• Added App Router support for app/global-not-found.tsx (Next.js 16 parity)
• Added dev server lock file to prevent concurrent dev sessions
• Added manifest-backed interception topology to the App Router
• Planned App Router navigation from RouteManifest topology
• Promoted intercepted route preservation through the navigation planner
• Recorded App Router render observations in the caching layer
• Classified private and dynamic render downgrades in the cache
• Added static layout proof and variant budget guardrails to the cache
• Added support for declared artifact compatibility sets
• Added /compatibility page backed by D1 + deploy-suite ingest

Bug Fixes

• Matched Next dynamic route semantics for metadata routes
• Applied ancestor templates to title defaults in metadata
• Threaded basePath through metadata, manifest, and redirects
• Emitted streamed redirect and not-found meta tags
• Rendered progressive action not-found HTML on the server
• Threw a typed error for unrecognized server actions
• Modeled RSC redirect and traversal lifecycle
• Hard-navigated stale RSC build payloads
• Hydrated initial root in a transition
• Kept refresh transitions pending until completion
• Refreshed after discarded revalidating actions
• Skipped RSC navigation for hash-only history traversal
• Tracked hash-only traversal metadata
• Guarded stale popstate scroll restoration
• Preserved history metadata for external state updates
• Promoted default slot persistence through route state
• Forwarded searchParams correctly in probePage()
• Matched Next.js RSC Content-Type and 404 plain-text body
• Added x-action-forwarded guard to prevent server action forwarding loops
• Surfaced invalid dynamic usage errors via Flight in dev
• Populated useParams/useSearchParams under the Pages Router
• Included _app module assets in served page HTML
• Shared pages useRouter state through context
• Derived shallow dynamic params from the URL
• Kept next/router import free of popstate side effects
• Supported string paths and missing params in getStaticPaths
• Decoded hash scroll targets
• Threw when App Router context is missing during navigation
• Supported prefetch invalidation callbacks
• Gated intercept matching on Next-URL source pattern
• Aligned visible and intent prefetching for next/link
• Normalised next/link href for trailingSlash config
• Preserved native URI scheme navigation (mailto:, tel:, etc.) in next/link
• Preserved native download clicks in next/link
• Preserved unsafe href click handlers in next/link
• Cleared blur placeholder after image load
• Emitted preload hints for priority images
• Preserved fill positioning for remote images
• Preserved inline styles on remote images
• Excluded ipaddr.js from SSR dep optimizer
• Preloaded <script> sources during SSR via ReactDOM.preload
• Honored async={false} for client scripts
• Deduped concurrent same-src script loads
• Treated draftMode() as non-dynamic; mark dynamic only on enable()/disable()
• Added unstable_catchError, unstable_rethrow, unstable_isUnrecognizedActionError shims
• Matched Next.js font result style semantics
• Attached inner "use cache" call site as cause of nested-dynamic error
• Preserved binary inlined Flight chunks
• Preserved exported client reference subpaths
• Allowed JSX in .js client modules inside node_modules
• Pinned cssTarget so esbuild preserves max-width media-query syntax
• Emitted SSR CSS assets referenced by SSR entry
• Passed sassOptions from next.config to the Vite preprocessor
• Recognized next.config.mts and interop CJS imports in the config loader
• Loaded CJS next.config.js under "type": "module"
• Provided CJS globals when loading next.config.ts
• Parsed route exports with the OXC AST in build report
• Exposed AsyncLocalStorage as a global in the edge runtime
• Cleared browser globals before SSR user modules
• Fixed next build failure for the app-router-playground example

Internal / Chores

• Updated @vitejs/plugin-rsc to 0.5.26
• Bumped Node to 24 in CI for native URLPattern support
• Cached WebKit apt archives and skipped browser install on cache hit
• Added test-path filter input to nextjs-deploy CI
• Defaulted deploy-suite CI to all suites and disabled test retries
• Added basic vinext site
• Updated oxc editor settings
• Added next-env.d.ts to .gitignore
• Clarified middleware.ts deprecation warning is non-fatal
• Deduped push/replace logic in next/router shim
• Consolidated edge globals into installEdgeGlobals() helper
• Shared interception matched-url validation in the router
• Extracted shared static-paths normalization in prerender
• Added regression coverage for next.config runtime value shapes
• Added regression tests for issue #1196 (catch-all route params with basePath + rewrites + middleware)
• Sequenced link.js and importActual to fix link-navigation flake
• Extracted CJS→ESM converter to standalone deploy-suite script
• Handled __dirname, __filename, and require.resolve in CJS→ESM converter
• Injected jiti when deploy-suite test apps use TypeScript config files
• Applied tsconfig.compilerOptions.paths when loading next.config.ts in deploy-suite
• Handled missing optional deps in deploy-suite test fixture configs
• Bumped pinned sass below ^1.70.0 for Vite 8 in deploy-suite
• Created .next/trace before build to avoid ENOENT noise on build failure
• Used correct workers.dev URL for compat ingest

Contributors

• @james-elicx
• @NathanDrake2406
• @Divkix
• @GHX5T-SOL

Contributors

• @james-elicx
• @Divkix
• @NathanDrake2406
• @GHX5T-SOL