nuxt
4.6.4 · 2 Nov 2026MIT3.6M / weekRepositoryHomepagenpmAtom feed
3.21.11 is the newest release of 3.x.
In short
2 removed2 deprecated45 new11 faster66 fixed103 internal
- Removed
schema: Remove some experimental options for v4
- Removed
kit,nuxt: Remove handling for node 14 perf api
- Deprecated
nuxt: Deprecate
process.*flags - Deprecated
Deprecate
pendingvalue in data fetching composables
Security
20 advisories affect 3.12.0; 4.6.0 fixes the others
- ModerateNuxt exposes the message and data of unhandled errors thrown during server renderingGHSA-96x6-fvhx-49hg · 16 Nov 2026No fix yet
- ModerateNuxt: Incomplete fix for GHSA-6gq8-jgmh-3ffp: an encoded slash (`%2F`) in the request path bypasses route rules on catch-all page routesGHSA-f3x9-2chm-73c8 · 16 Nov 2026No fix yet
- ModerateNuxt: Server-side route rules (`redirect`, `headers`, `proxy`, `ssr`) are skipped for case-variant paths when routing is case-insensitiveGHSA-vjh5-4x84-xrqp · 22 Oct 2026No fix yet
- CriticalNuxt vulnerable to remote code execution via the browser when running the test locallyGHSA-v784-fjjh-f8r4 · 5 Aug 2024Fixed in 3.12.4
- HighNuxt: Unauthenticated CPU exhaustion parsing and hashing the Nuxt island endpoint body before hash validationGHSA-9pgf-384g-p7mv · 5 Aug 2026Fixed in 3.21.10
15 more
- HighNuxt: Server-Side Remote Code Execution via Runtime Template Injection in Nuxt Server Island PropsGHSA-9473-5f9j-94wq · 5 Aug 2026Fixed in 3.21.10
- HighNuxt: Unauthenticated out-of-memory crash via unbounded v-for expansion in island renderingGHSA-hxcr-hm88-mpq6 · 5 Aug 2026Fixed in 3.21.10
- HighNuxt: Route-rule middleware bypass via case-sensitivity mismatch between vue-router and the routeRules matcherGHSA-mm7m-92g8-7m47 · 16 Jun 2026Fixed in 3.21.7
- HighNuxt allows DOS via cache poisoning with payload rendering responseGHSA-jvhm-gjrh-3h93 · 19 Mar 2025Fixed in 3.16.0
- ModerateNuxt: Route rules are matched against the raw request path, so a percent-encoded segment can bypass `appMiddleware` on dynamic and catch-all routesGHSA-6gq8-jgmh-3ffp · 22 Oct 2026Fixed in 3.21.4
- ModerateNuxt: Unauthorized Component Instantiation via Server Island PropsGHSA-48hr-524c-v5w3 · 5 Aug 2026Fixed in 3.21.10
- ModerateNuxt: Reflected XSS in `<NuxtLink>` via unsanitised `javascript:` or `data:` URLGHSA-934w-87qh-qr26 · 16 Jun 2026Fixed in 3.21.7
- ModerateNuxt: URL-handling weaknesses in `navigateTo` and `reloadNuxtApp`: SSR open redirect, client-side script execution via the `open` option, and protocol-relative bypass in `reloadNuxtApp`GHSA-c9cv-mq2m-ppp3 · 16 Jun 2026Fixed in 3.21.7
- ModerateNuxt's route middleware is not enforced when rendering `.server.vue` pages via `/__nuxt_island/page_*`GHSA-hg3f-28rg-4jxj · 29 May 2026Fixed in 3.21.6
- ModerateNuxt: Reflected XSS in `navigateTo()` external redirectGHSA-fx6j-w5w5-h468 · 19 May 2026Fixed in 3.21.6
- Moderatenuxt vulnerable to Cross-site Scripting in navigateTo if used after SSRGHSA-vf6r-87q4-2vjf · 5 Aug 2024Fixed in 3.12.4
- LowNuxt: Incomplete fix for GHSA-934w-87qh-qr26: a `javascript:` URL prefixed with an ASCII control character executes from `<NuxtLink>` when `pages` is disabledGHSA-jjm6-p2m9-9w4x · 22 Oct 2026Fixed in 4.6.0
- LowCross-site scripting via <NoScript> slot content in Nuxt's head componentsGHSA-m3q2-p4fw-w38m · 16 Jun 2026Fixed in 3.21.7
- LowNuxt: `__nuxt_island` endpoint does not bind responses to request props, enabling shared-cache poisoningGHSA-g8wj-3cr3-6w7v · 19 May 2026Fixed in 3.21.6
- LowNuxt has Client-Side Path Traversal in Nuxt Island Payload RevivalGHSA-p6jq-8vc4-79f6 · 17 Sep 2025Fixed in 3.19.0
Release note
Highlights
We're on the road to the release of Nuxt 4, but we've not held back in Nuxt v3.12. A huge thank you to the 75+ Nuxt contributors and community members who have been part of this release. ❤️
Testing Nuxt 4 changes
Nuxt 4 is on the horizon, and it's now possible to test out the behaviour changes that will be coming in the next major release (#26925) by setting an option in your nuxt.config file:
export default defineNuxtConfig({
future: {
compatibilityVersion: 4,
},
})As we've been merging PRs for Nuxt 4, we've been enabling them behind this flag. As much as possible we're aiming for backwards compatibility - our test matrix is running the same fixtures in both v3 and v4 compatibility mode.
There is a lot to say here, with 10+ different PRs and behaviour changes documented and testable, but for full details, including migration steps, see the v4 upgrade documentation.
We'd be very grateful for early testing of what's coming in Nuxt 4! 🙏
Nuxt Scripts auto-install
We've been gradually working to release Nuxt Scripts. It's currently in public preview, but we're near a public release, so we've added some stubs for composables that (when used) will prompt installing the @nuxt/scripts module.
👉 Watch out for the launch - and an article explaining more!
Layer auto-registration and bugfixes
Just like ~/modules, any layers within your project in the ~/layers directory will now be automatically registered as layers in your project (#27221).
We also now correctly load layer dependencies, which should resolve a range of issues with monorepos and git installations (#27338).
Built-in accessibility improvements
We now have a built-in <NuxtRouteAnnouncer> component and corresponding useRouteAnnouncer composable, which will be added by default to new Nuxt templates going forward.
For full details, see the original PR (#25741) and documentation.
We're continuing to work on nuxt/a11y - expect to hear more on that in future!
Performance improvements
We've landed some performance improvements as well, many of which are behind the compatibilityVersion: 4 flag, such as a move away from deeply reactive asyncData payloads.
Significant improvements include deduplicating modules (#27475) - which will apply mostly to layer users who specify modules in their layers. In one project, we saw 30s+ improvement in starting Nuxt.
We've also improved Vite dev server start up time by excluding common ESM dependencies from pre-bundling, and would suggest module authors consider doing the same (#27372).
We improved chunk determinism, so sequential builds should be less likely to have completely different chunk hashes (#27258).
And we tree shake more client-only composables from your server builds (#27044), and have reduced the size of server component payloads (#26863).
Multi-app support
We've landed a couple of changes that take us toward a place of supporting multi-app natively in Nuxt, including a multiApp experimental flag (#27291) and the ability to have multiple Nuxt app instances running in parallel at runtime (#27068).
While it's not yet ready, please do follow along on the tracker issue, and feel free to pitch in if this is interesting to you.
DX wins
We now serialise more things in your dev server logs, including VNodes (#27309) and URLs. We also addressed a bug that could lead to a frozen dev server.
When accessing private runtime config in the browser, we now let you know with a more informative error message (#26441).
Stabilising features
We've removed some experimental options that have been stabilised and which we feel no longer need to be configurable:
experimental.treeshakeClientOnly(enabled by default since v3.0.0)experimental.configSchema(enabled by default since v3.3.0)experimental.polyfillVueUseHead(disabled since v3.4.0) - implementable in user-land with pluginexperimental.respectNoSSRHeader(disabled since v3.4.0) - implementable in user-land with server middleware
We've also enabled scanPageMeta by default (#27134). This pulls out any page metadata in your definePageMeta macro, and makes it available to modules (like @nuxtjs/i18n) so they can augment it.
This unlocks much better module/typed routing integration, but has a potential performance cost - so please file an issue if you experience any problems.
Type improvements
We now have support for typed #fallback slots in server components (#27097).
We've also improved some defaults in your generated tsconfig.json, including setting module: 'preserve' if you have a locally installed TypeScript v5.4 version (see docs) - see #26667, #27485.
Module author/power user improvements
We have shipped a range of type improvements for module authors, including:
Support for typed module options in
installModuleThe option to specify compatibility with certain builders (vite/webpack) in module options
A new
onPrehydratehook for hooking into the browser hydration cycleThe ability to access and update resolved runtime configuration within modules, with new build-time
useRuntimeConfigandupdateRuntimeConfigutils
Inlined UI templates
If you previously used @nuxt/ui-templates then it may be worth knowing that we have moved them from a separate repository into the nuxt/nuxt monorepo. (This is purely a refactor rather than a change, although you can expect some new designs for Nuxt v4.)
Upgrading
As usual, our recommendation for upgrading is to run:
npx nuxi@latest upgrade --force
This will refresh your lockfile as well, and ensures that you pull in updates from other dependencies that Nuxt relies on, particularly in the unjs ecosystem.
Changelog
Enhancements
nuxt: Support passing options to
useRequestURLnuxt: Introduce
imports.scanoptionnuxt: Add
<NuxtRouteAnnouncer>anduseRouteAnnouncerkit: Handle virtual files in
resolvePathandfindPathnuxt: Expose
useLinkfromNuxtLinkschema: V4 opt-in with
future.compatibilityVersionnuxt,schema: Inline error, welcome, spa-loading templates
nuxt: Configurable
app.rootAttrsandteleportAttrsschema: Enable
cookieStoreby defaultnuxt,schema: Support new Nuxt folder structure
nuxt: Treeshake
onUpdatedandonUnmountedon servernuxt: Prompt to install
nuxt/scriptson usagenuxt: Expose default slot from
<NuxtPage>nuxt: Custom
renderSSRHeadOptionsconfig forunheadnuxt: Add
onPrehydratelifecycle hooknuxt: Support multiple nuxtApps at runtime
nuxt: Add
#fallbackslot to server components typesnuxt: Allow specifying builder compatibility in modules
kit: Add
useRuntimeConfigandupdateRuntimeConfigutils- Removed
schema: Remove some experimental options for v4
nuxt: Auto-register layers in
layers/directorynuxt: Allow displaying error state in loading indicator
nuxt,schema: Add
appIdand improve chunk determinismnuxt: Check schema/kit versions when loading nuxt
schema: Add experimental
multiAppflagnuxt: Respect defaults when clearing asyncData
nuxt: Display banner when run with
compatibilityVersionnuxt: Add
URLserialiser for dev server logsnuxt: Handle nuxt route injection for
this.$routenuxt: Allow configuring interval for checking app update
nuxt: Warn when accessing private runtimeConfig on client
kit: Support typed module options in
installModulekit,schema: Add
.withfor better module options typesnuxt: Register plugin hooks before executing plugins
nuxt,schema: Add
compatibilityDateflag for future
Performance
nuxt: Don't add client fallback plugin if not enabled
nuxt: Unsubscribe from
asyncDatawatch when unmountednuxt: Remove state from nuxt island response
nuxt: Emit simpler functional ui templates (w/o lodash)
ui-templates: Don't emit message data for pure strings
nuxt: Remove
ssrContext.stylesreference (from unusedvue-style-loader)nuxt: Mark payload as
shallowReactivenuxt: Abort vue render when plugins throw error
vite: Exclude common ESM deps from pre-bundling
- Removed
kit,nuxt: Remove handling for node 14 perf api
nuxt: Deduplicate modules to install
webpack: Decrease iteration count and improve type safety
Fixes
nuxt: Prevent
getCachedDatafrom shaping type ofuseAsyncDatanuxt: Encode location header in navigateTo
nuxt: Correctly remove extension from path in
hasSuffixnuxt: Hint prerenderer to crawl routes at runtime
kit: Ignore negation when resolving ignore patterns
nuxt: Avoid double-slash in ignore pattern
kit: Set typescript
moduleDetectionto 'force'nuxt: Re-initialise
nuxt._ignoreafter all modules runnuxt: Assign
v-forto slot in islandsnuxt: Don't encode location header
nuxt: Check if
_scopeis active before callingrunfunction (#26756, #26904)nuxt: Don't scan component dirs when
enabledisfalsevite: Inline styles for vue components with
lang="ts"nuxt: Handle arrays correctly in
updateAppConfignuxt:
useStateinNuxtClientFallbacksetup functionnuxt: Compile plugin templates last
nuxt: Register redirect middleware before pushing route
nuxt,schema: Remove
.jsextension from template importsnuxt: Don't overwrite existing scope in
runWithContextschema: Use v3 folder structure if
app.vueexists inrootDirnuxt: Use resolved path for test component import
nuxt: Use
URLconstructor to resolve external protocolsnuxt: Use
URLfor parsing URLs rather thanparseURL- Deprecated
nuxt: Deprecate
process.*flags nuxt: Provide default url for URL constructor
nuxt: Preload links with same hostname
nuxt: Remove unused prop in
NuxtTeleportIslandComponentnuxt: Don't pass options to
spaLoadingTemplatefunctionnuxt: Scan folder indices for middleware
nuxt: Pass path to
jitiand not file URLschema: Hoist `@nuxt/devtools types for config auto-completion
nuxt: Correct components dir regexp
schema: Handle dev/test
buildIdin schemanuxt: Encode
locationheader innavigateTonuxt: Invert version check
nuxt: Exempt equality check for kit/schema version
nuxt: Use
undefinedrather thannullfor data fetching defaultsvite: Ignore query/hash when resolving public assets
nuxt: Clear timeout when asyncData request finishes/aborts
nuxt: Provide default data type values in nuxt/app dir
nuxt: Add module declarations for virtual files
nuxt: Respect
app.cdnURLfor extracted payloadsvite: Handle runtime paths in inlined styles
nuxt: Add
VNodereviver & don't deduplicate dev logsvite: Suppress warning about unresolved public assets
nuxt: Defer shared asyncData promises to next tick
nuxt: Resolve modules from layers directories
schema: Pass correct jsx config for esbuild-loader
nuxt: Transpile
app.configfiles in nitro buildnuxt: Use relative paths in
app.config.d.tsvite: Disable
optimizeDepsin ssrvite: Don't get available port when
hmr.serveris setnuxt: Mark nuxt/scripts stubs as lower priority
nuxt: Handle errors loading app manifest
schema: Exclude non-serialisable types from
appoptionsnuxt: Deduplicate
app.headarrayskit: Improve defaults in generated
tsconfig.jsonnuxt: Use
buildAssetsDirin island teleport dev chunkkit: Do not use
module: preserveunelss ts v5.4 is installednuxt: Ensure payload script executes before entry
kit: Avoid fallback to normalized path in module loading
nuxt: Also augment page metadata after
pages:extendhooknuxt: Resolve full path to app manifest stub page
nuxt: Resolve paths without file extensions
kit: Revert back to
esnexttargetkit,schema: Revert changes to module options types
nuxt: Remove
booleanvalue fordedupein v4 compatnuxt: Add parent
scopeIdto server componentsnuxt: Handle symbol keys in wrapped runtime config
nuxt: Register augmented pages to avoid re-augmenting
nuxt: Use file path as key for re-augmenting
Documentation
- Deprecated
Deprecate
pendingvalue in data fetching composables
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.