nuxt
4.6.4 · 2 Nov 2026MIT3.6M / weekRepositoryHomepagenpmAtom feed
2.18.1 is the newest release of 2.x.
In short
5 breaking13 new28 fixed42 internal
- Breaking
Upgrade to PostCSS 8
- Breaking
In this PR we only support Node 14+. This is mostly an issue for dependencies, which we need to keep updated for security reasons. Going forward until its own EOL, Nuxt 2 will only officially support Node versions that have not reached their EOL.
- Breaking
Dependency upgrades. A number of dependencies have dropped support for earlier node versions.
dotenvhas changed how it parses.envfiles in a number of edge cases.globnow requires/instead of\on windows machines. There may also be other changes that affect your usage, so please do upgrade with care. - Breaking
Vue 2.7 upgrade. Although you can use Vue 2.7 with any release of Nuxt 2, 2.16.0 for the first time includes it as a dependency, which means that you may well encounter some issues associated with upgrading Vue 2.6 -> Vue 2.7.
- Breaking
webpack: ⚠️ Update postcss to v8
Security
3 advisories affect 2.16.0; 4.6.0 fixes them
- 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
Release note
Nuxt 2.16.0 is the first minor release since Feb 15, 2021. The focus is mostly on releasing the latest fixes and enhancements that have been present in
nuxt-edgefor some time.
Highlights
Upgrade to PostCSS 8
Default to
core-jsv3... full details below
Breaking changes
- Breaking
In this PR we only support Node 14+. This is mostly an issue for dependencies, which we need to keep updated for security reasons. Going forward until its own EOL, Nuxt 2 will only officially support Node versions that have not reached their EOL.
- Breaking
New postcss options format. See #9671 for full details.
- Breaking
Dependency upgrades. A number of dependencies have dropped support for earlier node versions.
dotenvhas changed how it parses.envfiles in a number of edge cases.globnow requires/instead of\on windows machines. There may also be other changes that affect your usage, so please do upgrade with care. - Breaking
Vue 2.7 upgrade. Although you can use Vue 2.7 with any release of Nuxt 2, 2.16.0 for the first time includes it as a dependency, which means that you may well encounter some issues associated with upgrading Vue 2.6 -> Vue 2.7.
This may be a good time to consider using the composition API utilities provided by github.com/nuxt/bridge instead, which mirror Nuxt 3's more precisely than
@nuxtjs/composition-api. (You can opt-in to just these utilities by disabling the other bridge modules individually.)
Changelog
Enhancements
config: Support
nuxtrcin dist directorygenerator: Add ignoreEnv generate option during ensureBuild(cmd)
server: Allow disabling
serve-staticmiddlewaretypes: Add
asyncDatareturn types to component instance typevue-app:
context.beforeSerializemethodvue-app: Pass
storetocreateRouterDefault to
core-jsversion 3webpack: ⚠️ Update postcss to v8
Fixes
vue-app: Respect
scroll-margin-topwhen navigating with hashwebpack: Use
javascript/autofor js ruleserver: Unregister error event listener
babel-preset-app: Respect explicit options.targets for modern preset
types: Add nuxt.config alias type
vue-app: Check whether route exists within nuxt app before replacing
vue-renderer: Decode route path for
payload.jsvue-app: Don't normalise route path if it's valid
vue-app: Redirect to external url replaces current history entry
utils:
trailingSlashcauses error with dynamic nuxt-child routestypes: Add
onNuxtLoadedandonNuxtReadytypesvue-app: Re-register components construtor in HMR
types: Add typing for
build.statsoptionsbabel: Loose option for babel private-property-in-object
vue-app: Serialize route meta to allow functions
vue-app:
nullcheck for$rootaccessgenerator: Allow passing
buildertogetGeneratorgenerator: Throw an error when Builder is missing
vue-app: Use correct
$configfor finding basePathvue-renderer: Ensure custom build indicator preserves some whitespace
'npm run test' fails because the last command lacks 'yarn'
generator: Decode path with
ufocli: Ensure nuxt instance is closed when skipping build
Nuxt-child-key in web-types.json
types: Return type of $fetch
deps: Update
ya-parser-jsto latest0.7.xvue-app: Call ssrContext.unsetMutationObserver only if it exists
webpack: Allow files with
.cjsextension to be transpiledvue-app: Preview mode fetch
webpack: Resolve
.wasmextension with lower priorityvue-app: Clear hide timeout when calling
clear()
Types
Add
prefetchPayloadsto router options
CI
Breaking Changes
- Breaking
webpack: ⚠️ Update postcss to v8
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.