Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
This PR contains the following updates:
^3.11.2
->^3.12.2
Release Notes
nuxt/nuxt (nuxt)
v3.12.2
Compare Source
✅ Upgrading
As usual, our recommendation for upgrading is to run:
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
compare changes
🔥 Performance
🩹 Fixes
onNuxtReady
callback without arguments (#27428)app/
dir backwards compatibility (#27529)ssr: false
(#27542)runtimeConfig
key (9e56b60c6)#app/defaults
rather than augmenting (#27567)useRouteAnnouncer
(#27562)_installedModules
(e4bfea642)app.rootId
withapp.rootAttrs.id
(#27630)mergeProps
import in islands transform (#27622)vite.cacheDir
if defined (#27628)close
is called (#27637)/
even if pages module isn't enabled (dabcb5ecc)📖 Documentation
head
(#27575)clear()
function added in 3.11 (#27615)🏡 Chore
webpack-virtual-modules
(58dd7f3a6)✅ Tests
🤖 CI
❤️ Contributors
v3.12.1
Compare Source
👉 Changelog
compare changes
🩹 Fixes
@nuxt/scripts
(0252000d7)💅 Refactors
CompatibilityDateSpec
(#27521)📖 Documentation
🏡 Chore
nuxi
dependency (#27526)✅ Tests
❤️ Contributors
v3.12.0
Compare Source
👀 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: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 correspondinguseRouteAnnouncer
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 middlewareWe've also enabled
scanPageMeta
by default (#27134). This pulls out any page metadata in yourdefinePageMeta
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 settingmodule: '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:
installModule
(#26744)onPrehydrate
hook for hooking into the browser hydration cycle (#27037)useRuntimeConfig
andupdateRuntimeConfig
utils (#27117)🎨 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:
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
compare changes
🚀 Enhancements
useRequestURL
(#26687)imports.scan
option (#26576)<NuxtRouteAnnouncer>
anduseRouteAnnouncer
(#25741)resolvePath
andfindPath
(#26465)useLink
fromNuxtLink
(#26522)future.compatibilityVersion
(#26925)app.rootAttrs
andteleportAttrs
(#27014)cookieStore
by default (f597ca59a)onUpdated
andonUnmounted
on server (#27044)nuxt/scripts
on usage (#27010)<NuxtPage>
(#27050)renderSSRHeadOptions
config forunhead
(#26989)onPrehydrate
lifecycle hook (#27037)#fallback
slot to server components types (#27097)useRuntimeConfig
andupdateRuntimeConfig
utils (#27117)layers/
directory (#27221)appId
and improve chunk determinism (#27258)multiApp
flag (#27291)compatibilityVersion
(#27305)URL
serialiser for dev server logs (a549b46e9)this.$route
(#27313)installModule
(#26744).with
for better module options types (#26850)compatibilityDate
flag for future (#27512)🔥 Performance
asyncData
watch when unmounted (#26821)ssrContext.styles
reference (from unusedvue-style-loader
) (2d1ab61b2)shallowReactive
(#27214)🩹 Fixes
getCachedData
from shaping type ofuseAsyncData
(#25946)hasSuffix
(#26725)moduleDetection
to 'force' (#26667)nuxt._ignore
after all modules run (#26680)v-for
to slot in islands (#26880)_scope
is active before callingrun
function (#26756, #26904)enabled
isfalse
(#26906)lang="ts"
(#26912)updateAppConfig
(#26949)useState
inNuxtClientFallback
setup function (#26928).js
extension from template imports (0d4a622f3)runWithContext
(#26976)app.vue
exists inrootDir
(1af81ed0f)URL
constructor to resolve external protocols (5f0693a69)URL
for parsing URLs rather thanparseURL
(ea22d3f98)process.*
flags (#27089)NuxtTeleportIslandComponent
(#27093)spaLoadingTemplate
function (0e12b6eb8)jiti
and not file URL (#27252)buildId
in schema (#27274)location
header innavigateTo
(#27280)undefined
rather thannull
for data fetching defaults (#27294)app.cdnURL
for extracted payloads (#26668)VNode
reviver & don't deduplicate dev logs (#27309)app.config
files in nitro build (#27342)app.config.d.ts
(#27350)optimizeDeps
in ssr (#27356)hmr.server
is set (#27326)app
options (#27478)app.head
arrays (#27480)tsconfig.json
(#27485)buildAssetsDir
in island teleport dev chunk (#27469)module: preserve
unelss ts v5.4 is installed (b08dfc98b)pages:extend
hook (#27134)esnext
target (7bb02735e)boolean
value fordedupe
in v4 compat (#27511)scopeId
to server components (#27497)💅 Refactors
📖 Documentation
dependsOn
works not just for parallel plugins (#26707)--preset
flag fornuxi build
(#26759)useFetch
(#26748)callWithNuxt
(#26771)srcDir
description mentioning deprecatedstatic/
directory (#26804)pageRef
from a child page (#26806)pending
value in data fetching composables (#26766)@vue/test-utils
getting started guide (#26205)a
->an
(#26856)usePreviewMode
explanation (#26602)defineConfig
(a60de743a)@since
annotations to exported functions (#25365).eslintrc.js
toeslint.config.js
(#27020)future.compatibilityVersion
(e7789a257)nuxi init
(#27051)ignorePrefix
to clarify ignored files (#27065)app.config.ts
to nuxt 4 testing/migration (#27164)useFetch
recipe (#27208)nuxt/scripts
(#27229)<NuxtLink>
(#27284)baseURL
andcdnURL
(#27273)partitioned
attribute ofuseCookie
(#27297)error
hook type (61766702c)srcDir
in upgrade steps (3383a2df2)📦 Build
🏡 Chore
moduleResolution
toBundler
(#26658)@nuxt/eslint-config
(#26653)devcontainer.json
syntax (#26776)conventionalcommits.org
(9ba1ebe98)@nuxt/ui-templates
to core monorepo (fe6bdcc01)ui-templates
(15781c608)@internal
comment (cf736e274)eslint-plugin-regexp
(#27271)ui-templates
when stubbing packages (#27446)jiti
and@vitejs/plugin-vue
(2a2847e4b)shamefully-hoist
within repo (#27483)jiti
(#27479)✅ Tests
🤖 CI
ui-templates
as valid scope (5afd75b88)❤️ Contributors
Configuration
📅 Schedule: Branch creation - "before 11am on the first day of the month" in timezone Europe/Berlin, Automerge - At any time (no schedule defined).
🚦 Automerge: Disabled by config. Please merge this manually once you are satisfied.
♻ Rebasing: Whenever PR becomes conflicted, or you tick the rebase/retry checkbox.
🔕 Ignore: Close this PR and you won't be reminded about this update again.
This PR has been generated by Mend Renovate. View repository job log here.