---
name: Nuxt
slug: nuxt
type: github
source_url: https://github.com/nuxt/nuxt
organization: Nuxt
organization_slug: nuxt
total_releases: 99
latest_version: v4.4.8
latest_date: 2026-06-08
last_updated: 2026-06-25
tracking_since: 2023-04-28
canonical: https://releases.sh/nuxt/nuxt
organization_url: https://releases.sh/nuxt
---
> 4.4.8 is a hotfix release to address an issue running the dev server on MacOS.
## 👉 Changelog
[compare changes](https://github.com/nuxt/nuxt/compare/v4.4.7...v4.4.8)
### 🩹 Fixes
- **vite:** Shorter socket name for macOs with tmp fallback ([#35265](https://github.com/nuxt/nuxt/pull/35265))
- **kit:** Respect `type` option in `findPath` ([#35272](https://github.com/nuxt/nuxt/pull/35272))
- **deps:** Update nuxt/scripts presets ([905621594](https://github.com/nuxt/nuxt/commit/905621594))
- **nuxt:** Revert unhead dependency back to v2 ([e6d578fea](https://github.com/nuxt/nuxt/commit/e6d578fea))
### 📖 Documentation
- Fix many typos ([#35266](https://github.com/nuxt/nuxt/pull/35266))
- Explain static fallback pages ([#35277](https://github.com/nuxt/nuxt/pull/35277))
- Change `null` to `undefined` in data-fetching docs to match actual types ([#35301](https://github.com/nuxt/nuxt/pull/35301))
- Fix broken internal links, useAsyncData watch type, and NuxtError type ([#35303](https://github.com/nuxt/nuxt/pull/35303))
### ❤️ Contributors
- Daniel Roe (@danielroe)
- Ali Mahmmoud (@AliMahmoudDev)
- Quentin Macq (@quentinmcq)
- Pranav Rajeshirke (@Pranav188)
- Eduardo San Martin Morote (@posva)
> 3.21.8 is a hotfix release to address an issue running the dev server on MacOS.
## 👉 Changelog
[compare changes](https://github.com/nuxt/nuxt/compare/v3.21.7...v3.21.8)
### 🩹 Fixes
- **vite:** Shorter socket name for macOs with tmp fallback ([#35265](https://github.com/nuxt/nuxt/pull/35265))
- **kit:** Respect `type` option in `findPath` ([#35272](https://github.com/nuxt/nuxt/pull/35272))
- **deps:** Update nuxt/scripts presets ([ff6b060dd](https://github.com/nuxt/nuxt/commit/ff6b060dd))
### 📖 Documentation
- Change `null` to `undefined` in data-fetching docs to match actual types ([#35301](https://github.com/nuxt/nuxt/pull/35301))
### ❤️ Contributors
- Daniel Roe (@danielroe)
- Ali Mahmmoud (@AliMahmoudDev)
- Quentin Macq (@quentinmcq)
- Eduardo San Martin Morote (@posva)
> 4.4.7 is the a security hotfix release.
👉 make sure to check https://github.com/nuxt/nuxt/security/advisories to view open advisories resolved by this release.
## 👉 Changelog
[compare changes](https://github.com/nuxt/nuxt/compare/v4.4.6...v4.4.7)
### 🩹 Fixes
- **nitro:** Assign `noSSR` before deciding payload extraction ([#35108](https://github.com/nuxt/nuxt/pull/35108))
- **vite:** Avoid filtering out dirs with shared prefix from `allowDirs` ([#35112](https://github.com/nuxt/nuxt/pull/35112))
- **nuxt:** Use resolve from `pathe` for buildCache path boundary check ([#35111](https://github.com/nuxt/nuxt/pull/35111))
- **nuxt:** Prevent sibling-directory traversal in test component wrapper ([#35110](https://github.com/nuxt/nuxt/pull/35110))
- **nitro:** Pass event data to `isValid` in dev clipboard-copy listener ([#35109](https://github.com/nuxt/nuxt/pull/35109))
- **nuxt:** Validate protocols in `reloadNuxtApp` path before reload ([#35115](https://github.com/nuxt/nuxt/pull/35115))
- **vite:** Prefix public asset virtuals with null byte ([9e303b438](https://github.com/nuxt/nuxt/commit/9e303b438))
- **nuxt:** Re-run `getCachedData` after initial fetch ([#35122](https://github.com/nuxt/nuxt/pull/35122))
- **nuxt:** Propagate `useFetch`/`useAsyncData` factory types ([#35133](https://github.com/nuxt/nuxt/pull/35133))
- **vite:** Close vite dev server on nuxt close ([a10a68abc](https://github.com/nuxt/nuxt/commit/a10a68abc))
- **kit,nuxt:** Handle cancelling prompts to install packages ([e84813229](https://github.com/nuxt/nuxt/commit/e84813229))
- **kit:** Avoid excluding node-context files in legacy tsconfig ([#35152](https://github.com/nuxt/nuxt/pull/35152))
- **nuxt:** Handle missing payload in chunkError listener ([#35155](https://github.com/nuxt/nuxt/pull/35155))
- **nuxt:** Await in-lifght template generation when closing nuxt ([#35181](https://github.com/nuxt/nuxt/pull/35181))
- **nuxt:** Clarify page and layout usage warnings ([#35184](https://github.com/nuxt/nuxt/pull/35184))
- **webpack:** Surface compilation errors when stats.toString is empty ([073b07851](https://github.com/nuxt/nuxt/commit/073b07851))
- **nuxt:** Reject prototype-chain keys in the island registry ([#35205](https://github.com/nuxt/nuxt/pull/35205))
- **nuxt:** Apply `isScriptProtocol` guard to `navigateTo` open option ([#35206](https://github.com/nuxt/nuxt/pull/35206))
- **nuxt:** Prevent server-only page island from recursing via `` ([#35198](https://github.com/nuxt/nuxt/pull/35198))
- **rspack,webpack:** Require loopback host when missing same-origin signals ([#35200](https://github.com/nuxt/nuxt/pull/35200))
- **nitro:** Gate chrome devtools workspace endpoint to local requests ([#35201](https://github.com/nuxt/nuxt/pull/35201))
- **nuxt:** Escape props in `` ssr output ([#35199](https://github.com/nuxt/nuxt/pull/35199))
- **kit:** Improve TS extension stripping/substitutions ([#35233](https://github.com/nuxt/nuxt/pull/35233))
- **nuxt:** Preserve `.d.mts`/`.d.cts` in `resolveTypePaths` ([#35235](https://github.com/nuxt/nuxt/pull/35235))
- **nuxt:** Escape `
> 3.21.7 is the a security hotfix release.
👉 make sure to check https://github.com/nuxt/nuxt/security/advisories to view open advisories resolved by this release.
## 👉 Changelog
[compare changes](https://github.com/nuxt/nuxt/compare/v3.21.6...v3.21.7)
### 🩹 Fixes
- **nitro:** Assign `noSSR` before deciding payload extraction ([#35108](https://github.com/nuxt/nuxt/pull/35108))
- **vite:** Avoid filtering out dirs with shared prefix from `allowDirs` ([#35112](https://github.com/nuxt/nuxt/pull/35112))
- **nuxt:** Use resolve from `pathe` for buildCache path boundary check ([#35111](https://github.com/nuxt/nuxt/pull/35111))
- **nuxt:** Prevent sibling-directory traversal in test component wrapper ([#35110](https://github.com/nuxt/nuxt/pull/35110))
- **nitro:** Pass event data to `isValid` in dev clipboard-copy listener ([#35109](https://github.com/nuxt/nuxt/pull/35109))
- **nuxt:** Validate protocols in `reloadNuxtApp` path before reload ([#35115](https://github.com/nuxt/nuxt/pull/35115))
- **vite:** Resolve vite `clientServer` with `ssr: false` ([#34959](https://github.com/nuxt/nuxt/pull/34959))
- **vite:** Prefix public asset virtuals with null byte ([38d330179](https://github.com/nuxt/nuxt/commit/38d330179))
- **nuxt:** Handle missing payload in chunkError listener ([#35155](https://github.com/nuxt/nuxt/pull/35155))
- **vite:** Close vite dev server on nuxt close ([d007d7060](https://github.com/nuxt/nuxt/commit/d007d7060))
- **kit,nuxt:** Handle cancelling prompts to install packages ([59821a5ca](https://github.com/nuxt/nuxt/commit/59821a5ca))
- **nuxt:** Await in-lifght template generation when closing nuxt ([#35181](https://github.com/nuxt/nuxt/pull/35181))
- **webpack:** Surface compilation errors when stats.toString is empty ([71dccff2b](https://github.com/nuxt/nuxt/commit/71dccff2b))
- **kit:** Improve TS extension stripping/substitutions ([#35233](https://github.com/nuxt/nuxt/pull/35233))
- **nuxt:** Preserve `.d.mts`/`.d.cts` in `resolveTypePaths` ([#35235](https://github.com/nuxt/nuxt/pull/35235))
- **nuxt:** Reject prototype-chain keys in the island registry ([#35205](https://github.com/nuxt/nuxt/pull/35205))
- **nitro:** Gate chrome devtools workspace endpoint to local requests ([#35201](https://github.com/nuxt/nuxt/pull/35201))
- **nuxt:** Escape props in `` ssr output ([#35199](https://github.com/nuxt/nuxt/pull/35199))
- **nuxt:** Apply `isScriptProtocol` guard to `navigateTo` open option ([#35206](https://github.com/nuxt/nuxt/pull/35206))
- **rspack,webpack:** Require loopback host when missing same-origin signals ([#35200](https://github.com/nuxt/nuxt/pull/35200))
- **nuxt:** Absolutely resolve `defu` in app config template ([40bedf0db](https://github.com/nuxt/nuxt/commit/40bedf0db))
- **nuxt:** Match route rules case-insensitively to mirror `vue-router` ([3f3e3fa7b](https://github.com/nuxt/nuxt/commit/3f3e3fa7b))
- **nuxt:** Escape `
> 4.4.6 is the next patch release.
## 👉 Changelog
[compare changes](https://github.com/nuxt/nuxt/compare/v4.4.5...v4.4.6)
### 🩹 Fixes
- **vite:** Use spa entry for vite-node fallback ([#35037](https://github.com/nuxt/nuxt/pull/35037))
- **vite:** Invalidate SSR module cache when modules are invalidated via plugin hooks ([a86657a0e](https://github.com/nuxt/nuxt/commit/a86657a0e))
- **nuxt:** Match deduplicated `resolveComponent` calls in jsx blocks ([#35028](https://github.com/nuxt/nuxt/pull/35028))
- **nuxt:** Prefer our own builder/server deps ([#35029](https://github.com/nuxt/nuxt/pull/35029))
- **nuxt:** Update `useFetch` key even with `watch: false` ([#35002](https://github.com/nuxt/nuxt/pull/35002))
- **nitro:** Mark `@babel/plugin-syntax-typescript` as optional peer dep ([#35041](https://github.com/nuxt/nuxt/pull/35041))
- **nitro:** Add json extension to payload cache items ([#35043](https://github.com/nuxt/nuxt/pull/35043))
- **nuxt:** Handle errors fetching app manifest ([#35050](https://github.com/nuxt/nuxt/pull/35050))
- **nuxt:** Encode html-significant characters in external redirect body ([#35052](https://github.com/nuxt/nuxt/pull/35052))
- **nuxt:** Preserve `setPageLayout` props on same-path navigation ([#35055](https://github.com/nuxt/nuxt/pull/35055))
- **vite:** Don't strip buildAssetsDir from vite-node SSR ids ([#35040](https://github.com/nuxt/nuxt/pull/35040))
- **nuxt:** Mark `useLoadingIndicator` properties as readonly ([#35062](https://github.com/nuxt/nuxt/pull/35062))
- **vite:** Strip queries in css inline styles map ([#35067](https://github.com/nuxt/nuxt/pull/35067))
- **nitro:** Validate island request hash matches props ([#35077](https://github.com/nuxt/nuxt/pull/35077))
- **nitro:** Use regexp to strip query ([163e18d4b](https://github.com/nuxt/nuxt/commit/163e18d4b))
- **nitro:** Use `statusCode` for nitro v2 compatibility ([952f6841e](https://github.com/nuxt/nuxt/commit/952f6841e))
- **nitro-server:** Re-export h3 named symbols statically ([cd99001c8](https://github.com/nuxt/nuxt/commit/cd99001c8))
- **nuxt:** Render component-less parent routes during client-side nav ([#35036](https://github.com/nuxt/nuxt/pull/35036))
- **kit:** Respect `tsConfig.exclude` in legacy `tsconfig.json` ([#35079](https://github.com/nuxt/nuxt/pull/35079))
- **nuxt:** Run middleware for page islands ([#35092](https://github.com/nuxt/nuxt/pull/35092))
### 💅 Refactors
- **rspack,webpack:** Extract same-origin check for dev middleware ([#35051](https://github.com/nuxt/nuxt/pull/35051))
### 📖 Documentation
- Remove CSB, set node 22 and use steps for clarity ([#35066](https://github.com/nuxt/nuxt/pull/35066))
### 🏡 Chore
- One more type, one more ([50dcf15bb](https://github.com/nuxt/nuxt/commit/50dcf15bb))
- Remove unneeded (?) overrides ([6997093af](https://github.com/nuxt/nuxt/commit/6997093af))
- Use explicit versions for fixture dependencies ([294a734d4](https://github.com/nuxt/nuxt/commit/294a734d4))
- Ignore link-like syntax in code ([2584a549c](https://github.com/nuxt/nuxt/commit/2584a549c))
- Narrow engines.node in test ([5bb17fb47](https://github.com/nuxt/nuxt/commit/5bb17fb47))
- Remove unused import ([a52d78626](https://github.com/nuxt/nuxt/commit/a52d78626))
### ✅ Tests
- Relax relative time assertion ([c3dcd16f9](https://github.com/nuxt/nuxt/commit/c3dcd16f9))
- Add type ([732d844ad](https://github.com/nuxt/nuxt/commit/732d844ad))
- Drop h3 v2 types ([8286e5fcd](https://github.com/nuxt/nuxt/commit/8286e5fcd))
### 🤖 CI
- Clean up agent-scan workflow ([ab8317547](https://github.com/nuxt/nuxt/commit/ab8317547))
- Continue autofix workflow when `test:engines` fails ([3025e561e](https://github.com/nuxt/nuxt/commit/3025e561e))
- Improve workflows ([#35088](https://github.com/nuxt/nuxt/pull/35088))
### ❤️ Contributors
- Daniel Roe (@danielroe)
- Tim (@timhn-bm)
- Julien Huang (@huang-julien)
- Damian Głowala (@DamianGlowala)
- Sébastien Chopin (@atinux)
- Adrien Foulon (@Tofandel)
- Sami El Achi (@samiashi)
> 3.21.6 is the next patch release.
## 👉 Changelog
[compare changes](https://github.com/nuxt/nuxt/compare/v3.21.5...v3.21.6)
### 🩹 Fixes
- **nuxt:** Prefer our own builder/server deps ([#35029](https://github.com/nuxt/nuxt/pull/35029))
- **nitro:** Add json extension to payload cache items ([#35043](https://github.com/nuxt/nuxt/pull/35043))
- **nuxt:** Handle errors fetching app manifest ([#35050](https://github.com/nuxt/nuxt/pull/35050))
- **nuxt:** Preserve `setPageLayout` props on same-path navigation ([#35055](https://github.com/nuxt/nuxt/pull/35055))
- **vite:** Don't strip buildAssetsDir from vite-node SSR ids ([#35040](https://github.com/nuxt/nuxt/pull/35040))
- **nuxt:** Mark `useLoadingIndicator` properties as readonly ([#35062](https://github.com/nuxt/nuxt/pull/35062))
- **vite:** Strip queries in css inline styles map ([#35067](https://github.com/nuxt/nuxt/pull/35067))
- **nuxt:** Encode html-significant characters in external redirect body ([#35052](https://github.com/nuxt/nuxt/pull/35052))
- **nitro:** Validate island request hash matches props ([#35077](https://github.com/nuxt/nuxt/pull/35077))
- **nitro:** Use regexp to strip query ([042b615e6](https://github.com/nuxt/nuxt/commit/042b615e6))
- **nitro:** Use `statusCode` for nitro v2 compatibility ([82dcd6a31](https://github.com/nuxt/nuxt/commit/82dcd6a31))
- **nuxt:** Render component-less parent routes during client-side nav ([#35036](https://github.com/nuxt/nuxt/pull/35036))
- **nuxt:** Run middleware for page islands ([#35092](https://github.com/nuxt/nuxt/pull/35092))
### 💅 Refactors
- **rspack,webpack:** Extract same-origin check for dev middleware ([#35051](https://github.com/nuxt/nuxt/pull/35051))
### 📖 Documentation
- Remove CSB, set node 22 and use steps for clarity ([#35066](https://github.com/nuxt/nuxt/pull/35066))
### 🏡 Chore
- Ignore link-like syntax in code ([f9bf11b11](https://github.com/nuxt/nuxt/commit/f9bf11b11))
- Narrow engines.node in test ([5ed9a2691](https://github.com/nuxt/nuxt/commit/5ed9a2691))
- Remove unused import ([3a8bb0030](https://github.com/nuxt/nuxt/commit/3a8bb0030))
### ✅ Tests
- Relax relative time assertion ([256513eb0](https://github.com/nuxt/nuxt/commit/256513eb0))
- Move build assets dir fixture out of `app/` ([6d2ac69ff](https://github.com/nuxt/nuxt/commit/6d2ac69ff))
### 🤖 CI
- Clean up agent-scan workflow ([31590cf07](https://github.com/nuxt/nuxt/commit/31590cf07))
- Continue autofix workflow when `test:engines` fails ([958abb882](https://github.com/nuxt/nuxt/commit/958abb882))
- Improve workflows ([#35088](https://github.com/nuxt/nuxt/pull/35088))
### ❤️ Contributors
- Daniel Roe (@danielroe)
- Julien Huang (@huang-julien)
- Damian Głowala (@DamianGlowala)
- Sébastien Chopin (@atinux)
- Adrien Foulon (@Tofandel)
> 4.4.5 is the next patch release.
## 👉 Changelog
[compare changes](https://github.com/nuxt/nuxt/compare/v4.4.4...v4.4.5)
### 🔥 Performance
- **kit:** Cache layer roots and short-circuit `isIgnored` relative ([#35015](https://github.com/nuxt/nuxt/pull/35015))
### 🩹 Fixes
- **vite:** Resolve vite `clientServer` with `ssr: false` ([#34959](https://github.com/nuxt/nuxt/pull/34959))
- **nitro:** Correct payload route rule for `/` + override `ssr: true` ([#34990](https://github.com/nuxt/nuxt/pull/34990))
- **nitro:** Break recursive rendering deadlocks during prerender ([#34939](https://github.com/nuxt/nuxt/pull/34939))
- **vite:** Drop redundant css link when entry styles are inlined ([#34950](https://github.com/nuxt/nuxt/pull/34950))
- **vite:** Sort `optimizeDeps.include` in pre-bundle hint ([#34976](https://github.com/nuxt/nuxt/pull/34976))
- **nuxt:** Only force suspense remount after first resolve ([#34949](https://github.com/nuxt/nuxt/pull/34949))
- **kit:** Read `.env` before resolving nuxt schema ([#34958](https://github.com/nuxt/nuxt/pull/34958))
- **nitro:** Preserve `serverHandlers` array after `nitro:config` ([#34985](https://github.com/nuxt/nuxt/pull/34985))
- **nuxt:** Cast partial nitro handlers when prepending to server arrays ([61dcde4db](https://github.com/nuxt/nuxt/commit/61dcde4db))
- **vite:** Only consider CSS inlined when styles are actually emitted ([#35006](https://github.com/nuxt/nuxt/pull/35006))
- **nuxt:** Dedupe `getCachedData` for concurrent callers sharing a key ([#34999](https://github.com/nuxt/nuxt/pull/34999))
- **nuxt:** Respect factory fetch/baseURL options in server `useFetch` ([#35003](https://github.com/nuxt/nuxt/pull/35003))
- **nuxt:** Handle string presets in auto-imports ([#35013](https://github.com/nuxt/nuxt/pull/35013))
- **nuxt:** Correct island transform for server pages and 'deep' mode ([#35005](https://github.com/nuxt/nuxt/pull/35005))
- **vite:** Inline css for non-island children of server components ([#35001](https://github.com/nuxt/nuxt/pull/35001))
- **nuxt:** Defer head DOM updates until page transition finishes ([#35016](https://github.com/nuxt/nuxt/pull/35016))
- **nuxt:** Explicitly freeze head during island plugin phase ([#35010](https://github.com/nuxt/nuxt/pull/35010))
- **vite:** Inline css imported from non-vue js modules ([#35020](https://github.com/nuxt/nuxt/pull/35020))
### 📖 Documentation
- Add warning about routing in server components ([#34994](https://github.com/nuxt/nuxt/pull/34994))
### 🏡 Chore
- Fix lockfile ([c3ee07801](https://github.com/nuxt/nuxt/commit/c3ee07801))
- Pin `jiti` ([c8102228f](https://github.com/nuxt/nuxt/commit/c8102228f))
- Lint ([39422b6d2](https://github.com/nuxt/nuxt/commit/39422b6d2))
- Pin `@vue/compiler-sfc` ([cd404a14c](https://github.com/nuxt/nuxt/commit/cd404a14c))
- Ignore pnpm cyclic workspace deps warn ([#34998](https://github.com/nuxt/nuxt/pull/34998))
- Remove jiti from build steps ([#35004](https://github.com/nuxt/nuxt/pull/35004))
### ✅ Tests
- Extract server components fixture + add some failing tests ([#34995](https://github.com/nuxt/nuxt/pull/34995))
- Isolate `buildDir` per matrix project for shared fixtures ([#35007](https://github.com/nuxt/nuxt/pull/35007))
- Remove tests for 5.x runtimeBaseURL fature ([816c25487](https://github.com/nuxt/nuxt/commit/816c25487))
### ❤️ Contributors
- Daniel Roe (@danielroe)
- Harlan Wilton (@harlan-zw)
- Jonazzzz (@Bombastickj)
- Damian Głowala (@DamianGlowala)
- Florian Heuberger (@Flo0806)
> 3.21.5 is the next patch release.
## 👉 Changelog
[compare changes](https://github.com/nuxt/nuxt/compare/v3.21.4...v3.21.5)
### 🔥 Performance
- **kit:** Cache layer roots and short-circuit `isIgnored` relative ([#35015](https://github.com/nuxt/nuxt/pull/35015))
### 🩹 Fixes
- **nitro:** Correct payload route rule for `/` + override `ssr: true` ([#34990](https://github.com/nuxt/nuxt/pull/34990))
- **nitro:** Break recursive rendering deadlocks during prerender ([#34939](https://github.com/nuxt/nuxt/pull/34939))
- **vite:** Drop redundant css link when entry styles are inlined ([#34950](https://github.com/nuxt/nuxt/pull/34950))
- **nuxt:** Only force suspense remount after first resolve ([#34949](https://github.com/nuxt/nuxt/pull/34949))
- **kit:** Read `.env` before resolving nuxt schema ([#34958](https://github.com/nuxt/nuxt/pull/34958))
- **nitro:** Preserve `serverHandlers` array after `nitro:config` ([#34985](https://github.com/nuxt/nuxt/pull/34985))
- **vite:** Only consider CSS inlined when styles are actually emitted ([#35006](https://github.com/nuxt/nuxt/pull/35006))
- **nuxt:** Handle string presets in auto-imports ([#35013](https://github.com/nuxt/nuxt/pull/35013))
- **nuxt:** Correct island transform for server pages and 'deep' mode ([#35005](https://github.com/nuxt/nuxt/pull/35005))
- **vite:** Inline css for non-island children of server components ([#35001](https://github.com/nuxt/nuxt/pull/35001))
- **nuxt:** Defer head DOM updates until page transition finishes ([#35016](https://github.com/nuxt/nuxt/pull/35016))
- **nuxt:** Explicitly freeze head during island plugin phase ([#35010](https://github.com/nuxt/nuxt/pull/35010))
- **vite:** Inline css imported from non-vue js modules ([#35020](https://github.com/nuxt/nuxt/pull/35020))
- **nitro:** Remove unused middleware ([fe857d36b](https://github.com/nuxt/nuxt/commit/fe857d36b))
### 📖 Documentation
- Add warning about routing in server components ([#34994](https://github.com/nuxt/nuxt/pull/34994))
### 🏡 Chore
- Ignore pnpm cyclic workspace deps warn ([#34998](https://github.com/nuxt/nuxt/pull/34998))
- Remove jiti from build steps ([#35004](https://github.com/nuxt/nuxt/pull/35004))
- Fix lockfile ([48e56a509](https://github.com/nuxt/nuxt/commit/48e56a509))
- **nuxt:** Cast to nitro event handler type ([5b358ca19](https://github.com/nuxt/nuxt/commit/5b358ca19))
### ✅ Tests
- Extract server components fixture + add some failing tests ([#34995](https://github.com/nuxt/nuxt/pull/34995))
- Isolate `buildDir` per matrix project for shared fixtures ([#35007](https://github.com/nuxt/nuxt/pull/35007))
- Split env testing into separate file ([fd4019cf8](https://github.com/nuxt/nuxt/commit/fd4019cf8))
- Use 3.x style tsconfig ([86625efad](https://github.com/nuxt/nuxt/commit/86625efad))
- Use more 3.x style tsconfigs ([4a9bde3f3](https://github.com/nuxt/nuxt/commit/4a9bde3f3))
- Correct import path ([133d5f6d7](https://github.com/nuxt/nuxt/commit/133d5f6d7))
- Update snapshots ([9fc42f788](https://github.com/nuxt/nuxt/commit/9fc42f788))
### ❤️ Contributors
- Daniel Roe (@danielroe)
- Harlan Wilton (@harlan-zw)
- Jonazzzz (@Bombastickj)
- Damian Głowala (@DamianGlowala)
- Florian Heuberger (@Flo0806)
## v4.4.3/4.4.4
> 4.4.3 is the next patch release. v4.4.4 was published with no changes due to an issue running the release script for v4.4.3.
## 👉 Changelog
[compare changes](https://github.com/nuxt/nuxt/compare/v4.4.2...v4.4.3)
### 🔥 Performance
- **nitro:** Directly import nuxt package version ([#34567](https://github.com/nuxt/nuxt/pull/34567))
- **vite,webpack:** Use vfs for manifest + vite node server ([#34666](https://github.com/nuxt/nuxt/pull/34666))
- **nuxt:** Clean-up build hooks + emit gc'd snapshots ([#34587](https://github.com/nuxt/nuxt/pull/34587))
- **nuxt:** Skip key watcher when useAsyncData key is static ([#34620](https://github.com/nuxt/nuxt/pull/34620))
- **kit:** Parallelise module load + cache jiti instances ([#34842](https://github.com/nuxt/nuxt/pull/34842))
- **nuxt:** Batch-resolve typescript hoist paths with cached base roots ([#34862](https://github.com/nuxt/nuxt/pull/34862))
### 🩹 Fixes
- **nuxt:** Handle negative zero in getUserTrace slice boundary ([#34524](https://github.com/nuxt/nuxt/pull/34524))
- **nuxt:** Signal error state and clear timers in loading indicator cleanup ([#34523](https://github.com/nuxt/nuxt/pull/34523))
- **nuxt:** Fix broken hook cleanup in route announcer ([#34525](https://github.com/nuxt/nuxt/pull/34525))
- **nuxt:** Filter `clearNuxtState` key enumeration by useState prefix ([#34541](https://github.com/nuxt/nuxt/pull/34541))
- **nuxt:** Correct `useFetch` `cache` options type ([#34551](https://github.com/nuxt/nuxt/pull/34551))
- **nuxt:** Prevent in-flight requests from overwriting cleared async data ([#34553](https://github.com/nuxt/nuxt/pull/34553))
- **nuxt:** Check response status before parsing payload ([#34555](https://github.com/nuxt/nuxt/pull/34555))
- **nuxt:** Handle TS type assertions on member expression callees in keyed functions parser ([#34558](https://github.com/nuxt/nuxt/pull/34558))
- **nuxt:** Use comment as client component placeholder ([#33466](https://github.com/nuxt/nuxt/pull/33466))
- **nitro:** Resolve h3 export path in nitro vfs ([#34566](https://github.com/nuxt/nuxt/pull/34566))
- **nuxt:** Use factory resolved options everywhere in `useFetch` ([#34568](https://github.com/nuxt/nuxt/pull/34568))
- **nitro:** Use hash-based cache for dev payloads ([#34569](https://github.com/nuxt/nuxt/pull/34569))
- **nuxt:** Await parcel watcher subscription before registering close hook ([#34573](https://github.com/nuxt/nuxt/pull/34573))
- **nuxt:** Self-remove hydration error guards after first navigation ([#34572](https://github.com/nuxt/nuxt/pull/34572))
- **nuxt:** Mark portal properties as configurable ([#34574](https://github.com/nuxt/nuxt/pull/34574))
- **nuxt:** Retry manifest fetch after transient failure ([#34570](https://github.com/nuxt/nuxt/pull/34570))
- **kit:** Add PackagePreset type to addImportsSources ([#34582](https://github.com/nuxt/nuxt/pull/34582))
- **nuxt:** Avoid any return type from `callHookWith` in `vue:setup` ([#34584](https://github.com/nuxt/nuxt/pull/34584))
- **nuxt:** Strip DevOnly components with attributes in production builds ([#34585](https://github.com/nuxt/nuxt/pull/34585))
- **nuxt:** Move parcel watcher debug timer outside subscription loop ([#34590](https://github.com/nuxt/nuxt/pull/34590))
- **nuxt:** Preserve falsy prop values in `NuxtTime` data attribute serialization ([#34600](https://github.com/nuxt/nuxt/pull/34600))
- **nuxt:** Clear cached rejected promise in `callOnce` ([#34614](https://github.com/nuxt/nuxt/pull/34614))
- **nuxt:** Correct useAsyncData key type ([#34599](https://github.com/nuxt/nuxt/pull/34599))
- **nitro:** Set `__buildAssetsURL` before server entry import ([#34607](https://github.com/nuxt/nuxt/pull/34607))
- **nuxt:** Use consistent `[nuxt]` prefix in console warnings ([#34668](https://github.com/nuxt/nuxt/pull/34668))
- **vite:** Remove obsolete `writeDevServer` + handle vite-node precomputed ([f8e49b71b](https://github.com/nuxt/nuxt/commit/f8e49b71b))
- **nuxt:** Update impound protection for `nitro/*` ([ac9e25b8c](https://github.com/nuxt/nuxt/commit/ac9e25b8c))
- **nuxt,schema:** Allow disabling clearing build hooks ([#34594](https://github.com/nuxt/nuxt/pull/34594))
- **rspack,webpack:** Emit `styles.mjs` when inline styles off ([#34697](https://github.com/nuxt/nuxt/pull/34697))
- **nuxt:** Fix FormData body hashing in `useFetch` deduplication key ([#34546](https://github.com/nuxt/nuxt/pull/34546))
- **nuxt:** Generate type re-exports for shared type-only imports ([#34632](https://github.com/nuxt/nuxt/pull/34632))
- **nuxt,nitro:** Add `Symbol` serialization for dev server logs ([#34575](https://github.com/nuxt/nuxt/pull/34575))
- **vite:** Do not process css files with decorator transform ([#34769](https://github.com/nuxt/nuxt/pull/34769))
- **vite:** Ensure leading slash in `/@fs` URLs for Windows ([#34810](https://github.com/nuxt/nuxt/pull/34810))
- **vite:** Preserve server-origin errors and surface them via Youch ([#34820](https://github.com/nuxt/nuxt/pull/34820))
- **nitro:** Do not add import condition for ssr resolve conditions ([#34739](https://github.com/nuxt/nuxt/pull/34739))
- **nuxt:** Fix callOnce navigation mode alternating execution ([#34718](https://github.com/nuxt/nuxt/pull/34718))
- **schema,rspack,webpack:** Respect configured `test` option ([#34827](https://github.com/nuxt/nuxt/pull/34827))
- **nuxt:** Handle custom cookie serialisation before passing to `cookie-es` ([#34711](https://github.com/nuxt/nuxt/pull/34711))
- **nuxt:** Link to correct docs page for keyed functions ([#34854](https://github.com/nuxt/nuxt/pull/34854))
- **nuxt:** Adjust `setPageLayout` props type to allow passing arrays of objects ([#34860](https://github.com/nuxt/nuxt/pull/34860))
- **nuxt,schema:** Move config type to schema + mark type peerDeps ([#34864](https://github.com/nuxt/nuxt/pull/34864))
- **nitro:** Restore 'import' condition for ssr resolve ([af7a12725](https://github.com/nuxt/nuxt/commit/af7a12725))
- **nitro:** Re-encode `ssrContext.url` to match vue-router ([#34902](https://github.com/nuxt/nuxt/pull/34902))
- **schema:** Remove type peerDependencies ([#34894](https://github.com/nuxt/nuxt/pull/34894))
- **nuxt:** Propagate unexpected errors from `isDirectorySync` ([#34900](https://github.com/nuxt/nuxt/pull/34900))
- **nuxt:** Bridge `@nuxt/schema` augmentations into `nuxt/schema` ([#34905](https://github.com/nuxt/nuxt/pull/34905))
- **nuxt:** Sync `_route` when navigating up the route tree ([#34918](https://github.com/nuxt/nuxt/pull/34918))
- **nuxt:** Skip `` cached vnode when its suspense is unmounted ([#34899](https://github.com/nuxt/nuxt/pull/34899))
- **nitro:** Only recommend payload extraction when `ssr` is enabled ([#34924](https://github.com/nuxt/nuxt/pull/34924))
- **nitro:** Avoid double-decoding of url ([3f1a9524b](https://github.com/nuxt/nuxt/commit/3f1a9524b))
- **nuxt:** Flatten buffer before filtering promises and fix rendering of content ([#34863](https://github.com/nuxt/nuxt/pull/34863))
- **nuxt:** Correct async data type inference when using `transform` with `getCachedData` ([#34819](https://github.com/nuxt/nuxt/pull/34819))
- **nuxt:** Avoid transforming `NuxtTeleportIslandComponent` with nuxt-client directive ([#34817](https://github.com/nuxt/nuxt/pull/34817))
- **nuxt:** Resolve layer aliases in css files ([#34940](https://github.com/nuxt/nuxt/pull/34940))
- **nuxt:** Invoke user-supplied error handler when suppressing render errors ([#34938](https://github.com/nuxt/nuxt/pull/34938))
### 📖 Documentation
- Add v4.4 badge for layout props ([#34528](https://github.com/nuxt/nuxt/pull/34528))
- Document that component props are sent in query string ([619de0dd5](https://github.com/nuxt/nuxt/commit/619de0dd5))
- Clarify function signature requirement for custom `$fetch` in `createUseFetch` ([#34564](https://github.com/nuxt/nuxt/pull/34564))
- Update experimental typedPages documentation ([#34580](https://github.com/nuxt/nuxt/pull/34580))
- Fix page:loading:start description to match implementation ([#34617](https://github.com/nuxt/nuxt/pull/34617))
- Add missing jsdoc strings ([ccb53e0eb](https://github.com/nuxt/nuxt/commit/ccb53e0eb))
- Add example for route middleware setup ([#34661](https://github.com/nuxt/nuxt/pull/34661))
- Use new object boolean syntax when prefetchOn interaction ([#34825](https://github.com/nuxt/nuxt/pull/34825))
- Remove @nuxt/scripts from core modules roadmap ([#34835](https://github.com/nuxt/nuxt/pull/34835))
- Remove @nuxt/hints from core modules roadmap ([#34867](https://github.com/nuxt/nuxt/pull/34867))
- Correct URL ([#34907](https://github.com/nuxt/nuxt/pull/34907))
- Set `NODE_ENV` to `production` in deployment examples ([#34937](https://github.com/nuxt/nuxt/pull/34937))
### 🏡 Chore
- Do not ship `devDependencies` when publishing ([8018d6577](https://github.com/nuxt/nuxt/commit/8018d6577))
- Remove unused field 🤦 ([2a75ac774](https://github.com/nuxt/nuxt/commit/2a75ac774))
- Remove explicit copilot instructions ([c7237f22c](https://github.com/nuxt/nuxt/commit/c7237f22c))
- Use single renovate PR for `3.x` and `4.x` branches ([1dda87b84](https://github.com/nuxt/nuxt/commit/1dda87b84))
- Use top level `vulnerabilityAlerts` config ([39999b7b6](https://github.com/nuxt/nuxt/commit/39999b7b6))
- Dedupe security update prs after update ([4734db95c](https://github.com/nuxt/nuxt/commit/4734db95c))
- Throttle per host to reduce rate limits in link checking ([#34488](https://github.com/nuxt/nuxt/pull/34488))
- Update renovate config ([214a72bcf](https://github.com/nuxt/nuxt/commit/214a72bcf))
- Drop redundant `as const` ([#34909](https://github.com/nuxt/nuxt/pull/34909))
- Migrate resolutions to `pnpm-workspace.yaml` ([4a39b1bfa](https://github.com/nuxt/nuxt/commit/4a39b1bfa))
### ✅ Tests
- Use `toThrow` instead of `toThrowError` ([3d3d8164d](https://github.com/nuxt/nuxt/commit/3d3d8164d))
- Update bundle size ([e4b31efa4](https://github.com/nuxt/nuxt/commit/e4b31efa4))
- Reduce matrices in ci ([#34703](https://github.com/nuxt/nuxt/pull/34703))
- Add scroll behavior tests for fixed page key with scrollToTop ([#34761](https://github.com/nuxt/nuxt/pull/34761))
- Update deprecated error assertions ([a7a301095](https://github.com/nuxt/nuxt/commit/a7a301095))
### 🤖 CI
- Add bot workflow ([#34677](https://github.com/nuxt/nuxt/pull/34677))
- Fix bot label ([967eca84b](https://github.com/nuxt/nuxt/commit/967eca84b))
- Add agent-scan workflow ([#34681](https://github.com/nuxt/nuxt/pull/34681))
- Correct renovate bot name in workflow ([#34708](https://github.com/nuxt/nuxt/pull/34708))
- Correct dependabot bot name in workflow ([#34709](https://github.com/nuxt/nuxt/pull/34709))
- Drop stackblitz link issue commenter ([1e9cacacb](https://github.com/nuxt/nuxt/commit/1e9cacacb))
- Inline actions triggered by labels into triage actions ([ee5acd096](https://github.com/nuxt/nuxt/commit/ee5acd096))
- Update workflows to use renamed type labels ([#34933](https://github.com/nuxt/nuxt/pull/34933))
### ❤️ Contributors
- Daniel Roe (@danielroe)
- Sébastien Chopin (@atinux)
- Damian Głowala (@DamianGlowala)
- John (@zecar)
- Eduardo San Martin Morote (@posva)
- abeer0 (@iiio2)
- Florian Heuberger (@Flo0806)
- karl (@krlctrl)
- Idris Gadi (@IdrisGit)
- Ori (@oritwoen)
- Yoshihiro Yamaguchi (@yamachi4416)
- Kilisei (@kilisei)
- Anthony Fu (@antfu)
- edepauw (@edepauw)
- Bochkarev Ivan (@Ibochkarev)
- Matej Černý (@cernymatej)
- Matteo Gabriele (@MatteoGabriele)
- Julien Huang (@huang-julien)
- Oliver Schmidt (@Timbuktu1982)
- Om Mishra (@howwohmm)
- xjccc (@xjccc)
- mcrapts (@mcrapts)
- Louis Ramos (@wJoenn)
- 山吹色御守 (@KazariEX)
- Max (@onmax)
## v3.21.3/3.21.4
> 3.21.3 is the next patch release. v3.21.4 was published with no changes due to an issue running the release script for v3.21.3.
## 👉 Changelog
[compare changes](https://github.com/nuxt/nuxt/compare/v3.21.2...v3.21.3)
### 🔥 Performance
- **nuxt:** Batch-resolve typescript hoist paths with cached base roots ([#34862](https://github.com/nuxt/nuxt/pull/34862))
- **vite,webpack:** Use vfs for manifest + vite node server ([#34666](https://github.com/nuxt/nuxt/pull/34666))
### 🩹 Fixes
- **nuxt:** Handle negative zero in getUserTrace slice boundary ([#34524](https://github.com/nuxt/nuxt/pull/34524))
- **nuxt:** Signal error state and clear timers in loading indicator cleanup ([#34523](https://github.com/nuxt/nuxt/pull/34523))
- **nuxt:** Fix broken hook cleanup in route announcer ([#34525](https://github.com/nuxt/nuxt/pull/34525))
- **nuxt:** Filter `clearNuxtState` key enumeration by useState prefix ([#34541](https://github.com/nuxt/nuxt/pull/34541))
- **nuxt:** Correct `useFetch` `cache` options type ([#34551](https://github.com/nuxt/nuxt/pull/34551))
- **nuxt:** Prevent in-flight requests from overwriting cleared async data ([#34553](https://github.com/nuxt/nuxt/pull/34553))
- **nuxt:** Check response status before parsing payload ([#34555](https://github.com/nuxt/nuxt/pull/34555))
- **nuxt:** Handle TS type assertions on member expression callees in keyed functions parser ([#34558](https://github.com/nuxt/nuxt/pull/34558))
- **nitro:** Resolve h3 export path in nitro vfs ([#34566](https://github.com/nuxt/nuxt/pull/34566))
- **nitro:** Use hash-based cache for dev payloads ([#34569](https://github.com/nuxt/nuxt/pull/34569))
- **nuxt:** Await parcel watcher subscription before registering close hook ([#34573](https://github.com/nuxt/nuxt/pull/34573))
- **nuxt:** Self-remove hydration error guards after first navigation ([#34572](https://github.com/nuxt/nuxt/pull/34572))
- **nuxt:** Mark portal properties as configurable ([#34574](https://github.com/nuxt/nuxt/pull/34574))
- **nuxt:** Retry manifest fetch after transient failure ([#34570](https://github.com/nuxt/nuxt/pull/34570))
- **kit:** Add PackagePreset type to addImportsSources ([#34582](https://github.com/nuxt/nuxt/pull/34582))
- **nuxt:** Avoid any return type from `callHookWith` in `vue:setup` ([#34584](https://github.com/nuxt/nuxt/pull/34584))
- **nuxt:** Strip DevOnly components with attributes in production builds ([#34585](https://github.com/nuxt/nuxt/pull/34585))
- **nuxt:** Move parcel watcher debug timer outside subscription loop ([#34590](https://github.com/nuxt/nuxt/pull/34590))
- **nuxt:** Preserve falsy prop values in `NuxtTime` data attribute serialization ([#34600](https://github.com/nuxt/nuxt/pull/34600))
- **nuxt:** Clear cached rejected promise in `callOnce` ([#34614](https://github.com/nuxt/nuxt/pull/34614))
- **nitro:** Set `__buildAssetsURL` before server entry import ([#34607](https://github.com/nuxt/nuxt/pull/34607))
- **nuxt:** Use consistent `[nuxt]` prefix in console warnings ([#34668](https://github.com/nuxt/nuxt/pull/34668))
- **nitro:** Do not add import condition for ssr resolve conditions ([#34739](https://github.com/nuxt/nuxt/pull/34739))
- **rspack,webpack:** Emit `styles.mjs` when inline styles off ([#34697](https://github.com/nuxt/nuxt/pull/34697))
- **nuxt:** Fix FormData body hashing in `useFetch` deduplication key ([#34546](https://github.com/nuxt/nuxt/pull/34546))
- **nuxt,nitro:** Add `Symbol` serialization for dev server logs ([#34575](https://github.com/nuxt/nuxt/pull/34575))
- **vite:** Ensure leading slash in `/@fs` URLs for Windows ([#34810](https://github.com/nuxt/nuxt/pull/34810))
- **vite:** Preserve server-origin errors and surface them via Youch ([#34820](https://github.com/nuxt/nuxt/pull/34820))
- **nuxt:** Fix callOnce navigation mode alternating execution ([#34718](https://github.com/nuxt/nuxt/pull/34718))
- **schema,rspack,webpack:** Respect configured `test` option ([#34827](https://github.com/nuxt/nuxt/pull/34827))
- **nitro:** Restore 'import' condition for ssr resolve ([247254652](https://github.com/nuxt/nuxt/commit/247254652))
- **nuxt:** Propagate unexpected errors from `isDirectorySync` ([#34900](https://github.com/nuxt/nuxt/pull/34900))
- **nitro:** Re-encode `ssrContext.url` to match vue-router ([#34902](https://github.com/nuxt/nuxt/pull/34902))
- **vite:** Remove obsolete `writeDevServer` + handle vite-node precomputed ([c45b45b9c](https://github.com/nuxt/nuxt/commit/c45b45b9c))
- **nitro:** Avoid double-decoding of url ([93e731ba3](https://github.com/nuxt/nuxt/commit/93e731ba3))
- **nuxt:** Sync `_route` when navigating up the route tree ([#34918](https://github.com/nuxt/nuxt/pull/34918))
- **nuxt:** Skip `` cached vnode when its suspense is unmounted ([#34899](https://github.com/nuxt/nuxt/pull/34899))
- **nitro:** Only recommend payload extraction when `ssr` is enabled ([#34924](https://github.com/nuxt/nuxt/pull/34924))
- **nuxt:** Flatten buffer before filtering promises and fix rendering of content ([#34863](https://github.com/nuxt/nuxt/pull/34863))
- **nuxt:** Avoid transforming `NuxtTeleportIslandComponent` with nuxt-client directive ([#34817](https://github.com/nuxt/nuxt/pull/34817))
- **nuxt:** Resolve layer aliases in css files ([#34940](https://github.com/nuxt/nuxt/pull/34940))
- **nuxt:** Invoke user-supplied error handler when suppressing render errors ([#34938](https://github.com/nuxt/nuxt/pull/34938))
### 📖 Documentation
- Document that component props are sent in query string ([1bf4fa87c](https://github.com/nuxt/nuxt/commit/1bf4fa87c))
- Fix page:loading:start description to match implementation ([#34617](https://github.com/nuxt/nuxt/pull/34617))
- Add missing jsdoc strings ([30a9a49aa](https://github.com/nuxt/nuxt/commit/30a9a49aa))
- Work around upstream bun bug ([#34792](https://github.com/nuxt/nuxt/pull/34792))
- Use new object boolean syntax when prefetchOn interaction ([#34825](https://github.com/nuxt/nuxt/pull/34825))
- Remove @nuxt/scripts from core modules roadmap ([#34835](https://github.com/nuxt/nuxt/pull/34835))
- Remove @nuxt/hints from core modules roadmap ([#34867](https://github.com/nuxt/nuxt/pull/34867))
- Correct URL ([#34907](https://github.com/nuxt/nuxt/pull/34907))
- Set `NODE_ENV` to `production` in deployment examples ([#34937](https://github.com/nuxt/nuxt/pull/34937))
### 🏡 Chore
- Do not ship `devDependencies` when publishing ([07f05c1a2](https://github.com/nuxt/nuxt/commit/07f05c1a2))
- Remove unused field 🤦 ([5644951b5](https://github.com/nuxt/nuxt/commit/5644951b5))
- Remove explicit copilot instructions ([240721d38](https://github.com/nuxt/nuxt/commit/240721d38))
- Use single renovate PR for `3.x` and `4.x` branches ([8193a6025](https://github.com/nuxt/nuxt/commit/8193a6025))
- Use top level `vulnerabilityAlerts` config ([1975bf748](https://github.com/nuxt/nuxt/commit/1975bf748))
- Dedupe security update prs after update ([df17b0aec](https://github.com/nuxt/nuxt/commit/df17b0aec))
- Throttle per host to reduce rate limits in link checking ([#34488](https://github.com/nuxt/nuxt/pull/34488))
- Drop redundant `as const` ([#34909](https://github.com/nuxt/nuxt/pull/34909))
- Pin typescript ([e94ed7ac5](https://github.com/nuxt/nuxt/commit/e94ed7ac5))
### ✅ Tests
- Use `toThrow` instead of `toThrowError` ([60d5c8d21](https://github.com/nuxt/nuxt/commit/60d5c8d21))
- Reduce matrices in ci ([#34704](https://github.com/nuxt/nuxt/pull/34704))
- Add scroll behavior tests for fixed page key with scrollToTop ([#34761](https://github.com/nuxt/nuxt/pull/34761))
- Update deprecated error assertions ([9ba7ca7b6](https://github.com/nuxt/nuxt/commit/9ba7ca7b6))
### 🤖 CI
- Ensure `latest` tag is published first + manual oidc exchange for dist-tag ([7339257f8](https://github.com/nuxt/nuxt/commit/7339257f8))
- Add bot workflow ([#34677](https://github.com/nuxt/nuxt/pull/34677))
- Fix bot label ([a222917b2](https://github.com/nuxt/nuxt/commit/a222917b2))
- Don't run ossf workflow on `4.x` branch ([c183f341b](https://github.com/nuxt/nuxt/commit/c183f341b))
- Add agent-scan workflow ([#34681](https://github.com/nuxt/nuxt/pull/34681))
- Correct renovate bot name in workflow ([#34708](https://github.com/nuxt/nuxt/pull/34708))
- Correct dependabot bot name in workflow ([#34709](https://github.com/nuxt/nuxt/pull/34709))
- Drop stackblitz link issue commenter ([884ab3757](https://github.com/nuxt/nuxt/commit/884ab3757))
- Inline actions triggered by labels into triage actions ([124f65c5f](https://github.com/nuxt/nuxt/commit/124f65c5f))
- Update workflows to use renamed type labels ([#34933](https://github.com/nuxt/nuxt/pull/34933))
### ❤️ Contributors
- Daniel Roe (@danielroe)
- Sébastien Chopin (@atinux)
- John (@zecar)
- Eduardo San Martin Morote (@posva)
- Florian Heuberger (@Flo0806)
- abeer0 (@iiio2)
- karl (@krlctrl)
- Ori (@oritwoen)
- Kilisei (@kilisei)
- Anthony Fu (@antfu)
- Matej Černý (@cernymatej)
- Bochkarev Ivan (@Ibochkarev)
- Matteo Gabriele (@MatteoGabriele)
- Julien Huang (@huang-julien)
- Yoshihiro Yamaguchi (@yamachi4416)
- antlis (@antlis)
- Om Mishra (@howwohmm)
- Louis Ramos (@wJoenn)
- xjccc (@xjccc)
## v4.4.0/v4.4.2
> 4.4.0/4.4.2 is the next minor release (v4.4.2 was published with no changes due to a publishing failure)
## 👀 Highlights
### 🏭 `createUseFetch` and `createUseAsyncData`
You can now create **custom instances** of `useFetch` and `useAsyncData` with your own default options ([#32300](https://github.com/nuxt/nuxt/pull/32300)).
```ts
// composables/api.ts
// Simple defaults
export const useClientFetch = createUseFetch({
server: false,
})
// Dynamic defaults with full control over merging
export const useApiFetch = createUseFetch((currentOptions) => {
const runtimeConfig = useRuntimeConfig()
return {
...currentOptions,
baseURL: currentOptions.baseURL ?? runtimeConfig.public.baseApiUrl,
}
})
```
Then use them exactly like `useFetch` – they're fully typed and support all the same options:
```vue
```
When you pass a plain object, your usage options automatically override the defaults. When you pass a function, you get full control over how options are merged – which means you can compose interceptors, headers, and other complex options however you need.
Under the hood, this is powered by a new Nuxt ad-hoc module that scans your composables directory and automatically registers your custom instances for key injection – so they work seamlessly with SSR, just like `useAsyncData` and `useFetch`.
There's also `createUseAsyncData` for the same pattern with `useAsyncData`.
> 📖 [Read more: `createUseAsyncData`](https://nuxt.com/docs/api/composables/create-use-async-data)
### 🗺️ Vue Router v5
We've upgraded to [vue-router v5](https://github.com/vuejs/router) ([#34181](https://github.com/nuxt/nuxt/pull/34181)), which removes the dependency on `unplugin-vue-router`. This is the first major vue-router upgrade since Nuxt 3, and it comes with a bunch of improvements under the hood.
For most apps, this should be a transparent upgrade. If you're using `unplugin-vue-router` directly, you can remove it from your dependencies.
The next step will be taking typed routes out of experimental status. 👀
### 💪 Typed Layout Props in `definePageMeta`
You can now pass props to your layouts directly from `definePageMeta` ([#34262](https://github.com/nuxt/nuxt/pull/34262)). This means your layouts can be parameterised per-page without needing to use `provide`/`inject` or other workarounds. Check out the [updated docs](https://nuxt.com/docs/guide/directory-structure/layouts#layout-props) for the full details.
```ts
// pages/dashboard.vue
definePageMeta({
layout: {
name: 'panel',
props: {
sidebar: true,
title: 'Dashboard',
},
},
})
```
Even better – the props are **fully typed** ([#34409](https://github.com/nuxt/nuxt/pull/34409)). If your layout defines props, you'll get autocomplete and type-checking in `definePageMeta`.
```vue
```
> 📖 [Read more: Layouts](https://nuxt.com/docs/guide/directory-structure/layouts)
### 🗣️ `useAnnouncer` Composable
Accessibility got a major boost with the new `useAnnouncer` composable and `` component ([#34318](https://github.com/nuxt/nuxt/pull/34318)). While `useRouteAnnouncer` handles page navigation for screen readers, many apps need to announce **dynamic in-page changes** – form submissions, loading states, search results, and more.
```vue
```
```vue
```
> **Note:** This is part of our [accessibility roadmap](https://github.com/nuxt/nuxt/issues/23255). You don't need to use it everywhere – for many interactions, moving focus to new content or using native form validation is sufficient. `useAnnouncer` is most useful when content changes dynamically without a corresponding focus change.
> 📖 [Read more: `useAnnouncer`](https://nuxt.com/docs/api/composables/use-announcer)
### 🚀 Migrate to `unrouting`
We've migrated Nuxt's file-system route generation to [`unrouting`](https://github.com/unjs/unrouting) ([#34316](https://github.com/nuxt/nuxt/pull/34316)), which uses a trie data structure for constructing routes. The cold start is roughly the same (~8ms vs ~6ms for large apps), but dev server changes are **up to 28x faster** when you're not adding/removing pages, and ~15% faster even when you are.
This also makes route generation more deterministic – it's no longer sensitive to page file ordering.
### 🍫 Smarter Payload Handling for Cached Routes
When a cached route (ISR/SWR) is rendered at runtime with payload extraction enabled, the browser immediately fetches `_payload.json` as a second request – which triggers a full SSR re-render of the same page. In serverless environments, this can spin up a second lambda before the first response has even finished streaming.
This release addresses this with two changes ([#34410](https://github.com/nuxt/nuxt/pull/34410)):
1. A new `payloadExtraction: 'client'` mode that inlines the full payload in the initial HTML response while still generating `_payload.json` for client-side navigation
2. A runtime in-memory LRU payload cache so that `_payload.json` requests can be served without a full re-render
```ts
// nuxt.config.ts
export default defineNuxtConfig({
experimental: {
payloadExtraction: 'client',
},
})
```
> **Note:** `payloadExtraction: 'client'` will become the default with `compatibilityVersion: 5`. The runtime cache is active for all users.
> 📖 [Read more: Experimental `payloadExtraction`](https://nuxt.com/docs/guide/going-further/experimental-features#payloadextraction)
### 🍪 `refresh` Option for `useCookie`
If you're using cookies for session management, you've probably run into the problem of needing to extend a cookie's expiration without changing its value. The new `refresh` option makes this simple ([#33814](https://github.com/nuxt/nuxt/pull/33814)):
```ts
const session = useCookie('session-id', {
maxAge: 60 * 60,
refresh: true,
})
// Extends expiration each time, even with the same value
session.value = session.value
```
> 📖 [Read more: `useCookie`](https://nuxt.com/docs/api/composables/use-cookie)
### ♻️ `useState` Reset to Default
`useState` and `clearNuxtState` now support resetting to the initial value instead of clearing to `undefined` ([#33527](https://github.com/nuxt/nuxt/pull/33527)). This aligns with how `useAsyncData` handles resets and is more intuitive for state management.
```ts
const count = useState('counter', () => 0)
count.value = 42
// Resets to 0 (the init value), not undefined
clearNuxtState('counter')
```
> 📖 [Read more: `clearNuxtState`](https://nuxt.com/docs/api/utils/clear-nuxt-state)
### 🕵️♂️ Better Import Protection
Inspired by features in [TanStack Start](https://tanstack.com/start/latest/docs/framework/react/guide/import-protection), import protection now shows **suggestions** and a full **trace** of where a problematic import originated ([#34454](https://github.com/nuxt/nuxt/pull/34454)). This makes it much easier to debug why a server-only import ended up in your client bundle.
For example, if you accidentally import from a server route in a component:
The trace shows the import chain (the component was imported from a page), the exact line of code, and actionable suggestions for how to fix it.
We plan to continue work on improving our error messages. 🪵
### 🔮 View Transitions Types
You can now define [view transition types](https://developer.chrome.com/blog/view-transitions-update-io24#view-transition-types) in Nuxt's experimental view transitions support ([#31982](https://github.com/nuxt/nuxt/pull/31982)). This lets you use different transition styles for different navigation patterns (forwards vs. backwards, tabs vs. pages, etc.).
> 📖 [Read more: View Transitions API](https://nuxt.com/docs/getting-started/transitions#view-transitions-api-experimental)
### 💡 Improved `optimizeDeps` Hints
When Vite discovers new dependencies at runtime and triggers page reloads, Nuxt now shows a clear, copy-pasteable `nuxt.config.ts` snippet to pre-bundle them ([#34320](https://github.com/nuxt/nuxt/pull/34320)). It also warns about unresolvable entries at startup.
### 🏷️ Normalised Page Component Names (Experimental)
A new experimental option normalises page component names to match route names ([#33513](https://github.com/nuxt/nuxt/pull/33513)), which can help with consistency in devtools and debugging.
```ts
// nuxt.config.ts
export default defineNuxtConfig({
experimental: {
normalizeComponentNames: true,
},
})
```
> 📖 [Read more: `normalizeComponentNames`](https://nuxt.com/docs/guide/going-further/experimental-features#normalizecomponentnames)
### ⚡ Build Profiling
Ever wondered where your build time goes? You can now get a detailed performance breakdown of your Nuxt builds ([#34468](https://github.com/nuxt/nuxt/pull/34468), [nuxt/cli#1243](https://github.com/nuxt/cli/pull/1243)):
```bash
nuxt build --profile
```
This produces a report showing duration, RSS delta, and heap delta for every build phase, module, and bundler plugin:
It also profiles individual modules and bundler plugins, making it easy to spot bottlenecks. Three output formats are written:
- **Chrome Trace** (`.nuxt/perf-trace.json`) – open in `chrome://tracing` or Perfetto for a visual timeline
- **JSON report** (`.nuxt/perf-report.json`) – machine-readable data for tracking over time
- **CPU profile** (`nuxt-build.cpuprofile`) – open in Chrome DevTools or VS Code for flame graphs
For even more detail, use `--profile=verbose` to print timing breakdowns to the console.
> 📖 [Read more: `nuxt build`](https://nuxt.com/docs/api/commands/build)
We'll be using this feature to make Nuxt even faster – and if performance is something you care about, this might be a good opportunity to contribute!
### 🔥 Performance Improvements
- **14,000x faster module ID parsing** – replaced `new URL()` + regex chain with a single `indexOf` + slice ([#34451](https://github.com/nuxt/nuxt/pull/34451))
- **Disabled NuxtLink visibility prefetching in dev** – stops Vite from discovering and reloading deps unnecessarily during development ([#34325](https://github.com/nuxt/nuxt/pull/34325))
## ✅ Upgrading
Our recommendation for upgrading is to run:
```sh
npx nuxt upgrade --dedupe
```
This will deduplicate your lockfile and help ensure you pull in updates from other dependencies that Nuxt relies on, particularly in the unjs ecosystem.
> **Tip:** Check out our [upgrade guide](https://nuxt.com/docs/getting-started/upgrade) if upgrading from an older version.
## 👉 Changelog
[compare changes](https://github.com/nuxt/nuxt/compare/v4.3.1...v4.4.0)
### 🚀 Enhancements
- **nuxt:** Migrate to unrouting for nuxt file system -> route generation ([#34316](https://github.com/nuxt/nuxt/pull/34316))
- **nuxt:** Allow setting layout props in `definePageMeta` ([#34262](https://github.com/nuxt/nuxt/pull/34262))
- **nuxt:** Upgrade to vue-router v5 ([#34181](https://github.com/nuxt/nuxt/pull/34181))
- **nuxt:** Add `useAnnouncer` composable and `` component ([#34318](https://github.com/nuxt/nuxt/pull/34318))
- **nuxt:** Add reset to default functionality for `useState` and `clearNuxtState` ([#33527](https://github.com/nuxt/nuxt/pull/33527))
- **nuxt,schema:** Experimentally normalise page component names to match route ([#33513](https://github.com/nuxt/nuxt/pull/33513))
- **nuxt:** Add `refresh` option to useCookie ([#33814](https://github.com/nuxt/nuxt/pull/33814))
- **nuxt:** Export page composables from `#app/composables/pages` ([#33453](https://github.com/nuxt/nuxt/pull/33453))
- **vite:** Improved optimizeDeps hints ([#34320](https://github.com/nuxt/nuxt/pull/34320))
- **nuxt:** Add View Transitions Types support ([#31982](https://github.com/nuxt/nuxt/pull/31982))
- **nuxt:** Typed props for `layout` property in `definePageMeta` ([#34409](https://github.com/nuxt/nuxt/pull/34409))
- **deps:** Upgrade `hookable` to v6 ([#33905](https://github.com/nuxt/nuxt/pull/33905))
- **deps:** Update to std-env v4 ([#34457](https://github.com/nuxt/nuxt/pull/34457))
- **nitro,nuxt:** Add suggestions + trace to import protection ([#34454](https://github.com/nuxt/nuxt/pull/34454))
- **kit,nitro,nuxt,schema,vite:** Add build profiling ([#34468](https://github.com/nuxt/nuxt/pull/34468))
- **nuxt,kit,schema:** Add a factory function for `useFetch` and `useAsyncData` ([#32300](https://github.com/nuxt/nuxt/pull/32300))
### 🔥 Performance
- **nuxt:** Disable NuxtLink visibility prefetching in dev mode ([#34325](https://github.com/nuxt/nuxt/pull/34325))
- **nuxt,vite,webpack:** Use string parsing for module ids ([#34451](https://github.com/nuxt/nuxt/pull/34451))
- **nitro,schema:** Inline payload in HTML for cached routes + add `payloadExtraction: 'client'` ([#34410](https://github.com/nuxt/nuxt/pull/34410))
### 🩹 Fixes
- **schema:** Do not bundle types ([#34300](https://github.com/nuxt/nuxt/pull/34300))
- **nuxt:** Always inject explicit prerender routes into prerender queue ([#34311](https://github.com/nuxt/nuxt/pull/34311))
- **vite:** Resolve package CSS paths in dev manifest ([#34303](https://github.com/nuxt/nuxt/pull/34303))
- **nuxt:** Wait for layout transition to finish before scrolling to top ([#34206](https://github.com/nuxt/nuxt/pull/34206))
- **kit:** Prevent duplicate `moduleDependencies` options ([#34330](https://github.com/nuxt/nuxt/pull/34330))
- **nuxt:** Retain promise methods after destructuring ([#34319](https://github.com/nuxt/nuxt/pull/34319))
- **nitro:** Encode forward slashes in payload ([#34375](https://github.com/nuxt/nuxt/pull/34375))
- **nuxt:** Do not cache `_payload.json` in dev mode ([#34365](https://github.com/nuxt/nuxt/pull/34365))
- **nuxt:** Accept refs as inputs in `NuxtLink.useLink` ([#34380](https://github.com/nuxt/nuxt/pull/34380))
- **vite:** Add nitro dev handler after vite proxy middleware ([#34349](https://github.com/nuxt/nuxt/pull/34349))
- **nuxt:** Hydrate prerendered pages with initial route + replace after hydration ([#34211](https://github.com/nuxt/nuxt/pull/34211))
- **nitro:** Escape strings rendered within js payload script tags ([d52a4fdd7](https://github.com/nuxt/nuxt/commit/d52a4fdd7))
- **vite:** Recreate ViteNodeServer after config restart ([#34396](https://github.com/nuxt/nuxt/pull/34396))
- **nitro:** Allow navigation from error page to external protocols ([#34405](https://github.com/nuxt/nuxt/pull/34405))
- **nitro,nuxt,schema:** Don't extract payloads w/ `ssr: false` ([#34327](https://github.com/nuxt/nuxt/pull/34327))
- **nuxt:** Replace destr with JSON.parse in cookie encode/decode ([#34452](https://github.com/nuxt/nuxt/pull/34452))
- **vite:** Normalise development ssr app stacktrace ([#33989](https://github.com/nuxt/nuxt/pull/33989))
- **vite:** Update ssr styles plugin for rolldown compatibility ([#34435](https://github.com/nuxt/nuxt/pull/34435))
- **nuxt:** Script block extract regex conflict ([#34412](https://github.com/nuxt/nuxt/pull/34412))
- **vite:** Move `rollup-plugin-visualizer` to optional peer dep ([#34458](https://github.com/nuxt/nuxt/pull/34458))
- **nuxt:** Restore island head entries from payload during hydration ([#34491](https://github.com/nuxt/nuxt/pull/34491))
- **kit:** Share `asyncNuxtStorage` across kit instances ([#34492](https://github.com/nuxt/nuxt/pull/34492))
- **nuxt:** Close BroadcastChannel and add error handling in refreshCookie ([#34508](https://github.com/nuxt/nuxt/pull/34508))
- **nuxt:** Check file freshness before truncating in cache restore ([#34509](https://github.com/nuxt/nuxt/pull/34509))
- **nuxt:** Never preload manifest ([#34511](https://github.com/nuxt/nuxt/pull/34511))
- **nitro:** Validate island handler context ([#34510](https://github.com/nuxt/nuxt/pull/34510))
- **nuxt:** Pass deleteCount to splice in preloadRouteComponents ([#34514](https://github.com/nuxt/nuxt/pull/34514))
- **nuxt:** Fix cookie expiration timeout for long-lived cookies ([#34513](https://github.com/nuxt/nuxt/pull/34513))
- **nuxt:** Handle rejected promise in view transition abort ([#34515](https://github.com/nuxt/nuxt/pull/34515))
### 💅 Refactors
- **nuxt:** Nullish coalesce instead of non-null assertions ([#34331](https://github.com/nuxt/nuxt/pull/34331))
- **nitro,vite:** Set ssr export conditions + vue feature flags within nitro builder ([#34379](https://github.com/nuxt/nuxt/pull/34379))
- **nitro,nuxt:** Add `/h3` subpath export for forward-compat ([#34383](https://github.com/nuxt/nuxt/pull/34383))
- **nuxt:** Use JSON.parse instead of `destr` ([#34037](https://github.com/nuxt/nuxt/pull/34037))
- **vite:** Use vite's `transformWithEsbuild` for analysis ([#34447](https://github.com/nuxt/nuxt/pull/34447))
- **nitro,vite:** Use babel for experimental decorator support ([#34465](https://github.com/nuxt/nuxt/pull/34465))
- **webpack:** Remove unused `event.context.webpack` code ([#34502](https://github.com/nuxt/nuxt/pull/34502))
### 📖 Documentation
- Update instructions for typedPages with public hoist pattern ([#34285](https://github.com/nuxt/nuxt/pull/34285))
- Add alternative editor LSP setup guidance ([#34322](https://github.com/nuxt/nuxt/pull/34322))
- Improve `` fetch priority example ([#34341](https://github.com/nuxt/nuxt/pull/34341))
- Update Cloudflare dashboard path ([#34372](https://github.com/nuxt/nuxt/pull/34372))
- Clarify --preset option in nuxt build command ([#34335](https://github.com/nuxt/nuxt/pull/34335))
- Add shared/ directory to Nuxt 4 upgrade guide ([#34391](https://github.com/nuxt/nuxt/pull/34391))
- Update link redirects + reduce checking flakiness ([01aa49659](https://github.com/nuxt/nuxt/commit/01aa49659))
- Add import for fileURLToPath in example code ([#34401](https://github.com/nuxt/nuxt/pull/34401))
- Capitalise title ([#34395](https://github.com/nuxt/nuxt/pull/34395))
- Update testing guide to test-utils v4 ([#34408](https://github.com/nuxt/nuxt/pull/34408))
- Add pending back for `useFetch` + `useLazyFetch` docs ([#34449](https://github.com/nuxt/nuxt/pull/34449))
- Correct md heading level ([#34467](https://github.com/nuxt/nuxt/pull/34467))
- Fix twoslash code examples ([#34469](https://github.com/nuxt/nuxt/pull/34469))
- Remove duplicated word ([5a22feaec](https://github.com/nuxt/nuxt/commit/5a22feaec))
- Add typed layout props docs ([#34507](https://github.com/nuxt/nuxt/pull/34507))
### 🏡 Chore
- Prevent layout shift on banner image readme ([#34309](https://github.com/nuxt/nuxt/pull/34309))
- Use npmx links 💖 ([#34340](https://github.com/nuxt/nuxt/pull/34340))
- Use `nuxt/.github` pr template ([5502ccd7b](https://github.com/nuxt/nuxt/commit/5502ccd7b))
- Update link for nuxt ossf badge ([#34406](https://github.com/nuxt/nuxt/pull/34406))
- Remove unnecessary workspace resolutions ([#34453](https://github.com/nuxt/nuxt/pull/34453))
- Migrate npm badges and links to npmx.dev ([71eb13c21](https://github.com/nuxt/nuxt/commit/71eb13c21))
- Publish 4.x releases to `4x` and `latest` tags ([1bc9bfd10](https://github.com/nuxt/nuxt/commit/1bc9bfd10))
- Enforce consistent return-await usage ([#34490](https://github.com/nuxt/nuxt/pull/34490))
- **vite:** Optional chaining for nitroApp.hooks ([24a12c810](https://github.com/nuxt/nuxt/commit/24a12c810))
- **kit:** Cast nitroConfig to `any` ([cc380ba3b](https://github.com/nuxt/nuxt/commit/cc380ba3b))
- Expand `engines.node` following #34458 ([#34458](https://github.com/nuxt/nuxt/issues/34458))
- Update `installed-check` and `engines.node` ([0c5869c2d](https://github.com/nuxt/nuxt/commit/0c5869c2d))
- Lint ([31028d2e0](https://github.com/nuxt/nuxt/commit/31028d2e0))
### ✅ Tests
- Add page path gen benchmark ([#34315](https://github.com/nuxt/nuxt/pull/34315))
- Add dev server benchmark for page route generation ([#34323](https://github.com/nuxt/nuxt/pull/34323))
- Skip bundle tests when running in stubbed mode ([#34450](https://github.com/nuxt/nuxt/pull/34450))
- Remove curly braces from inlined css expectations ([c9ab2747f](https://github.com/nuxt/nuxt/commit/c9ab2747f))
- Update bundle size ([f8e243a57](https://github.com/nuxt/nuxt/commit/f8e243a57))
- Update bundle size ([102f7ffe1](https://github.com/nuxt/nuxt/commit/102f7ffe1))
- Update bundle size ([dcebd1800](https://github.com/nuxt/nuxt/commit/dcebd1800))
### 🤖 CI
- Optimise ci workflows ([#34274](https://github.com/nuxt/nuxt/pull/34274))
- Run benchmarks on pushes to `main` ([6abf31062](https://github.com/nuxt/nuxt/commit/6abf31062))
- Avoid checkout in `issue-needs-reproduction` ([7849b34c8](https://github.com/nuxt/nuxt/commit/7849b34c8))
- Merge all issue labelled workflows ([fdd30349a](https://github.com/nuxt/nuxt/commit/fdd30349a))
- Fail fast on matrices for merge groups ([1008d3afd](https://github.com/nuxt/nuxt/commit/1008d3afd))
- More perf optimisations for merge queues ([297e4e526](https://github.com/nuxt/nuxt/commit/297e4e526))
- Move build step after runtime/unit tests ([#34388](https://github.com/nuxt/nuxt/pull/34388))
- Update default branches ([ba251c697](https://github.com/nuxt/nuxt/commit/ba251c697))
- Bump matrix timeout ([9026c16c8](https://github.com/nuxt/nuxt/commit/9026c16c8))
- Give `issues: write` permission to needs-reproduction workflow ([ba3412b49](https://github.com/nuxt/nuxt/commit/ba3412b49))
- Include `v5` prefix in skip-changelog filter ([dbc1a8666](https://github.com/nuxt/nuxt/commit/dbc1a8666))
- Don't run actions against release PRs ([961589297](https://github.com/nuxt/nuxt/commit/961589297))
- Run ci on push to 4.x/3.x ([9240729e8](https://github.com/nuxt/nuxt/commit/9240729e8))
- Only run provenance check on PRs ([5ba227449](https://github.com/nuxt/nuxt/commit/5ba227449))
### ❤️ Contributors
- Daniel Roe (@danielroe)
- Ori (@oritwoen)
- Yoshihiro Yamaguchi (@yamachi4416)
- Logan (@iml885203)
- Shiminori (@noriyuki-shimizu)
- Unai Mengual (@owlnai)
- Zoolpex (@Zoolpex)
- Harlan Wilton (@harlan-zw)
- Julien Huang (@huang-julien)
- 山吹色御守 (@KazariEX)
- Max (@onmax)
- Alex Korytskyi (@alex-key)
- abeer0 (@iiio2)
- Johannes Przymusinski (@cngJo)
- Adam Patterson (@adampatterson)
- Florian Heuberger (@Flo0806)
- Lorenzo Fiamingo (@lorenzofiamingo)
- Vida Xie (@9romise)
- Ihor (@riabinkovihor)
- Harm Zeinstra (@Harm-Nullix)
- Roli Bosch (@roli-lpci)
- Fabian Kirchhoff (@fabkho)
- Eduardo San Martin Morote (@posva)
- Henry (@lllomh)
- Davin`GM (@DavinGM)
- Alexander Lichter (@TheAlexLichter)
- Paul Melero (@paulmelero)
- dependabot[bot] (@dependabot[bot])
- Martin Arce (@divagueame)
- edison (@edison1105)
- Bobbie Goede (@BobbieGoede)
- Nemanja Malesija (@nemanjamalesija)
- Damian Głowala (@DamianGlowala)
- David Nahodyl (@Smef)
- Benjamin Canac (@benjamincanac)
> 4.3.1 is a regularly scheduled patch release.
## 👉 Changelog
[compare changes](https://github.com/nuxt/nuxt/compare/v4.3.0...v4.3.1)
### 🩹 Fixes
- **nuxt:** Correct reference format of server builder ([#34177](https://github.com/nuxt/nuxt/pull/34177))
- **nuxt:** Add status/statusText getters to NuxtError ([#34188](https://github.com/nuxt/nuxt/pull/34188))
- **nuxt:** Don't inject shared types for differing auto-imports ([#34191](https://github.com/nuxt/nuxt/pull/34191))
- **schema:** Add direnv and vendor to default ignore ([#34190](https://github.com/nuxt/nuxt/pull/34190))
- **nuxt:** Focus hash links after navigation ([#34193](https://github.com/nuxt/nuxt/pull/34193))
- **nuxt:** Exclude head runtime from unhead imports transform ([#34195](https://github.com/nuxt/nuxt/pull/34195))
- **kit:** Include prereleases in semver satisfy check ([#34210](https://github.com/nuxt/nuxt/pull/34210))
- **nitro:** Encode unicode paths in `x-nitro-prerender` header ([#34202](https://github.com/nuxt/nuxt/pull/34202))
- **nuxt:** Watch `server/` for `builder:watch` hook ([#34208](https://github.com/nuxt/nuxt/pull/34208))
- **nitro:** Preserve `error.message` for fatal errors ([#34226](https://github.com/nuxt/nuxt/pull/34226))
- Only enable dynamic imports when ts plugin ([#34205](https://github.com/nuxt/nuxt/pull/34205))
- **webpack:** Use H3Error for 403 in dev server ([#34233](https://github.com/nuxt/nuxt/pull/34233))
- **nuxt:** Ensure NuxtError extends Error type ([#34242](https://github.com/nuxt/nuxt/pull/34242))
- **vite:** Use H3Error for 404 in dev server ([#34225](https://github.com/nuxt/nuxt/pull/34225))
- **nuxt:** Add backwards compat for `#app` barrel export in keyed functions ([#34199](https://github.com/nuxt/nuxt/pull/34199))
- **nuxt:** Track + re-add custom routes on hmr ([#32044](https://github.com/nuxt/nuxt/pull/32044))
- **nuxt:** Keep vnode when leaving deeper nested route ([#33778](https://github.com/nuxt/nuxt/pull/33778))
- **vite:** Prevent CSS flickering in dev mode after config changes ([#33856](https://github.com/nuxt/nuxt/pull/33856))
- **nuxt:** Do not start view transition if there is no route ([#33723](https://github.com/nuxt/nuxt/pull/33723))
- **nuxt:** Call deferHydration done on NuxtPage unmount ([#34152](https://github.com/nuxt/nuxt/pull/34152))
- **nuxt:** Handle invalid `datetime in `` ([#33992](https://github.com/nuxt/nuxt/pull/33992))
- **nuxt:** Preserve middleware error status in 404 fallback ([#34148](https://github.com/nuxt/nuxt/pull/34148))
- **nitro:** Do not augment `nuxt/schema` ([#34255](https://github.com/nuxt/nuxt/pull/34255))
- **nuxt:** Cache manifest files to preserve buildId ([#34002](https://github.com/nuxt/nuxt/pull/34002))
- **nuxt:** Don't decode query string in SSR context URL ([#34252](https://github.com/nuxt/nuxt/pull/34252))
- **nuxt:** Allow specifying moduleDependencies by `meta.name` ([#34263](https://github.com/nuxt/nuxt/pull/34263))
- **nuxt:** Resolve `#components` import mapping conflict for packages outside rootDir ([#34139](https://github.com/nuxt/nuxt/pull/34139))
- **vite,webpack:** Use node.res to send 403/404 ([#34266](https://github.com/nuxt/nuxt/pull/34266))
- **nitro,nuxt:** Align path encoding with vue-router ([#34265](https://github.com/nuxt/nuxt/pull/34265))
- **nitro:** Augment `nuxt/schema` once more ([552bbd8d1](https://github.com/nuxt/nuxt/commit/552bbd8d1))
### 💅 Refactors
- **nuxt:** Prefer `genObjectKey` to omit unnecessary quotes ([#34245](https://github.com/nuxt/nuxt/pull/34245))
- **nuxt:** Use `ComponentProps` helper to extract layout props ([#34248](https://github.com/nuxt/nuxt/pull/34248))
### 📖 Documentation
- Update roadmap dates ([#34166](https://github.com/nuxt/nuxt/pull/34166))
- Correct default value of `nitroAutoImports` ([#34182](https://github.com/nuxt/nuxt/pull/34182))
- Clarify shared type context limitations for custom imports ([#34194](https://github.com/nuxt/nuxt/pull/34194))
- Fix broken links ([#34223](https://github.com/nuxt/nuxt/pull/34223))
- Document payload extraction for ISR/SWR routes ([#34222](https://github.com/nuxt/nuxt/pull/34222))
- Update default aliases in configuration reference ([#34237](https://github.com/nuxt/nuxt/pull/34237))
- Update example of email validation ([#34247](https://github.com/nuxt/nuxt/pull/34247))
- Align server alias examples with `#server` and `rootDir` ([#34259](https://github.com/nuxt/nuxt/pull/34259))
- Add documentation for `keyedComposables` ([#34201](https://github.com/nuxt/nuxt/pull/34201))
### 🏡 Chore
- Remove `px` from `width` attribute ([8d1cbb27a](https://github.com/nuxt/nuxt/commit/8d1cbb27a))
- Add ai config in gitignore ([#34220](https://github.com/nuxt/nuxt/pull/34220))
### ✅ Tests
- Vitest v4 compatibility ([825b2c202](https://github.com/nuxt/nuxt/commit/825b2c202))
- Add runtime tests for deeply nested `` navigation ([048efc030](https://github.com/nuxt/nuxt/commit/048efc030))
### ❤️ Contributors
- Daniel Roe (@danielroe)
- Matej Černý (@cernymatej)
- Octavio Araiza (@8ctavio)
- Muhammad Yasir Ghaffar (@M-YasirGhaffar)
- mrkaashee (@mrkaashee)
- Max (@onmax)
- Bobbie Goede (@BobbieGoede)
- 纸鹿/Zhilu (@L33Z22L11)
- Florian Heuberger (@Flo0806)
- 山吹色御守 (@KazariEX)
- ExXTreMe315 (@ExXTreMe315)
- Eugene (@FlexIDK)
- abeer0 (@iiio2)
- Jonas Thelemann (@dargmuesli)
- Erwan Jugand (@erwanjugand)
> 3.21.1 is a regularly schedule patch release.
## 👉 Changelog
[compare changes](https://github.com/nuxt/nuxt/compare/v3.21.0...v3.21.1)
### 🩹 Fixes
- **nuxt:** Correct reference format of server builder ([#34177](https://github.com/nuxt/nuxt/pull/34177))
- **nuxt:** Add status/statusText getters to NuxtError ([#34188](https://github.com/nuxt/nuxt/pull/34188))
- **schema:** Add direnv and vendor to default ignore ([#34190](https://github.com/nuxt/nuxt/pull/34190))
- **nuxt:** Focus hash links after navigation ([#34193](https://github.com/nuxt/nuxt/pull/34193))
- **nuxt:** Exclude head runtime from unhead imports transform ([#34195](https://github.com/nuxt/nuxt/pull/34195))
- **kit:** Include prereleases in semver satisfy check ([#34210](https://github.com/nuxt/nuxt/pull/34210))
- **nuxt:** Watch `server/` for `builder:watch` hook ([#34208](https://github.com/nuxt/nuxt/pull/34208))
- **nitro:** Encode unicode paths in `x-nitro-prerender` header ([#34202](https://github.com/nuxt/nuxt/pull/34202))
- **nitro:** Preserve `error.message` for fatal errors ([#34226](https://github.com/nuxt/nuxt/pull/34226))
- Only enable dynamic imports when ts plugin ([#34205](https://github.com/nuxt/nuxt/pull/34205))
- **webpack:** Use H3Error for 403 in dev server ([#34233](https://github.com/nuxt/nuxt/pull/34233))
- **nuxt:** Ensure NuxtError extends Error type ([#34242](https://github.com/nuxt/nuxt/pull/34242))
- **vite:** Use H3Error for 404 in dev server ([#34225](https://github.com/nuxt/nuxt/pull/34225))
- **nuxt:** Add backwards compat for `#app` barrel export in keyed functions ([#34199](https://github.com/nuxt/nuxt/pull/34199))
- **nuxt:** Track + re-add custom routes on hmr ([#32044](https://github.com/nuxt/nuxt/pull/32044))
- **nuxt:** Keep vnode when leaving deeper nested route ([#33778](https://github.com/nuxt/nuxt/pull/33778))
- **vite:** Prevent CSS flickering in dev mode after config changes ([#33856](https://github.com/nuxt/nuxt/pull/33856))
- **nuxt:** Do not start view transition if there is no route ([#33723](https://github.com/nuxt/nuxt/pull/33723))
- **nuxt:** Call deferHydration done on NuxtPage unmount ([#34152](https://github.com/nuxt/nuxt/pull/34152))
- **nuxt:** Handle invalid `datetime in `` ([#33992](https://github.com/nuxt/nuxt/pull/33992))
- **nuxt:** Preserve middleware error status in 404 fallback ([#34148](https://github.com/nuxt/nuxt/pull/34148))
- **nitro:** Do not augment `nuxt/schema` ([#34255](https://github.com/nuxt/nuxt/pull/34255))
- **nuxt:** Cache manifest files to preserve buildId ([#34002](https://github.com/nuxt/nuxt/pull/34002))
- **nuxt:** Don't decode query string in SSR context URL ([#34252](https://github.com/nuxt/nuxt/pull/34252))
- **nuxt:** Allow specifying moduleDependencies by `meta.name` ([#34263](https://github.com/nuxt/nuxt/pull/34263))
- **nuxt:** Resolve `#components` import mapping conflict for packages outside rootDir ([#34139](https://github.com/nuxt/nuxt/pull/34139))
- **vite,webpack:** Use node.res to send 403/404 ([#34266](https://github.com/nuxt/nuxt/pull/34266))
- **nitro,nuxt:** Align path encoding with vue-router ([#34265](https://github.com/nuxt/nuxt/pull/34265))
- **nitro:** Augment `nuxt/schema` once more ([9f5bb611d](https://github.com/nuxt/nuxt/commit/9f5bb611d))
### 💅 Refactors
- **nuxt:** Prefer `genObjectKey` to omit unnecessary quotes ([#34245](https://github.com/nuxt/nuxt/pull/34245))
- **nuxt:** Use `ComponentProps` helper to extract layout props ([#34248](https://github.com/nuxt/nuxt/pull/34248))
### 📖 Documentation
- Remove link to ai guide entirely ([084b5d7f2](https://github.com/nuxt/nuxt/commit/084b5d7f2))
- Update roadmap dates ([#34166](https://github.com/nuxt/nuxt/pull/34166))
- Clarify shared type context limitations for custom imports ([#34194](https://github.com/nuxt/nuxt/pull/34194))
- Fix broken links ([#34223](https://github.com/nuxt/nuxt/pull/34223))
- Document payload extraction for ISR/SWR routes ([#34222](https://github.com/nuxt/nuxt/pull/34222))
- Update example of email validation ([#34247](https://github.com/nuxt/nuxt/pull/34247))
- Add documentation for `keyedComposables` ([#34201](https://github.com/nuxt/nuxt/pull/34201))
### 🏡 Chore
- Remove `px` from `width` attribute ([e80147f7d](https://github.com/nuxt/nuxt/commit/e80147f7d))
- Add ai config in gitignore ([#34220](https://github.com/nuxt/nuxt/pull/34220))
### ✅ Tests
- Vitest v4 compatibility ([70e147b71](https://github.com/nuxt/nuxt/commit/70e147b71))
- Add runtime tests for deeply nested `` navigation ([707a9dc44](https://github.com/nuxt/nuxt/commit/707a9dc44))
- Resolve merge issues in tests ([85abddc54](https://github.com/nuxt/nuxt/commit/85abddc54))
### ❤️ Contributors
- Daniel Roe (@danielroe)
- Matej Černý (@cernymatej)
- Octavio Araiza (@8ctavio)
- Muhammad Yasir Ghaffar (@M-YasirGhaffar)
- Max (@onmax)
- Bobbie Goede (@BobbieGoede)
- 纸鹿/Zhilu (@L33Z22L11)
- Florian Heuberger (@Flo0806)
- 山吹色御守 (@KazariEX)
- ExXTreMe315 (@ExXTreMe315)
- Eugene (@FlexIDK)
- abeer0 (@iiio2)
- Jonas Thelemann (@dargmuesli)
- Erwan Jugand (@erwanjugand)
> 4.3.0 is the next minor release.
Nuxt 4.3 brings powerful new features for layouts, caching, and developer experience – plus significant performance improvements under the hood.
## 📣 Some News
### Extended v3 Support
Early this month, I [opened a discussion](https://github.com/nuxt/nuxt/discussions/33918) to find out how the upgrade had gone from v3 to v4. I was really pleased to hear how well it had gone for most people.
Having said that, we're committed to making sure no one gets left behind. And so we will **continue to provide security updates and critical bug fix releases** beyond the previously announced end-of-life date of January 31, 2026, meaning Nuxt v3 will meet its end-of-life on July 31, 2026.
> [!TIP]
> As usual, today also brings a minor release for v3, with many of the same improvements backported from v4.3.
### Preparing for Nuxt 5
We're closer than ever to the releases of Nuxt v5 and Nitro v3. In the coming weeks, the `main` branch of the Nuxt repository will begin receiving initial commits for Nuxt 5. However, it's still **business as usual**.
- Continue making pull requests to the `main` branch
- We'll backport changes to the `4.x` and `3.x` branches
Keep an eye out on the [Upgrade Guide](https://nuxt.com/docs/4.x/getting-started/upgrade) – we'll be adding details about how you can already start migrating your projects to prepare for Nuxt v4 with `future.compatibilityVersion: 5`.
## 🗂️ Route Rule Layouts
But that's enough about the future. We have a lot of good things for you today!
First, you can now set layouts directly in route rules using the new `appLayout` property ([#31092](https://github.com/nuxt/nuxt/pull/31092)). This provides a centralized, declarative way to manage layouts across your application without scattering `definePageMeta` calls throughout your pages.
```ts [nuxt.config.ts]
export default defineNuxtConfig({
routeRules: {
'/admin/**': { appLayout: 'admin' },
'/dashboard/**': { appLayout: 'dashboard' },
'/auth/**': { appLayout: 'minimal' }
}
})
```
This might be useful for:
- Admin panels with a shared layout across many routes
- Marketing pages that need a different layout from the app
> [!TIP]
> Plus, you can pass props to layouts now! See [the `setPageLayout` improvements below](#layout-props-with-setpagelayout).
## 📦 ISR/SWR Payload Extraction
Payload extraction now works with ISR (incremental static regeneration), SWR (stale-while-revalidate) and cache `routeRules` ([#33467](https://github.com/nuxt/nuxt/pull/33467)). Previously, only pre-rendered pages could generate `_payload.json` files.
This means:
- Client-side navigation to ISR/SWR pages can use cached payloads
- CDNs (Vercel, Netlify, Cloudflare) can cache payload files alongside HTML
- Fewer API calls during navigation – data can be prefetched and served from the cached payload
```ts [nuxt.config.ts]
export default defineNuxtConfig({
routeRules: {
'/products/**': {
isr: 3600, // Revalidate every hour
}
}
})
```
## 🧹 Dev Mode Payload Extraction
Related to the above, payload extraction now also works in development mode ([#30784](https://github.com/nuxt/nuxt/pull/30784)). This makes it easier to test and debug payload behavior without needing to run a production build.
> [!IMPORTANT]
> Payload extraction works in dev mode with `nitro.static` set to `true`, or for individual pages which have `isr`, `swr`, `prerender` or `cache` route rules.
## 🚫 Disable Modules from Layers
When extending Nuxt layers, you can now disable specific modules that you don't need ([#33883](https://github.com/nuxt/nuxt/pull/33883)). Just pass `false` to the module's options:
```ts [nuxt.config.ts]
export default defineNuxtConfig({
extends: ['../shared-layer'],
// disable @nuxt/image from layer
image: false,
})
```
## 🏷️ Route Groups in Page Meta
[Route groups](https://nuxt.com/docs/4.x/directory-structure/app/pages#route-groups) (folders wrapped in parentheses like `(protected)/`) are now exposed in page meta ([#33460](https://github.com/nuxt/nuxt/pull/33460)). This makes it easy to check which groups a route belongs to in middleware or anywhere you have access to the route.
```vue [pages/(protected)/dashboard.vue]
```
```ts [middleware/auth.ts]
export default defineNuxtRouteMiddleware((to) => {
if (to.meta.groups?.includes('protected') && !isAuthenticated()) {
return navigateTo('/login')
}
})
```
This provides a clean, convention-based approach to route-level authorization without needing to add `definePageMeta` to every protected page.
## 🎨 Layout Props with `setPageLayout`
The `setPageLayout` composable now accepts a second parameter to pass props to your layout ([#33805](https://github.com/nuxt/nuxt/pull/33805)):
```ts [middleware/admin.ts]
export default defineNuxtRouteMiddleware((to) => {
setPageLayout('admin', {
sidebar: true,
theme: 'dark'
})
})
```
```vue [layouts/admin.vue]
```
## 🔧 `#server` Alias
A new `#server` alias provides clean imports within your server directory ([#33870](https://github.com/nuxt/nuxt/pull/33870)), similar to how `#shared` works:
```ts [server/api/users/[id]/profile.ts]
// Before: relative path hell
import { helper } from '../../../../utils/helper'
// After: clean and predictable
import { helper } from '#server/utils/helper'
```
The alias includes import protection – you can't accidentally import `#server` code from client or shared contexts.
## 🪟 Draggable Error Overlay
The development error overlay introduced in Nuxt 4.2 is now draggable and can be minimized ([#33695](https://github.com/nuxt/nuxt/pull/33695)). You can:
- Drag it to any corner of the screen (it snaps to edges)
- Minimize it to a small pill button when you want to keep working
- Your position and minimized state persist across page reloads
This is a quality-of-life improvement when you're iterating on fixes and don't want the overlay blocking your view.
https://github.com/user-attachments/assets/nuxt_4-3_error_demo.mp4
## ⚙️ Async Plugin Constructors
Module authors can now use async functions when adding build plugins ([#33619](https://github.com/nuxt/nuxt/pull/33619)):
```ts [modules/my-module.ts]
export default defineNuxtModule({
async setup() {
// Lazy load only when actually needed
addVitePlugin(() => import('my-cool-plugin').then(r => r.default()))
// No need to load webpack plugin if using Vite
addWebpackPlugin(() => import('my-cool-plugin/webpack').then(r => r.default()))
}
})
```
This enables true lazy loading of build plugins, avoiding unnecessary code loading when plugins aren't needed.
## 🚀 Performance Improvements
This release includes several performance optimizations for faster builds:
- **Hook filters** - Internal plugins now use filters to avoid running hooks unnecessarily ([#33898](https://github.com/nuxt/nuxt/pull/33898))
- **SSR styles optimization** - The `nuxt:ssr-styles` plugin is now significantly faster ([#33862](https://github.com/nuxt/nuxt/pull/33862), [#33865](https://github.com/nuxt/nuxt/pull/33865))
- **Layer alias transform** - Skipped when using Vite (it handles this natively) ([#33864](https://github.com/nuxt/nuxt/pull/33864))
- **Route rules compilation** - Route rules are now compiled into a client chunk using `rou3`, removing the need for `radix3` in the client bundle and eliminating app manifest fetches ([#33920](https://github.com/nuxt/nuxt/pull/33920))
## 🎨 Inline Styles for Webpack/Rspack
The `inlineStyles` feature now works with webpack and rspack builders ([#33966](https://github.com/nuxt/nuxt/pull/33966)), not just Vite. This enables critical CSS inlining for better Core Web Vitals regardless of your bundler choice.
## ⚠️ Deprecations
### `statusCode` → `status`, `statusMessage` → `statusText`
In preparation for Nitro v3 and H3 v2, we're moving to use Web API naming conventions ([#33912](https://github.com/nuxt/nuxt/pull/33912)). The old properties still work but are deprecated in advance of v5:
```diff
- throw createError({ statusCode: 404, statusMessage: 'Not Found' })
+ throw createError({ status: 404, statusText: 'Not Found' })
```
## 🐛 Bug Fixes
Notable fixes in this release:
- Fixed head component deduplication using `key` attribute ([#33958](https://github.com/nuxt/nuxt/pull/33958), [#33963](https://github.com/nuxt/nuxt/pull/33963))
- Fixed async data properties not being reactive in Options API ([#34119](https://github.com/nuxt/nuxt/pull/34119))
- Fixed `useCookie` unsafe number parsing during decode ([#34007](https://github.com/nuxt/nuxt/pull/34007))
- Fixed `NuxtPage` not re-rendering when nested `NuxtLayout` has layouts disabled ([#34078](https://github.com/nuxt/nuxt/pull/34078))
- Fixed client-side pathname decoding for non-ASCII route aliases ([#34043](https://github.com/nuxt/nuxt/pull/34043))
- Fixed suspense remounting when navigating after pending state ([#33991](https://github.com/nuxt/nuxt/pull/33991))
- Fixed clipboard copy in error overlay ([#33873](https://github.com/nuxt/nuxt/pull/33873))
- Enabled `allowArbitraryExtensions` by default in TypeScript config ([#34084](https://github.com/nuxt/nuxt/pull/34084))
- Added `noUncheckedIndexedAccess` to server tsconfig for safer typing ([#33985](https://github.com/nuxt/nuxt/pull/33985))
> [!IMPORTANT]
> Enabling `noUncheckedIndexedAccess` in the Nitro server TypeScript config improves type safety but may surface new type errors in your server code. This change was necessary because Nuxt's app context performs type checks on server routes ([learn more](https://nuxt.com/docs/4.x/guide/modules/recipes-advanced#known-limitations)).
>
> While we recommend keeping this enabled for better type safety, you can disable it if needed:
>
> ```ts
> export default defineNuxtConfig({
> nitro: {
> typescript: {
> tsConfig: {
> compilerOptions: {
> noUncheckedIndexedAccess: false
> }
> }
> }
> }
> })
> ```
>
> Note that disabling this may allow type errors to slip through that could cause runtime issues with indexed access.
## 📚 Documentation
- Improved module author guides with clearer structure ([#33803](https://github.com/nuxt/nuxt/pull/33803))
- Added MCP setup instructions for Claude Desktop ([#33914](https://github.com/nuxt/nuxt/pull/33914))
- Added layers directory documentation ([#33967](https://github.com/nuxt/nuxt/pull/33967))
- Added Deno package manager examples ([#34070](https://github.com/nuxt/nuxt/pull/34070))
- Clarified type-checking context limitations for server routes ([#33964](https://github.com/nuxt/nuxt/pull/33964))
## 🎉 Nuxt 3.21.0
Alongside v4.3.0, we're releasing **Nuxt v3.21.0** with many of the same improvements backported to the 3.x branch. This release includes:
- **All the same features**: Route rule layouts, ISR payload extraction, layout props with `setPageLayout`, `#server` alias, draggable error overlay, and more
- **All performance improvements**: SSR styles optimization, hook filters, and route rules compilation
- **Module disabling**: Disable layer modules by setting options to `false`
- **Critical bug fixes**: Async data reactivity in Options API, `useCookie` number parsing, head component deduplication, and more
## ✅ Upgrading
Our recommendation for upgrading is to run:
```sh
npx nuxt upgrade --dedupe
# or, if you are upgrading to v3.21
npx nuxt@latest upgrade --dedupe --channel=v3
```
This will deduplicate your lockfile and help ensure you pull in updates from other dependencies that Nuxt relies on, particularly in the unjs ecosystem.
> [!TIP]
> Check out our [upgrade guide](https://nuxt.com/docs/getting-started/upgrade) if upgrading from an older version.
## 👉 Changelog
[compare changes](https://github.com/nuxt/nuxt/compare/v4.2.2...v4.3.0)
### 🚀 Enhancements
- **kit:** Support async constructor for adding plugins ([#33619](https://github.com/nuxt/nuxt/pull/33619))
- **kit:** Export Nuxt major version type ([#33700](https://github.com/nuxt/nuxt/pull/33700))
- **schema:** Add `#server` alias for server directory imports ([#33870](https://github.com/nuxt/nuxt/pull/33870))
- **ui-templates:** Let it snow! ❄️ ([#33804](https://github.com/nuxt/nuxt/pull/33804))
- **schema:** Hoist nitro `crossws` types ([5b16a51f5](https://github.com/nuxt/nuxt/commit/5b16a51f5))
- **nitro,nuxt:** Compile route rules into client chunk ([#33920](https://github.com/nuxt/nuxt/pull/33920))
- **nuxt:** Allow disabling modules by setting module options to `false` ([#33883](https://github.com/nuxt/nuxt/pull/33883))
- **kit:** Allow specifying `moduleDependencies` as an async function ([#33504](https://github.com/nuxt/nuxt/pull/33504))
- **nuxt:** Support `appLayout` in route rules ([#31092](https://github.com/nuxt/nuxt/pull/31092))
- **nuxt:** Add route groups to page meta ([#33460](https://github.com/nuxt/nuxt/pull/33460))
- **nuxt:** Enable payload extraction for ISR/SWR routes ([#33467](https://github.com/nuxt/nuxt/pull/33467))
- **nuxt:** Allow updating props with `setPageLayout` ([#33805](https://github.com/nuxt/nuxt/pull/33805))
- **nuxt:** Enable dragging and minimizing for error overlay ([#33695](https://github.com/nuxt/nuxt/pull/33695))
- **nitro,nuxt:** Add support for payload extraction in dev ([#30784](https://github.com/nuxt/nuxt/pull/30784))
- **rspack,webpack:** Add inline styles ([#33966](https://github.com/nuxt/nuxt/pull/33966))
- **kit:** Add forward-compatible nitro types ([#34036](https://github.com/nuxt/nuxt/pull/34036))
### 🔥 Performance
- **nuxt:** Do not init layer alias transform when using vite ([#33864](https://github.com/nuxt/nuxt/pull/33864))
- **vite:** Add hook filters for ssr styles plugin ([#33865](https://github.com/nuxt/nuxt/pull/33865))
- **vite:** Optimize `nuxt:ssr-styles` plugin ([#33862](https://github.com/nuxt/nuxt/pull/33862))
- **nuxt:** Use filter for vfs plugin load ([eb3d2d4c6](https://github.com/nuxt/nuxt/commit/eb3d2d4c6))
- **nuxt,vite:** Use filters to avoid running hooks unnecessarily ([6b7fc7477](https://github.com/nuxt/nuxt/commit/6b7fc7477))
- **nuxt,vite:** Add more filters to internal plugins ([#33898](https://github.com/nuxt/nuxt/pull/33898))
### 🩹 Fixes
- **kit:** Normalize local layer paths with trailing slashes ([#33858](https://github.com/nuxt/nuxt/pull/33858))
- **nuxt:** Avoid overwriting multiple head input in island handler ([#33849](https://github.com/nuxt/nuxt/pull/33849))
- **nuxt:** Update meta instead of calling `router.replace` in page hmr ([#33897](https://github.com/nuxt/nuxt/pull/33897))
- **nuxt:** Don't call `page:loading:end` in cache if already called ([7789f73bd](https://github.com/nuxt/nuxt/commit/7789f73bd))
- **vite:** Add error handling for parsing `NUXT_VITE_NODE_OPTIONS` ([41a564d23](https://github.com/nuxt/nuxt/commit/41a564d23))
- **nuxt:** Do not skip middleware when `appMiddleware` references invalid key ([323f27bc8](https://github.com/nuxt/nuxt/commit/323f27bc8))
- **nitro:** Clipboard copy in error overlay ([#33873](https://github.com/nuxt/nuxt/pull/33873))
- **webpack,rspack:** Resolve deep imports in virtual files ([#33927](https://github.com/nuxt/nuxt/pull/33927))
- **webpack:** Disable async chunks in dev mode ([0310c4070](https://github.com/nuxt/nuxt/commit/0310c4070))
- **webpack:** Correctly evaluate sourcemap name ([653f364af](https://github.com/nuxt/nuxt/commit/653f364af))
- **nuxt:** Handle node10 resolution for `nuxt/meta` ([01c2c9b13](https://github.com/nuxt/nuxt/commit/01c2c9b13))
- **nuxt:** Do not early return if component priorities conflict ([#33955](https://github.com/nuxt/nuxt/pull/33955))
- **nuxt:** Use `key` for tag deduplication in `` component ([#33958](https://github.com/nuxt/nuxt/pull/33958))
- **schema,vite:** Resolve `build.transpile` when initialising vite ([#33868](https://github.com/nuxt/nuxt/pull/33868))
- **nuxt,rspack,webpack:** Inject module identifiers for webpack builders ([#33962](https://github.com/nuxt/nuxt/pull/33962))
- **nuxt:** Add key to head components for proper deduplication ([#33963](https://github.com/nuxt/nuxt/pull/33963))
- **nitro:** Check prettyResponse.body type before error overlay ([#33977](https://github.com/nuxt/nuxt/pull/33977))
- **nuxt:** Don't URI-encode static route paths ([#33990](https://github.com/nuxt/nuxt/pull/33990))
- **nuxt:** Skip internal stub routes from prerender ([#34001](https://github.com/nuxt/nuxt/pull/34001))
- **kit,schema:** Align module `onUpgrade` arguments with types ([#33988](https://github.com/nuxt/nuxt/pull/33988))
- **nuxt:** Handle unsafe number parsing in useCookie decode ([#34007](https://github.com/nuxt/nuxt/pull/34007))
- **nuxt:** Do not externalise `rou3` ([2df4e1ae3](https://github.com/nuxt/nuxt/commit/2df4e1ae3))
- **nitro:** Add `noUncheckedIndexedAccess` to server tsconfig ([#33985](https://github.com/nuxt/nuxt/pull/33985))
- **nuxt:** Add auto-import declarations for `shared/` context ([#33978](https://github.com/nuxt/nuxt/pull/33978))
- **nuxt:** Update global reference to globalThis in `useRequestFetch` ([#33976](https://github.com/nuxt/nuxt/pull/33976))
- **vite:** Configure hmr port for server build ([#33929](https://github.com/nuxt/nuxt/pull/33929))
- **kit:** Add forward compatible nitro v3 types ([#34053](https://github.com/nuxt/nuxt/pull/34053))
- **nitro,nuxt:** Do not import nitro deps in builders ([#34054](https://github.com/nuxt/nuxt/pull/34054))
- **nitro:** Add `h3` types to auto-imports ([#34035](https://github.com/nuxt/nuxt/pull/34035))
- **schema:** Add some more directories to ignore ([ebc2a66ab](https://github.com/nuxt/nuxt/commit/ebc2a66ab))
- **nitro:** Also augment `nuxt/schema` ([a6a044d81](https://github.com/nuxt/nuxt/commit/a6a044d81))
- **nuxt:** Make asyncData properties reactive in Options API ([#34119](https://github.com/nuxt/nuxt/pull/34119))
- **nuxt:** Rerender `NuxtPage` when nested `NuxtLayout` has explicitly disabled layouts ([#34078](https://github.com/nuxt/nuxt/pull/34078))
- **kit,nitro:** Enable `allowArbitraryExtensions` by default ([#34084](https://github.com/nuxt/nuxt/pull/34084))
- **nuxt:** Decode client-side pathname for non-ASCII route aliases ([#34043](https://github.com/nuxt/nuxt/pull/34043))
- **nuxt:** Force remount suspense when navigating after pending ([#33991](https://github.com/nuxt/nuxt/pull/33991))
- **nuxt:** Add documentation link to server builder error message ([#34122](https://github.com/nuxt/nuxt/pull/34122))
- **nuxt:** Validate placeholder/fallback tags + warn about placeholder/fallback props ([567a1c6fb](https://github.com/nuxt/nuxt/commit/567a1c6fb))
- **nuxt:** Force flush `useAsyncData` debounced execute post watcher flush ([#34125](https://github.com/nuxt/nuxt/pull/34125))
- **nitro:** Process isr/swr/cache keys ([d84278622](https://github.com/nuxt/nuxt/commit/d84278622))
- **nuxt:** Add `typeFrom` support for `imports.d.ts` template exports ([#34135](https://github.com/nuxt/nuxt/pull/34135))
- **nuxt:** Ensure we inline styles for `hydrate-never` components ([#34132](https://github.com/nuxt/nuxt/pull/34132))
### 💅 Refactors
- **kit:** Add explicit return types for kit utilities ([6cd1289d1](https://github.com/nuxt/nuxt/commit/6cd1289d1))
- **nitro,nuxt,schema,vite:** Provide explicit return types ([1d2c0c25f](https://github.com/nuxt/nuxt/commit/1d2c0c25f))
- **kit,nuxt,schema:** Use named imports from `defu` + `consola` ([322dae3e0](https://github.com/nuxt/nuxt/commit/322dae3e0))
- Add explicit `.ts` file extensions to relative imports ([80778c0cd](https://github.com/nuxt/nuxt/commit/80778c0cd))
- **kit,nitro,nuxt,schema:** Reduce barrels + move `<>` to `as` ([f1713850c](https://github.com/nuxt/nuxt/commit/f1713850c))
- **nitro,nuxt:** Use `~` prefix for internal ssrContext properties ([#33896](https://github.com/nuxt/nuxt/pull/33896))
- **nitro:** Add explicit return types for runtime utils ([a4fda917e](https://github.com/nuxt/nuxt/commit/a4fda917e))
- **nitro:** Move tree-shaken flags from replace plugin -> vfs ([#33907](https://github.com/nuxt/nuxt/pull/33907))
- **nitro,nuxt,vite,webpack:** Use `status`/`statusText` + deprecate old props ([#33912](https://github.com/nuxt/nuxt/pull/33912))
- **webpack:** Use RuntimeModule API for chunk preloads ([#33930](https://github.com/nuxt/nuxt/pull/33930))
- **nuxt:** Use AST-aware function key injection ([#33446](https://github.com/nuxt/nuxt/pull/33446))
- **nitro,nuxt,schema:** Use augments for nitro schema types ([#34039](https://github.com/nuxt/nuxt/pull/34039))
- **nitro,rspack,vite,webpack:** Move cors handling -> nitro builder ([#34048](https://github.com/nuxt/nuxt/pull/34048))
### 📖 Documentation
- Split and improve `Module Author Guides` ([#33803](https://github.com/nuxt/nuxt/pull/33803))
- Update links to module guide ([86d67b24f](https://github.com/nuxt/nuxt/commit/86d67b24f))
- Fix `useHead` return type ([#33857](https://github.com/nuxt/nuxt/pull/33857))
- Add note that middleware doesn't run when rendering islands ([7df27c781](https://github.com/nuxt/nuxt/commit/7df27c781))
- Add note on default branch for layers ([#33919](https://github.com/nuxt/nuxt/pull/33919))
- Add mcp setup instructions for claude desktop ([#33914](https://github.com/nuxt/nuxt/pull/33914))
- Mention deno as package manager ([#33875](https://github.com/nuxt/nuxt/pull/33875))
- Clarify purpose of `statusText` ([#32834](https://github.com/nuxt/nuxt/pull/32834))
- Update lychee config and remove medium article link ([c0b4e0f28](https://github.com/nuxt/nuxt/commit/c0b4e0f28))
- Update module count and fix typo ([#33950](https://github.com/nuxt/nuxt/pull/33950))
- Add DeepWiki badge ([#33508](https://github.com/nuxt/nuxt/pull/33508))
- Give example of usage of `defineWrappedResponseHandler` ([#33952](https://github.com/nuxt/nuxt/pull/33952))
- Provide cleaner example code for vitest projects ([#33960](https://github.com/nuxt/nuxt/pull/33960))
- Improve `addImports` example ([#34011](https://github.com/nuxt/nuxt/pull/34011))
- Update yarn create command ([4a3c08874](https://github.com/nuxt/nuxt/commit/4a3c08874))
- Update roadmap with a11y ([d3453d6a5](https://github.com/nuxt/nuxt/commit/d3453d6a5))
- Add a11y release ([#34041](https://github.com/nuxt/nuxt/pull/34041))
- Remove Nuxtr from recommendations ([#34045](https://github.com/nuxt/nuxt/pull/34045))
- Typo ([#34050](https://github.com/nuxt/nuxt/pull/34050))
- Remove duplicate feature ([#34058](https://github.com/nuxt/nuxt/pull/34058))
- Fix typo ([#34057](https://github.com/nuxt/nuxt/pull/34057))
- Provide deno package manager examples ([#34070](https://github.com/nuxt/nuxt/pull/34070))
- Update JSDoc for `config.experimental` properties ([#34069](https://github.com/nuxt/nuxt/pull/34069))
- Fix transition types ([#34082](https://github.com/nuxt/nuxt/pull/34082))
- Make custom wrapper recipe link more prominent ([#34085](https://github.com/nuxt/nuxt/pull/34085))
- Remove `null` from `getCachedData` trigger ([f7cf3747e](https://github.com/nuxt/nuxt/commit/f7cf3747e))
- **nuxt:** Mention custom serializers in `useState` docs ([#34105](https://github.com/nuxt/nuxt/pull/34105))
- Add info about runtime directories + type checking ([#34097](https://github.com/nuxt/nuxt/pull/34097))
- Clarify module setups in `.nuxtrc` example ([#34107](https://github.com/nuxt/nuxt/pull/34107))
- Remove duplicate entries in table ([#34094](https://github.com/nuxt/nuxt/pull/34094))
- Clarify catch all notation for `addServerHandler` ([#34060](https://github.com/nuxt/nuxt/pull/34060))
- Add layers directory documentation ([#33967](https://github.com/nuxt/nuxt/pull/33967))
- Clarify type-checking context limitations for server routes ([#33964](https://github.com/nuxt/nuxt/pull/33964))
- Add a tip for `appLayout` ([beda47955](https://github.com/nuxt/nuxt/commit/beda47955))
- Add docs for disabling modules by passing `false` to its options ([cdad9310c](https://github.com/nuxt/nuxt/commit/cdad9310c))
- Add info about caching payloads with isr/swr ([6e10ff04f](https://github.com/nuxt/nuxt/commit/6e10ff04f))
- Add example for async addVitePlugin ([1098254f7](https://github.com/nuxt/nuxt/commit/1098254f7))
- Add example of passing props to layouts ([1f9e6b82c](https://github.com/nuxt/nuxt/commit/1f9e6b82c))
- Mark vite plugin as not typed ([5e09fddfb](https://github.com/nuxt/nuxt/commit/5e09fddfb))
- Add warning about `source` from `` ([1586bbb6e](https://github.com/nuxt/nuxt/commit/1586bbb6e))
### 📦 Build
- Remove babel debugging plugin from jiti stub options ([bce8248b4](https://github.com/nuxt/nuxt/commit/bce8248b4))
- **vite:** Add build entries for `vite-node` entrypoints ([#33893](https://github.com/nuxt/nuxt/pull/33893))
- **nuxt:** Tidy up subpath export types ([a63d4a014](https://github.com/nuxt/nuxt/commit/a63d4a014))
- Use `obuild` except for nuxt + nitro-server packages ([#34049](https://github.com/nuxt/nuxt/pull/34049))
- **schema:** Fix `/builder-env` subpath types ([7f5034288](https://github.com/nuxt/nuxt/commit/7f5034288))
### 🏡 Chore
- Add return types to debug plugins ([8f7554287](https://github.com/nuxt/nuxt/commit/8f7554287))
- Add `build:stub` command for those that need it ([3e3d3d37a](https://github.com/nuxt/nuxt/commit/3e3d3d37a))
- Revert change to how type augments are inserted ([c1b3590ff](https://github.com/nuxt/nuxt/commit/c1b3590ff))
- Update eslint config rule ([2717d8fd3](https://github.com/nuxt/nuxt/commit/2717d8fd3))
- Do not require aligned columns in tables ([8d3c5b371](https://github.com/nuxt/nuxt/commit/8d3c5b371))
- Lint ([f89d447a1](https://github.com/nuxt/nuxt/commit/f89d447a1))
- Explicitly import `node:process` ([#33982](https://github.com/nuxt/nuxt/pull/33982))
- Add root scripts to lint context ([e22089f82](https://github.com/nuxt/nuxt/commit/e22089f82))
- Tidy up configs ([8b42d4c2b](https://github.com/nuxt/nuxt/commit/8b42d4c2b))
- Lint docs with eslint ([51da8e681](https://github.com/nuxt/nuxt/commit/51da8e681))
- Lint ([1cfd3c460](https://github.com/nuxt/nuxt/commit/1cfd3c460))
### ✅ Tests
- Update tests for new version of nuxt/test-utils ([#33842](https://github.com/nuxt/nuxt/pull/33842))
- Avoid unnecessary tick ([988f6657a](https://github.com/nuxt/nuxt/commit/988f6657a))
- Add regression test for asyncData HMR ([#32182](https://github.com/nuxt/nuxt/pull/32182))
- Add test for page hmr resetting state ([#32418](https://github.com/nuxt/nuxt/pull/32418))
- Add reproduction for vite pre-transform error ([#31574](https://github.com/nuxt/nuxt/pull/31574))
- Add regression test for #32154 ([#32154](https://github.com/nuxt/nuxt/issues/32154))
- Use `vi.hoisted` for klona mock ([#34113](https://github.com/nuxt/nuxt/pull/34113))
### 🤖 CI
- Directly call webhook url ([ce15997ce](https://github.com/nuxt/nuxt/commit/ce15997ce))
- Use new reusable triage workflows ([#34072](https://github.com/nuxt/nuxt/pull/34072))
- Use new shared dependency review workflow ([8c01e1ce9](https://github.com/nuxt/nuxt/commit/8c01e1ce9))
### ❤️ Contributors
- Florian Heuberger (@Flo0806)
- Octavio Araiza (@8ctavio)
- Daniel Roe (@danielroe)
- Robin (@OrbisK)
- shaheer-arbisoft (@shaheer-arbisoft)
- Matej Černý (@cernymatej)
- Francesco Mussoni (@solidusite)
- Danila Poyarkov (@dannote)
- Victor Saa (@vis97c)
- Teages (@Teages)
- Eli Sterken (@eli-sterk)
- Ryota Watanabe (@wattanx)
- Jakub Andrzejewski (@Baroshem)
- edison (@edison1105)
- Max (@onmax)
- Aidan Hibbard (@aidanhibbard)
- Rahul Dogra (@rahuld109)
- Julien Huang (@huang-julien)
- abeer0 (@iiio2)
- James Robert Lund III (@lundjrl)
- Philipp Wagner (@imphil)
- Maxime Pauvert (@maximepvrt)
- Wind (@productdevbook)
- Agatem (@agatemosu)
- Pavel (@eL1fe)
- Alois Sečkár (@AloisSeckar)
- Lucie (@lihbr)
- Sergiu Ravliuc (@YoSoySergio)
- Saeid Zareie (@Saeid-Za)
- Alireza Jahandideh (@Youhan)
- kikuchan (@kikuchan)
- Ragura (@Ragura)
- Josh Deltener (@hecktarzuli)
- Teena (@franklin-tina)
- Frederik Bußmann (@freb97)
- Benjamin Oddou (@BenjaminOddou)
- Mukund Shah (@mukundshah)
- Jessé Correia Lins (@linspw)
- Jannik Sohn (@janniksohn)
- Dawit (@oneminch)
- Ali Sokkar (@NyllRE)
- Horu (@HigherOrderLogic)
- Anthony Fu (@antfu)
- Harlan Wilton (@harlan-zw)
- Alexander Lichter (@TheAlexLichter)
- Ryan Wilson (@rywils)
- Hugo (@HugoRCD)
- yamachi4416 (@yamachi4416)
> 3.21.0 is the next minor release.
Nuxt 4.3 and 3.21 bring powerful new features for layouts, caching, and developer experience – plus significant performance improvements under the hood.
## 📣 Some News
### Extended v3 Support
Early this month, I [opened a discussion](https://github.com/nuxt/nuxt/discussions/33918) to find out how the upgrade had gone from v3 to v4. I was really pleased to hear how well it had gone for most people.
Having said that, we're committed to making sure no one gets left behind. And so we will **continue to provide security updates and critical bug fix releases** beyond the previously announced end-of-life date of January 31, 2026, meaning Nuxt v3 will meet its end-of-life on July 31, 2026.
> [!TIP]
> As usual, today also brings a minor release for v3, with many of the same improvements backported from v4.3.
### Preparing for Nuxt 5
We're closer than ever to the releases of Nuxt v5 and Nitro v3. In the coming weeks, the `main` branch of the Nuxt repository will begin receiving initial commits for Nuxt 5. However, it's still **business as usual**.
- Continue making pull requests to the `main` branch
- We'll backport changes to the `4.x` and `3.x` branches
Keep an eye out on the [Upgrade Guide](https://nuxt.com/docs/4.x/getting-started/upgrade) – we'll be adding details about how you can already start migrating your projects to prepare for Nuxt v4 with `future.compatibilityVersion: 5`.
## 🗂️ Route Rule Layouts
But that's enough about the future. We have a lot of good things for you today!
First, you can now set layouts directly in route rules using the new `appLayout` property ([#31092](https://github.com/nuxt/nuxt/pull/31092)). This provides a centralized, declarative way to manage layouts across your application without scattering `definePageMeta` calls throughout your pages.
```ts [nuxt.config.ts]
export default defineNuxtConfig({
routeRules: {
'/admin/**': { appLayout: 'admin' },
'/dashboard/**': { appLayout: 'dashboard' },
'/auth/**': { appLayout: 'minimal' }
}
})
```
This might be useful for:
- Admin panels with a shared layout across many routes
- Marketing pages that need a different layout from the app
> [!TIP]
> Plus, you can pass props to layouts now! See [the `setPageLayout` improvements below](#layout-props-with-setpagelayout).
## 📦 ISR/SWR Payload Extraction
Payload extraction now works with ISR (incremental static regeneration), SWR (stale-while-revalidate) and cache `routeRules` ([#33467](https://github.com/nuxt/nuxt/pull/33467)). Previously, only pre-rendered pages could generate `_payload.json` files.
This means:
- Client-side navigation to ISR/SWR pages can use cached payloads
- CDNs (Vercel, Netlify, Cloudflare) can cache payload files alongside HTML
- Fewer API calls during navigation – data can be prefetched and served from the cached payload
```ts [nuxt.config.ts]
export default defineNuxtConfig({
routeRules: {
'/products/**': {
isr: 3600, // Revalidate every hour
}
}
})
```
## 🧹 Dev Mode Payload Extraction
Related to the above, payload extraction now also works in development mode ([#30784](https://github.com/nuxt/nuxt/pull/30784)). This makes it easier to test and debug payload behavior without needing to run a production build.
> [!IMPORTANT]
> Payload extraction works in dev mode with `nitro.static` set to `true`, or for individual pages which have `isr`, `swr`, `prerender` or `cache` route rules.
## 🚫 Disable Modules from Layers
When extending Nuxt layers, you can now disable specific modules that you don't need ([#33883](https://github.com/nuxt/nuxt/pull/33883)). Just pass `false` to the module's options:
```ts [nuxt.config.ts]
export default defineNuxtConfig({
extends: ['../shared-layer'],
// disable @nuxt/image from layer
image: false,
})
```
## 🏷️ Route Groups in Page Meta
[Route groups](https://nuxt.com/docs/4.x/directory-structure/app/pages#route-groups) (folders wrapped in parentheses like `(protected)/`) are now exposed in page meta ([#33460](https://github.com/nuxt/nuxt/pull/33460)). This makes it easy to check which groups a route belongs to in middleware or anywhere you have access to the route.
```vue [pages/(protected)/dashboard.vue]
```
```ts [middleware/auth.ts]
export default defineNuxtRouteMiddleware((to) => {
if (to.meta.groups?.includes('protected') && !isAuthenticated()) {
return navigateTo('/login')
}
})
```
This provides a clean, convention-based approach to route-level authorization without needing to add `definePageMeta` to every protected page.
## 🎨 Layout Props with `setPageLayout`
The `setPageLayout` composable now accepts a second parameter to pass props to your layout ([#33805](https://github.com/nuxt/nuxt/pull/33805)):
```ts [middleware/admin.ts]
export default defineNuxtRouteMiddleware((to) => {
setPageLayout('admin', {
sidebar: true,
theme: 'dark'
})
})
```
```vue [layouts/admin.vue]
```
## 🔧 `#server` Alias
A new `#server` alias provides clean imports within your server directory ([#33870](https://github.com/nuxt/nuxt/pull/33870)), similar to how `#shared` works:
```ts [server/api/users/[id]/profile.ts]
// Before: relative path hell
import { helper } from '../../../../utils/helper'
// After: clean and predictable
import { helper } from '#server/utils/helper'
```
The alias includes import protection – you can't accidentally import `#server` code from client or shared contexts.
## 🪟 Draggable Error Overlay
The development error overlay introduced in Nuxt 4.2 is now draggable and can be minimized ([#33695](https://github.com/nuxt/nuxt/pull/33695)). You can:
- Drag it to any corner of the screen (it snaps to edges)
- Minimize it to a small pill button when you want to keep working
- Your position and minimized state persist across page reloads
This is a quality-of-life improvement when you're iterating on fixes and don't want the overlay blocking your view.
https://github.com/user-attachments/assets/nuxt_4-3_error_demo.mp4
## ⚙️ Async Plugin Constructors
Module authors can now use async functions when adding build plugins ([#33619](https://github.com/nuxt/nuxt/pull/33619)):
```ts [modules/my-module.ts]
export default defineNuxtModule({
async setup() {
// Lazy load only when actually needed
addVitePlugin(() => import('my-cool-plugin').then(r => r.default()))
// No need to load webpack plugin if using Vite
addWebpackPlugin(() => import('my-cool-plugin/webpack').then(r => r.default()))
}
})
```
This enables true lazy loading of build plugins, avoiding unnecessary code loading when plugins aren't needed.
## 🚀 Performance Improvements
This release includes several performance optimizations for faster builds:
- **Hook filters** - Internal plugins now use filters to avoid running hooks unnecessarily ([#33898](https://github.com/nuxt/nuxt/pull/33898))
- **SSR styles optimization** - The `nuxt:ssr-styles` plugin is now significantly faster ([#33862](https://github.com/nuxt/nuxt/pull/33862), [#33865](https://github.com/nuxt/nuxt/pull/33865))
- **Layer alias transform** - Skipped when using Vite (it handles this natively) ([#33864](https://github.com/nuxt/nuxt/pull/33864))
- **Route rules compilation** - Route rules are now compiled into a client chunk using `rou3`, removing the need for `radix3` in the client bundle and eliminating app manifest fetches ([#33920](https://github.com/nuxt/nuxt/pull/33920))
## 🎨 Inline Styles for Webpack/Rspack
The `inlineStyles` feature now works with webpack and rspack builders ([#33966](https://github.com/nuxt/nuxt/pull/33966)), not just Vite. This enables critical CSS inlining for better Core Web Vitals regardless of your bundler choice.
## ⚠️ Deprecations
### `statusCode` → `status`, `statusMessage` → `statusText`
In preparation for Nitro v3 and H3 v2, we're moving to use Web API naming conventions ([#33912](https://github.com/nuxt/nuxt/pull/33912)). The old properties still work but are deprecated in advance of v5:
```diff
- throw createError({ statusCode: 404, statusMessage: 'Not Found' })
+ throw createError({ status: 404, statusText: 'Not Found' })
```
## 🐛 Bug Fixes
Notable fixes in this release:
- Fixed head component deduplication using `key` attribute ([#33958](https://github.com/nuxt/nuxt/pull/33958), [#33963](https://github.com/nuxt/nuxt/pull/33963))
- Fixed async data properties not being reactive in Options API ([#34119](https://github.com/nuxt/nuxt/pull/34119))
- Fixed `useCookie` unsafe number parsing during decode ([#34007](https://github.com/nuxt/nuxt/pull/34007))
- Fixed `NuxtPage` not re-rendering when nested `NuxtLayout` has layouts disabled ([#34078](https://github.com/nuxt/nuxt/pull/34078))
- Fixed client-side pathname decoding for non-ASCII route aliases ([#34043](https://github.com/nuxt/nuxt/pull/34043))
- Fixed suspense remounting when navigating after pending state ([#33991](https://github.com/nuxt/nuxt/pull/33991))
- Fixed clipboard copy in error overlay ([#33873](https://github.com/nuxt/nuxt/pull/33873))
- Enabled `allowArbitraryExtensions` by default in TypeScript config ([#34084](https://github.com/nuxt/nuxt/pull/34084))
- Added `noUncheckedIndexedAccess` to server tsconfig for safer typing ([#33985](https://github.com/nuxt/nuxt/pull/33985))
> [!IMPORTANT]
> Enabling `noUncheckedIndexedAccess` in the Nitro server TypeScript config improves type safety but may surface new type errors in your server code. This change was necessary because Nuxt's app context performs type checks on server routes ([learn more](https://nuxt.com/docs/4.x/guide/modules/recipes-advanced#known-limitations)).
>
> While we recommend keeping this enabled for better type safety, you can disable it if needed:
>
> ```ts
> export default defineNuxtConfig({
> nitro: {
> typescript: {
> tsConfig: {
> compilerOptions: {
> noUncheckedIndexedAccess: false
> }
> }
> }
> }
> })
> ```
>
> Note that disabling this may allow type errors to slip through that could cause runtime issues with indexed access.
## 📚 Documentation
- Improved module author guides with clearer structure ([#33803](https://github.com/nuxt/nuxt/pull/33803))
- Added MCP setup instructions for Claude Desktop ([#33914](https://github.com/nuxt/nuxt/pull/33914))
- Added layers directory documentation ([#33967](https://github.com/nuxt/nuxt/pull/33967))
- Added Deno package manager examples ([#34070](https://github.com/nuxt/nuxt/pull/34070))
- Clarified type-checking context limitations for server routes ([#33964](https://github.com/nuxt/nuxt/pull/33964))
## 🎉 Nuxt 3.21.0
Alongside v4.3.0, we're releasing **Nuxt v3.21.0** with many of the same improvements backported to the 3.x branch. This release includes:
- **All the same features**: Route rule layouts, ISR payload extraction, layout props with `setPageLayout`, `#server` alias, draggable error overlay, and more
- **All performance improvements**: SSR styles optimization, hook filters, and route rules compilation
- **Module disabling**: Disable layer modules by setting options to `false`
- **Critical bug fixes**: Async data reactivity in Options API, `useCookie` number parsing, head component deduplication, and more
## ✅ Upgrading
Our recommendation for upgrading is to run:
```sh
npx nuxt@latest upgrade --dedupe --channel=v3
```
This will deduplicate your lockfile and help ensure you pull in updates from other dependencies that Nuxt relies on, particularly in the unjs ecosystem.
> [!TIP]
> Check out our [upgrade guide](https://nuxt.com/docs/getting-started/upgrade) if upgrading from an older version.
## 👉 Changelog
[compare changes](https://github.com/nuxt/nuxt/compare/v3.20.2...v3.21.0)
### 🚀 Enhancements
- **kit:** Support async constructor for adding plugins ([#33619](https://github.com/nuxt/nuxt/pull/33619))
- **kit:** Export Nuxt major version type ([#33700](https://github.com/nuxt/nuxt/pull/33700))
- **schema:** Add `#server` alias for server directory imports ([#33870](https://github.com/nuxt/nuxt/pull/33870))
- **schema:** Hoist nitro `crossws` types ([6ff79ea6c](https://github.com/nuxt/nuxt/commit/6ff79ea6c))
- **nitro,nuxt:** Compile route rules into client chunk ([#33920](https://github.com/nuxt/nuxt/pull/33920))
- **nuxt:** Allow disabling modules by setting module options to `false` ([#33883](https://github.com/nuxt/nuxt/pull/33883))
- **kit:** Allow specifying `moduleDependencies` as an async function ([#33504](https://github.com/nuxt/nuxt/pull/33504))
- **nuxt:** Support `appLayout` in route rules ([#31092](https://github.com/nuxt/nuxt/pull/31092))
- **nuxt:** Add route groups to page meta ([#33460](https://github.com/nuxt/nuxt/pull/33460))
- **nuxt:** Enable payload extraction for ISR/SWR routes ([#33467](https://github.com/nuxt/nuxt/pull/33467))
- **nuxt:** Allow updating props with `setPageLayout` ([#33805](https://github.com/nuxt/nuxt/pull/33805))
- **nuxt:** Enable dragging and minimizing for error overlay ([#33695](https://github.com/nuxt/nuxt/pull/33695))
- **nitro,nuxt:** Add support for payload extraction in dev ([#30784](https://github.com/nuxt/nuxt/pull/30784))
- **rspack,webpack:** Add inline styles ([#33966](https://github.com/nuxt/nuxt/pull/33966))
- **kit:** Add forward-compatible nitro types ([#34036](https://github.com/nuxt/nuxt/pull/34036))
### 🔥 Performance
- **nuxt:** Do not init layer alias transform when using vite ([#33864](https://github.com/nuxt/nuxt/pull/33864))
- **vite:** Add hook filters for ssr styles plugin ([#33865](https://github.com/nuxt/nuxt/pull/33865))
- **vite:** Optimize `nuxt:ssr-styles` plugin ([#33862](https://github.com/nuxt/nuxt/pull/33862))
- **nuxt:** Use filter for vfs plugin load ([5bd8e81ed](https://github.com/nuxt/nuxt/commit/5bd8e81ed))
- **nuxt,vite:** Use filters to avoid running hooks unnecessarily ([e762a1e20](https://github.com/nuxt/nuxt/commit/e762a1e20))
- **nuxt,vite:** Add more filters to internal plugins ([#33898](https://github.com/nuxt/nuxt/pull/33898))
### 🩹 Fixes
- **kit:** Normalize local layer paths with trailing slashes ([#33858](https://github.com/nuxt/nuxt/pull/33858))
- **nuxt:** Avoid overwriting multiple head input in island handler ([#33849](https://github.com/nuxt/nuxt/pull/33849))
- **nuxt:** Update meta instead of calling `router.replace` in page hmr ([#33897](https://github.com/nuxt/nuxt/pull/33897))
- **nuxt:** Don't call `page:loading:end` in cache if already called ([fbbe10133](https://github.com/nuxt/nuxt/commit/fbbe10133))
- **vite:** Add error handling for parsing `NUXT_VITE_NODE_OPTIONS` ([8abb7ef5b](https://github.com/nuxt/nuxt/commit/8abb7ef5b))
- **nuxt:** Do not skip middleware when `appMiddleware` references invalid key ([ed8bb68c5](https://github.com/nuxt/nuxt/commit/ed8bb68c5))
- **nitro:** Clipboard copy in error overlay ([#33873](https://github.com/nuxt/nuxt/pull/33873))
- **webpack,rspack:** Resolve deep imports in virtual files ([#33927](https://github.com/nuxt/nuxt/pull/33927))
- **webpack:** Disable async chunks in dev mode ([c4bfd0a49](https://github.com/nuxt/nuxt/commit/c4bfd0a49))
- **webpack:** Correctly evaluate sourcemap name ([93e3d92b9](https://github.com/nuxt/nuxt/commit/93e3d92b9))
- **nuxt:** Handle node10 resolution for `nuxt/meta` ([b748840bc](https://github.com/nuxt/nuxt/commit/b748840bc))
- **nuxt:** Do not early return if component priorities conflict ([#33955](https://github.com/nuxt/nuxt/pull/33955))
- **nuxt:** Use `key` for tag deduplication in `` component ([#33958](https://github.com/nuxt/nuxt/pull/33958))
- **schema,vite:** Resolve `build.transpile` when initialising vite ([#33868](https://github.com/nuxt/nuxt/pull/33868))
- **nuxt,rspack,webpack:** Inject module identifiers for webpack builders ([#33962](https://github.com/nuxt/nuxt/pull/33962))
- **nuxt:** Add key to head components for proper deduplication ([#33963](https://github.com/nuxt/nuxt/pull/33963))
- **nitro:** Check prettyResponse.body type before error overlay ([#33977](https://github.com/nuxt/nuxt/pull/33977))
- **nuxt:** Don't URI-encode static route paths ([#33990](https://github.com/nuxt/nuxt/pull/33990))
- **nuxt:** Skip internal stub routes from prerender ([#34001](https://github.com/nuxt/nuxt/pull/34001))
- **kit,schema:** Align module `onUpgrade` arguments with types ([#33988](https://github.com/nuxt/nuxt/pull/33988))
- **nuxt:** Handle unsafe number parsing in useCookie decode ([#34007](https://github.com/nuxt/nuxt/pull/34007))
- **nuxt:** Do not externalise `rou3` ([7da94e8c3](https://github.com/nuxt/nuxt/commit/7da94e8c3))
- **nitro:** Add `noUncheckedIndexedAccess` to server tsconfig ([#33985](https://github.com/nuxt/nuxt/pull/33985))
- **nuxt:** Update global reference to globalThis in `useRequestFetch` ([#33976](https://github.com/nuxt/nuxt/pull/33976))
- **vite:** Configure hmr port for server build ([#33929](https://github.com/nuxt/nuxt/pull/33929))
- **kit:** Add forward compatible nitro v3 types ([#34053](https://github.com/nuxt/nuxt/pull/34053))
- **nitro,nuxt:** Do not import nitro deps in builders ([#34054](https://github.com/nuxt/nuxt/pull/34054))
- **nitro:** Add `h3` types to auto-imports ([#34035](https://github.com/nuxt/nuxt/pull/34035))
- **schema:** Add some more directories to ignore ([9cb9a19dd](https://github.com/nuxt/nuxt/commit/9cb9a19dd))
- **nitro:** Also augment `nuxt/schema` ([9b40196a6](https://github.com/nuxt/nuxt/commit/9b40196a6))
- **nuxt:** Make asyncData properties reactive in Options API ([#34119](https://github.com/nuxt/nuxt/pull/34119))
- **nuxt:** Rerender `NuxtPage` when nested `NuxtLayout` has explicitly disabled layouts ([#34078](https://github.com/nuxt/nuxt/pull/34078))
- **nuxt,schema:** Clean up types ([5ce351d0f](https://github.com/nuxt/nuxt/commit/5ce351d0f))
- **nuxt:** Allow user augmentation of runtime config ([dd30410cb](https://github.com/nuxt/nuxt/commit/dd30410cb))
- **kit,nitro:** Enable `allowArbitraryExtensions` by default ([#34084](https://github.com/nuxt/nuxt/pull/34084))
- **nuxt:** Decode client-side pathname for non-ASCII route aliases ([#34043](https://github.com/nuxt/nuxt/pull/34043))
- **nuxt:** Force remount suspense when navigating after pending ([#33991](https://github.com/nuxt/nuxt/pull/33991))
- **nuxt:** Add documentation link to server builder error message ([#34122](https://github.com/nuxt/nuxt/pull/34122))
- **nuxt:** Validate placeholder/fallback tags + warn about placeholder/fallback props ([f7912d3f3](https://github.com/nuxt/nuxt/commit/f7912d3f3))
- **nuxt:** Force flush `useAsyncData` debounced execute post watcher flush ([#34125](https://github.com/nuxt/nuxt/pull/34125))
- **nitro:** Process isr/swr/cache keys ([7f2bf4d13](https://github.com/nuxt/nuxt/commit/7f2bf4d13))
- **nuxt:** Add `typeFrom` support for `imports.d.ts` template exports ([#34135](https://github.com/nuxt/nuxt/pull/34135))
- **nuxt:** Ensure we inline styles for `hydrate-never` components ([#34132](https://github.com/nuxt/nuxt/pull/34132))
### 💅 Refactors
- **kit:** Add explicit return types for kit utilities ([ec2239cb4](https://github.com/nuxt/nuxt/commit/ec2239cb4))
- **nitro,nuxt,schema,vite:** Provide explicit return types ([2564002de](https://github.com/nuxt/nuxt/commit/2564002de))
- **kit,nuxt,schema:** Use named imports from `defu` + `consola` ([e31668f67](https://github.com/nuxt/nuxt/commit/e31668f67))
- Add explicit `.ts` file extensions to relative imports ([458f3c9b6](https://github.com/nuxt/nuxt/commit/458f3c9b6))
- **kit,nitro,nuxt,schema:** Reduce barrels + move `<>` to `as` ([08f72881e](https://github.com/nuxt/nuxt/commit/08f72881e))
- **nitro,nuxt:** Use `~` prefix for internal ssrContext properties ([#33896](https://github.com/nuxt/nuxt/pull/33896))
- **nitro:** Add explicit return types for runtime utils ([74bb6ddeb](https://github.com/nuxt/nuxt/commit/74bb6ddeb))
- **nitro:** Move tree-shaken flags from replace plugin -> vfs ([#33907](https://github.com/nuxt/nuxt/pull/33907))
- **nitro,nuxt,vite,webpack:** Use `status`/`statusText` + deprecate old props ([#33912](https://github.com/nuxt/nuxt/pull/33912))
- **webpack:** Use RuntimeModule API for chunk preloads ([#33930](https://github.com/nuxt/nuxt/pull/33930))
- **nuxt:** Use AST-aware function key injection ([#33446](https://github.com/nuxt/nuxt/pull/33446))
- **nitro,nuxt,schema:** Use augments for nitro schema types ([#34039](https://github.com/nuxt/nuxt/pull/34039))
- **nitro,rspack,vite,webpack:** Move cors handling -> nitro builder ([#34048](https://github.com/nuxt/nuxt/pull/34048))
- **nitro:** Move to `nitropack/runtime` namespace ([b06d53166](https://github.com/nuxt/nuxt/commit/b06d53166))
- **nitro,nuxt:** Move to `nitropack/runtime` namespace ([897a2259f](https://github.com/nuxt/nuxt/commit/897a2259f))
### 📖 Documentation
- Fix `useHead` return type ([#33857](https://github.com/nuxt/nuxt/pull/33857))
- Add correct instructions to upgrade to latest Nuxt 3.x ([#33866](https://github.com/nuxt/nuxt/pull/33866))
- Improve grammar ([#34093](https://github.com/nuxt/nuxt/pull/34093))
- Use h2 for nuxt add command page ([a0a1763d5](https://github.com/nuxt/nuxt/commit/a0a1763d5))
- Update links to module guide ([c9c1282f8](https://github.com/nuxt/nuxt/commit/c9c1282f8))
- Split and improve `Module Author Guides` ([#33803](https://github.com/nuxt/nuxt/pull/33803))
- Split directory structure and re-order guides (v4) ([#33691](https://github.com/nuxt/nuxt/pull/33691))
- Add mcp server and llms.txt ([#33371](https://github.com/nuxt/nuxt/pull/33371))
- Add note that middleware doesn't run when rendering islands ([d22cf7903](https://github.com/nuxt/nuxt/commit/d22cf7903))
- Add note on default branch for layers ([#33919](https://github.com/nuxt/nuxt/pull/33919))
- Add mcp setup instructions for claude desktop ([#33914](https://github.com/nuxt/nuxt/pull/33914))
- Mention deno as package manager ([#33875](https://github.com/nuxt/nuxt/pull/33875))
- Clarify purpose of `statusText` ([#32834](https://github.com/nuxt/nuxt/pull/32834))
- Update lychee config and remove medium article link ([36c19ce73](https://github.com/nuxt/nuxt/commit/36c19ce73))
- Update module count and fix typo ([#33950](https://github.com/nuxt/nuxt/pull/33950))
- Add DeepWiki badge ([#33508](https://github.com/nuxt/nuxt/pull/33508))
- Give example of usage of `defineWrappedResponseHandler` ([#33952](https://github.com/nuxt/nuxt/pull/33952))
- Provide cleaner example code for vitest projects ([#33960](https://github.com/nuxt/nuxt/pull/33960))
- Update yarn create command ([b30432979](https://github.com/nuxt/nuxt/commit/b30432979))
- Update roadmap with a11y ([7ea35137c](https://github.com/nuxt/nuxt/commit/7ea35137c))
- Add a11y release ([#34041](https://github.com/nuxt/nuxt/pull/34041))
- Remove Nuxtr from recommendations ([#34045](https://github.com/nuxt/nuxt/pull/34045))
- Remove duplicate feature ([#34058](https://github.com/nuxt/nuxt/pull/34058))
- Provide deno package manager examples ([#34070](https://github.com/nuxt/nuxt/pull/34070))
- Make custom wrapper recipe link more prominent ([#34085](https://github.com/nuxt/nuxt/pull/34085))
- **nuxt:** Mention custom serializers in `useState` docs ([#34105](https://github.com/nuxt/nuxt/pull/34105))
- Clarify module setups in `.nuxtrc` example ([#34107](https://github.com/nuxt/nuxt/pull/34107))
- Add layers directory documentation ([#33967](https://github.com/nuxt/nuxt/pull/33967))
- Add a tip for `appLayout` ([9b78698c3](https://github.com/nuxt/nuxt/commit/9b78698c3))
- Add docs for disabling modules by passing `false` to its options ([18500730c](https://github.com/nuxt/nuxt/commit/18500730c))
- Add info about caching payloads with isr/swr ([4b055548e](https://github.com/nuxt/nuxt/commit/4b055548e))
- Add example for async addVitePlugin ([4407f6862](https://github.com/nuxt/nuxt/commit/4407f6862))
- Add example of passing props to layouts ([401aa90ab](https://github.com/nuxt/nuxt/commit/401aa90ab))
- Mark vite plugin as not typed ([25eae7699](https://github.com/nuxt/nuxt/commit/25eae7699))
- Add warning about `source` from `` ([08778c98c](https://github.com/nuxt/nuxt/commit/08778c98c))
- Sync with main branch ([e8c04aaa6](https://github.com/nuxt/nuxt/commit/e8c04aaa6))
- Fix ai guide link ([01c173b78](https://github.com/nuxt/nuxt/commit/01c173b78))
### 📦 Build
- Remove babel debugging plugin from jiti stub options ([1ec010681](https://github.com/nuxt/nuxt/commit/1ec010681))
- **vite:** Add build entries for `vite-node` entrypoints ([#33893](https://github.com/nuxt/nuxt/pull/33893))
- **nuxt:** Tidy up subpath export types ([fe92e9c17](https://github.com/nuxt/nuxt/commit/fe92e9c17))
- Use `obuild` except for nuxt + nitro-server packages ([#34049](https://github.com/nuxt/nuxt/pull/34049))
- **schema:** Fix `/builder-env` subpath types ([1951648fa](https://github.com/nuxt/nuxt/commit/1951648fa))
### 🏡 Chore
- Add return types to debug plugins ([1d4f9a3ae](https://github.com/nuxt/nuxt/commit/1d4f9a3ae))
- Add `build:stub` command for those that need it ([c682b2681](https://github.com/nuxt/nuxt/commit/c682b2681))
- Revert change to how type augments are inserted ([6a238b576](https://github.com/nuxt/nuxt/commit/6a238b576))
- Do not require aligned columns in tables ([d8a90b3d5](https://github.com/nuxt/nuxt/commit/d8a90b3d5))
- Update eslint config rule ([d87ed519a](https://github.com/nuxt/nuxt/commit/d87ed519a))
- Explicitly import `node:process` ([#33982](https://github.com/nuxt/nuxt/pull/33982))
- Add root scripts to lint context ([ee83838b4](https://github.com/nuxt/nuxt/commit/ee83838b4))
- Tidy up configs ([ab131b464](https://github.com/nuxt/nuxt/commit/ab131b464))
- Add `.nuxtrc` with test-utils setup ([b5879351f](https://github.com/nuxt/nuxt/commit/b5879351f))
- Add eslint ignore ([87811234d](https://github.com/nuxt/nuxt/commit/87811234d))
- Upgrade `vite-node` separately from `vitest` ([8114e886f](https://github.com/nuxt/nuxt/commit/8114e886f))
- Lint docs with eslint ([d2d5f6733](https://github.com/nuxt/nuxt/commit/d2d5f6733))
- Lint ([b9df0e847](https://github.com/nuxt/nuxt/commit/b9df0e847))
- Lint ([0efcf01fa](https://github.com/nuxt/nuxt/commit/0efcf01fa))
### ✅ Tests
- Update tests for new version of nuxt/test-utils ([#33842](https://github.com/nuxt/nuxt/pull/33842))
- Avoid unnecessary tick ([fb4720840](https://github.com/nuxt/nuxt/commit/fb4720840))
- Add regression test for asyncData HMR ([#32182](https://github.com/nuxt/nuxt/pull/32182))
- Add test for page hmr resetting state ([#32418](https://github.com/nuxt/nuxt/pull/32418))
- Add reproduction for vite pre-transform error ([#31574](https://github.com/nuxt/nuxt/pull/31574))
- Add regression test for #32154 ([#32154](https://github.com/nuxt/nuxt/issues/32154))
- Use `vi.hoisted` for klona mock ([#34113](https://github.com/nuxt/nuxt/pull/34113))
- Update bundle size ([e6c8d10c6](https://github.com/nuxt/nuxt/commit/e6c8d10c6))
- Fix paths in hmr test ([3b8b2138a](https://github.com/nuxt/nuxt/commit/3b8b2138a))
- Update snapshots ([51c83b8ec](https://github.com/nuxt/nuxt/commit/51c83b8ec))
- Update bundle size ([22708c05c](https://github.com/nuxt/nuxt/commit/22708c05c))
### 🤖 CI
- Directly call webhook url ([4eedbcae5](https://github.com/nuxt/nuxt/commit/4eedbcae5))
- Use new reusable triage workflows ([#34072](https://github.com/nuxt/nuxt/pull/34072))
- Use new shared dependency review workflow ([9e6770f18](https://github.com/nuxt/nuxt/commit/9e6770f18))
### ❤️ Contributors
- Daniel Roe (@danielroe)
- Florian Heuberger (@Flo0806)
- Octavio Araiza (@8ctavio)
- Robin (@OrbisK)
- shaheer-arbisoft (@shaheer-arbisoft)
- Francesco Mussoni (@solidusite)
- Danila Poyarkov (@dannote)
- Teages (@Teages)
- Anthony Fu (@antfu)
- Eli Sterken (@eli-sterk)
- Ryota Watanabe (@wattanx)
- edison (@edison1105)
- Max (@onmax)
- Rahul Dogra (@rahuld109)
- abeer0 (@iiio2)
- Philipp Wagner (@imphil)
- Maxime Pauvert (@maximepvrt)
- Wind (@productdevbook)
- Agatem (@agatemosu)
- Pavel (@eL1fe)
- Lucie (@lihbr)
- Sergiu Ravliuc (@YoSoySergio)
- Julien Huang (@huang-julien)
- Saeid Zareie (@Saeid-Za)
- Alireza Jahandideh (@Youhan)
- kikuchan (@kikuchan)
- Ragura (@Ragura)
- Josh Deltener (@hecktarzuli)
- Teena (@franklin-tina)
- Matej Černý (@cernymatej)
- Frederik Bußmann (@freb97)
- Benjamin Oddou (@BenjaminOddou)
- Mukund Shah (@mukundshah)
- Jessé Correia Lins (@linspw)
- Jannik Sohn (@janniksohn)
- Dawit (@oneminch)
- Ali Sokkar (@NyllRE)
- Horu (@HigherOrderLogic)
- Hugo (@HugoRCD)
- Sébastien Chopin (@atinux)
- David Stack (@davidstackio)
- Ruslan Stelmachenko (@xak2000)
- Harlan Wilton (@harlan-zw)
- Alexander Lichter (@TheAlexLichter)
- Ryan Wilson (@rywils)
- yamachi4416 (@yamachi4416)
> 4.2.2 is the next patch release.
## ✅ Upgrading
Our recommendation for upgrading is to run:
```sh
npx nuxt upgrade --dedupe
```
This will deduplicate your lockfile as well, and help ensure that you pull in updates from other dependencies that Nuxt relies on, particularly in the unjs ecosystem.
## 👉 Changelog
[compare changes](https://github.com/nuxt/nuxt/compare/v4.2.1...v4.2.2)
### 🩹 Fixes
- **nitro:** Do not show pretty error handler when testing ([243261edb](https://github.com/nuxt/nuxt/commit/243261edb))
- **nuxt:** Generate valid references for component declaration items ([#33388](https://github.com/nuxt/nuxt/pull/33388))
- **nuxt:** Sync internal route before calling `page:finish` hook ([#33707](https://github.com/nuxt/nuxt/pull/33707))
- **kit:** Add TypeScript path alias support for test files ([#33672](https://github.com/nuxt/nuxt/pull/33672))
- **nitro:** Ensure html is a string before injecting error handler ([f70b70c97](https://github.com/nuxt/nuxt/commit/f70b70c97))
- **nitro:** Include layer server directories in `tsconfig.server.json` ([#33510](https://github.com/nuxt/nuxt/pull/33510))
- **nuxt:** Ensure deduped async data executions return latest promise ([#33740](https://github.com/nuxt/nuxt/pull/33740))
- **kit,nuxt:** Type + respect `moduleDependencies` by meta name ([#33774](https://github.com/nuxt/nuxt/pull/33774))
- **nuxt,schema:** Ignore `.d.vue.ts` declarations ([1c73525a2](https://github.com/nuxt/nuxt/commit/1c73525a2))
- **kit,nuxt:** Protect against resolved nuxt module subpath ([#33767](https://github.com/nuxt/nuxt/pull/33767))
- **nuxt:** Re-execute `callOnce` during HMR ([#33810](https://github.com/nuxt/nuxt/pull/33810))
- **nuxt:** Resolve watch callback after reactive key change in `useAsyncData` ([#33802](https://github.com/nuxt/nuxt/pull/33802))
- **nuxt:** Escape HTML in development error page stack trace ([#33820](https://github.com/nuxt/nuxt/pull/33820))
- **kit:** Do not add resolved `rootDir` to cached layer config ([#33779](https://github.com/nuxt/nuxt/pull/33779))
- **kit,schema:** Add `moduleDependencies` -> `installModule` ([#33689](https://github.com/nuxt/nuxt/pull/33689))
### 💅 Refactors
- **nuxt:** Improve type safety within `callOnce` function ([#33825](https://github.com/nuxt/nuxt/pull/33825))
### 📖 Documentation
- Split directory structure and re-order guides (v4) ([#33691](https://github.com/nuxt/nuxt/pull/33691))
- Add hints release ([#33701](https://github.com/nuxt/nuxt/pull/33701))
- Fix link to vitest globals config ([#33702](https://github.com/nuxt/nuxt/pull/33702))
- Add mcp server and llms.txt ([#33371](https://github.com/nuxt/nuxt/pull/33371))
- Fix 404 link ([98c2f1397](https://github.com/nuxt/nuxt/commit/98c2f1397))
- Text consistency ([#33709](https://github.com/nuxt/nuxt/pull/33709))
- Type `error` as non-optional prop ([#33763](https://github.com/nuxt/nuxt/pull/33763))
- Reformat tables ([#33813](https://github.com/nuxt/nuxt/pull/33813))
### 🏡 Chore
- Update pnpm to 10.21 and enable trust policy ([d2c9711c0](https://github.com/nuxt/nuxt/commit/d2c9711c0))
- Revert pnpm trust policy and restore provenance action ([f9d0e0a3d](https://github.com/nuxt/nuxt/commit/f9d0e0a3d))
- Update markdownlint config to ignore mdc issues ([e7fff7132](https://github.com/nuxt/nuxt/commit/e7fff7132))
- Pin to single version of unstorage ([ec316eae8](https://github.com/nuxt/nuxt/commit/ec316eae8))
### ✅ Tests
- Add `patchProp` and `nodeOps` to excluded Vue helpers ([#33754](https://github.com/nuxt/nuxt/pull/33754))
- Use fake timers for watch params test ([08d9d2f3b](https://github.com/nuxt/nuxt/commit/08d9d2f3b))
### 🤖 CI
- Add `--pnpm` flag to correctly publish prerelease ([#33688](https://github.com/nuxt/nuxt/pull/33688))
- Update action lint config ([#33710](https://github.com/nuxt/nuxt/pull/33710))
### ❤️ Contributors
- Daniel Roe (@danielroe)
- Florian Heuberger (@Flo0806)
- Konstantin Telyakov (@kTelyakov)
- abeer0 (@iiio2)
- Julien Huang (@huang-julien)
- Matej Černý (@cernymatej)
- Robin (@OrbisK)
- Dheeraj Joshi (@dheeraj3587)
- Alexander Lichter (@TheAlexLichter)
- Edwin Samodra (@edwinsamodra)
- edison (@edison1105)
- 山吹色御守 (@KazariEX)
- Sébastien Chopin (@atinux)
- Hugo (@HugoRCD)
- pierreoa (@pierreoa)
- Maxime Pauvert (@maximepvrt)
> 3.20.2 is the next patch release.
## ✅ Upgrading
Our recommendation for upgrading is to run:
```sh
npx nuxt upgrade --dedupe --channel=v3
```
This will deduplicate your lockfile as well, and help ensure that you pull in updates from other dependencies that Nuxt relies on, particularly in the unjs ecosystem.
> [!NOTE]
> This will only work if you _already have_ a version of `@nuxt/cli` which has the `--channel` flag. If this does not work, you can instead run `npx nuxi@latest` for the initial upgrade.
## 👉 Changelog
[compare changes](https://github.com/nuxt/nuxt/compare/v3.20.1...v3.20.2)
### 🩹 Fixes
- **nitro:** Do not show pretty error handler when testing ([cc75ce409](https://github.com/nuxt/nuxt/commit/cc75ce409))
- **nuxt:** Generate valid references for component declaration items ([#33388](https://github.com/nuxt/nuxt/pull/33388))
- **nuxt:** Sync internal route before calling `page:finish` hook ([#33707](https://github.com/nuxt/nuxt/pull/33707))
- **nitro:** Ensure html is a string before injecting error handler ([6f51a25e9](https://github.com/nuxt/nuxt/commit/6f51a25e9))
- **nitro:** Include layer server directories in `tsconfig.server.json` ([#33510](https://github.com/nuxt/nuxt/pull/33510))
- **nuxt:** Ensure deduped async data executions return latest promise ([#33740](https://github.com/nuxt/nuxt/pull/33740))
- **kit,nuxt:** Type + respect `moduleDependencies` by meta name ([#33774](https://github.com/nuxt/nuxt/pull/33774))
- **nuxt,schema:** Ignore `.d.vue.ts` declarations ([9a6a770ab](https://github.com/nuxt/nuxt/commit/9a6a770ab))
- **kit,nuxt:** Protect against resolved nuxt module subpath ([#33767](https://github.com/nuxt/nuxt/pull/33767))
- **nuxt:** Re-execute `callOnce` during HMR ([#33810](https://github.com/nuxt/nuxt/pull/33810))
- **nuxt:** Resolve watch callback after reactive key change in `useAsyncData` ([#33802](https://github.com/nuxt/nuxt/pull/33802))
- **nuxt:** Escape HTML in development error page stack trace ([#33820](https://github.com/nuxt/nuxt/pull/33820))
- **kit:** Do not add resolved `rootDir` to cached layer config ([#33779](https://github.com/nuxt/nuxt/pull/33779))
- **kit,schema:** Add `moduleDependencies` -> `installModule` ([#33689](https://github.com/nuxt/nuxt/pull/33689))
### 💅 Refactors
- **nuxt:** Improve type safety within `callOnce` function ([#33825](https://github.com/nuxt/nuxt/pull/33825))
### 📖 Documentation
- Split directory structure and re-order guides (v3) ([#33690](https://github.com/nuxt/nuxt/pull/33690))
- Fix link ([016ef66e3](https://github.com/nuxt/nuxt/commit/016ef66e3))
- Add hints release ([#33701](https://github.com/nuxt/nuxt/pull/33701))
- Fix link to vitest globals config ([#33702](https://github.com/nuxt/nuxt/pull/33702))
- Fix 404 link ([5543b7cf7](https://github.com/nuxt/nuxt/commit/5543b7cf7))
- Text consistency ([#33709](https://github.com/nuxt/nuxt/pull/33709))
- Type `error` as non-optional prop ([#33763](https://github.com/nuxt/nuxt/pull/33763))
### 🏡 Chore
- Update pnpm to 10.21 and enable trust policy ([1cb55efc0](https://github.com/nuxt/nuxt/commit/1cb55efc0))
- Revert pnpm trust policy and restore provenance action ([103ae1351](https://github.com/nuxt/nuxt/commit/103ae1351))
- Update markdownlint config to ignore mdc issues ([d4933e26e](https://github.com/nuxt/nuxt/commit/d4933e26e))
- Pin to single version of unstorage ([619956e7f](https://github.com/nuxt/nuxt/commit/619956e7f))
### ✅ Tests
- Add `patchProp` and `nodeOps` to excluded Vue helpers ([#33754](https://github.com/nuxt/nuxt/pull/33754))
- Use fake timers for watch params test ([58607fbea](https://github.com/nuxt/nuxt/commit/58607fbea))
- Update test for v3 defaults ([daa002638](https://github.com/nuxt/nuxt/commit/daa002638))
### 🤖 CI
- Add `--pnpm` flag to correctly publish prerelease ([#33688](https://github.com/nuxt/nuxt/pull/33688))
- Update action lint config ([#33710](https://github.com/nuxt/nuxt/pull/33710))
### ❤️ Contributors
- Daniel Roe (@danielroe)
- Alexander Lichter (@TheAlexLichter)
- Florian Heuberger (@Flo0806)
- Konstantin Telyakov (@kTelyakov)
- abeer0 (@iiio2)
- Julien Huang (@huang-julien)
- Robin (@OrbisK)
- Dheeraj Joshi (@dheeraj3587)
- Edwin Samodra (@edwinsamodra)
- edison (@edison1105)
- 山吹色御守 (@KazariEX)
- Sébastien Chopin (@atinux)
- pierreoa (@pierreoa)
- Maxime Pauvert (@maximepvrt)
> **4.2.1** is the next patch release.
## ✅ Upgrading
Our recommendation for upgrading is to run:
```sh
npx nuxt upgrade --dedupe
```
This will deduplicate your lockfile as well, and help ensure that you pull in updates from other dependencies that Nuxt relies on, particularly in the unjs ecosystem.
## 👉 Changelog
[compare changes](https://github.com/nuxt/nuxt/compare/v4.2.0...v4.2.1)
### 🩹 Fixes
- **kit,nuxt,schema:** Deprecate `ImportPresetWithDeprecation` ([#33596](https://github.com/nuxt/nuxt/pull/33596))
- **nuxt:** Correct warning message for prefetch/noPrefetch conflict ([#33617](https://github.com/nuxt/nuxt/pull/33617))
- **nitro:** Remove `` iframe border ([#33625](https://github.com/nuxt/nuxt/pull/33625))
- **vite:** Use rolldown replace only in build ([#33615](https://github.com/nuxt/nuxt/pull/33615))
- **nitro:** Use directory paths in `moduleEntryPaths` ([#33628](https://github.com/nuxt/nuxt/pull/33628))
- **nitro:** Start error overlay minimized based on status code ([#33658](https://github.com/nuxt/nuxt/pull/33658))
- **vite:** Ensure `optimizeDeps` config is applied before other plugins ([#33586](https://github.com/nuxt/nuxt/pull/33586))
- **nuxt:** Respect layer priority order for scanned components ([#33654](https://github.com/nuxt/nuxt/pull/33654))
- **nuxt:** Process prerender routes on `pages:resolved` ([#33662](https://github.com/nuxt/nuxt/pull/33662))
- **nuxt:** Remove abort signal event listeners after render ([#33665](https://github.com/nuxt/nuxt/pull/33665))
- **nuxt:** Cleanup event listener with cleanup signal ([#33667](https://github.com/nuxt/nuxt/pull/33667))
- **vite:** Update `vite-node` ([#33663](https://github.com/nuxt/nuxt/pull/33663))
- **vite:** Respect vite proxy in dev middleware ([#33670](https://github.com/nuxt/nuxt/pull/33670))
### 💅 Refactors
- **kit,nitro,nuxt,schema,vite:** Explicitly import process/performance ([#33650](https://github.com/nuxt/nuxt/pull/33650))
### 📖 Documentation
- Fix typo in eslint flat config description ([#33569](https://github.com/nuxt/nuxt/pull/33569))
- Add signal support to useAsyncData examples ([#33601](https://github.com/nuxt/nuxt/pull/33601))
- Document `pending` as alias of `status === 'pending'` ([#33221](https://github.com/nuxt/nuxt/pull/33221))
- Note that `cookieStore` is `true` by default ([#33572](https://github.com/nuxt/nuxt/pull/33572))
- Add information on types for server context ([#33511](https://github.com/nuxt/nuxt/pull/33511))
- Mark webstorm issue resolved ([#33608](https://github.com/nuxt/nuxt/pull/33608))
- Clarify route middleware doesn't affect API routes ([#33643](https://github.com/nuxt/nuxt/pull/33643))
- Improve docs for `useHead`/`useHydration`/`useLazy*` ([#33626](https://github.com/nuxt/nuxt/pull/33626))
- Update link to nitro source to v2 branch ([08018af4f](https://github.com/nuxt/nuxt/commit/08018af4f))
- Add typescript documentation for module authors ([#33637](https://github.com/nuxt/nuxt/pull/33637))
- Typo ([#33655](https://github.com/nuxt/nuxt/pull/33655))
### 🏡 Chore
- Update URLs ([#33567](https://github.com/nuxt/nuxt/pull/33567))
- Add `verifyDepsBeforeRun: install` ([#33603](https://github.com/nuxt/nuxt/pull/33603))
- Reduce redirects in docs links ([1cc539325](https://github.com/nuxt/nuxt/commit/1cc539325))
- Lint docs ([0b5fa5dea](https://github.com/nuxt/nuxt/commit/0b5fa5dea))
### 🤖 CI
- Disable cache in release action ([ff37598bc](https://github.com/nuxt/nuxt/commit/ff37598bc))
### ❤️ Contributors
- Daniel Roe (@danielroe)
- Anthony Fu (@antfu)
- Robin (@OrbisK)
- abeer0 (@iiio2)
- Bobbie Goede (@BobbieGoede)
- Florian Heuberger (@Flo0806)
- Matej Černý (@cernymatej)
- Peter Budai (@peterbud)
- Julien Huang (@huang-julien)
- Max (@onmax)
- 纸鹿/Zhilu (@L33Z22L11)
- Hinata Oishi (@te19oishi)
- Damian Głowala (@DamianGlowala)
- Maxime Pauvert (@maximepvrt)
- Raed Abdennadher (@RaedAbr)
> 3.20.1 is the next patch release.
## ✅ Upgrading
Our recommendation for upgrading is to run:
```sh
npx nuxt upgrade --dedupe --channel=v3
```
This will deduplicate your lockfile as well, and help ensure that you pull in updates from other dependencies that Nuxt relies on, particularly in the unjs ecosystem.
## 👉 Changelog
[compare changes](https://github.com/nuxt/nuxt/compare/v3.20.0...v3.20.1)
### 🩹 Fixes
- **vite:** Unset `optimizeDeps.include` for server environment ([#33550](https://github.com/nuxt/nuxt/pull/33550))
- **kit,nuxt,schema:** Deprecate `ImportPresetWithDeprecation` ([#33596](https://github.com/nuxt/nuxt/pull/33596))
- **nuxt:** Correct warning message for prefetch/noPrefetch conflict ([#33617](https://github.com/nuxt/nuxt/pull/33617))
- **nitro:** Remove `` iframe border ([#33625](https://github.com/nuxt/nuxt/pull/33625))
- **vite:** Use rolldown replace only in build ([#33615](https://github.com/nuxt/nuxt/pull/33615))
- **nitro:** Use directory paths in `moduleEntryPaths` ([#33628](https://github.com/nuxt/nuxt/pull/33628))
- **nitro:** Start error overlay minimized based on status code ([#33658](https://github.com/nuxt/nuxt/pull/33658))
- **vite:** Ensure `optimizeDeps` config is applied before other plugins ([#33586](https://github.com/nuxt/nuxt/pull/33586))
- **nuxt:** Respect layer priority order for scanned components ([#33654](https://github.com/nuxt/nuxt/pull/33654))
- **nuxt:** Process prerender routes on `pages:resolved` ([#33662](https://github.com/nuxt/nuxt/pull/33662))
- **nuxt:** Remove abort signal event listeners after render ([#33665](https://github.com/nuxt/nuxt/pull/33665))
- **nuxt:** Cleanup event listener with cleanup signal ([#33667](https://github.com/nuxt/nuxt/pull/33667))
- **vite:** Respect vite proxy in dev middleware ([#33670](https://github.com/nuxt/nuxt/pull/33670))
### 💅 Refactors
- **kit,nitro,nuxt,schema,vite:** Explicitly import process/performance ([#33650](https://github.com/nuxt/nuxt/pull/33650))
### 📖 Documentation
- Fix typo in eslint flat config description ([#33569](https://github.com/nuxt/nuxt/pull/33569))
- Add signal support to useAsyncData examples ([#33601](https://github.com/nuxt/nuxt/pull/33601))
- Note that `cookieStore` is `true` by default ([#33572](https://github.com/nuxt/nuxt/pull/33572))
- Document `pending` as alias of `status === 'pending'` ([#33221](https://github.com/nuxt/nuxt/pull/33221))
- Clarify route middleware doesn't affect API routes ([#33643](https://github.com/nuxt/nuxt/pull/33643))
- Improve docs for `useHead`/`useHydration`/`useLazy*` ([#33626](https://github.com/nuxt/nuxt/pull/33626))
- Typo ([#33655](https://github.com/nuxt/nuxt/pull/33655))
### 🏡 Chore
- Add `verifyDepsBeforeRun: install` ([#33603](https://github.com/nuxt/nuxt/pull/33603))
- Reduce redirects in docs links ([bbdc72e35](https://github.com/nuxt/nuxt/commit/bbdc72e35))
- Lint docs ([352bdbc93](https://github.com/nuxt/nuxt/commit/352bdbc93))
- Remove verify deps before run ([e9e1c5b97](https://github.com/nuxt/nuxt/commit/e9e1c5b97))
### 🤖 CI
- Disable cache in release action ([885df65f4](https://github.com/nuxt/nuxt/commit/885df65f4))
### ❤️ Contributors
- Daniel Roe (@danielroe)
- Robin (@OrbisK)
- abeer0 (@iiio2)
- Bobbie Goede (@BobbieGoede)
- Florian Heuberger (@Flo0806)
- Matej Černý (@cernymatej)
- Peter Budai (@peterbud)
- Julien Huang (@huang-julien)
- Max (@onmax)
- 纸鹿/Zhilu (@L33Z22L11)
- Hinata Oishi (@te19oishi)
- Damian Głowala (@DamianGlowala)
- Maxime Pauvert (@maximepvrt)
- Raed Abdennadher (@RaedAbr)
> **3.20.0** is the next minor release.
## ✅ Upgrading
Our recommendation for upgrading is to run:
```sh
npx nuxt upgrade --dedupe --channel=v3
```
This will deduplicate your lockfile as well, and help ensure that you pull in updates from other dependencies that Nuxt relies on, particularly in the unjs ecosystem.
## 👉 Changelog
[compare changes](https://github.com/nuxt/nuxt/compare/v3.19.3...v3.20.0)
### 🚀 Enhancements
- **nuxt:** Allow specifying component `declarationPath` ([#33419](https://github.com/nuxt/nuxt/pull/33419))
- **kit:** Add `extensions` option for `resolveModule` ([#33328](https://github.com/nuxt/nuxt/pull/33328))
- **nuxt:** Add abortController option to `useAsyncData` ([#32531](https://github.com/nuxt/nuxt/pull/32531))
- **nuxt:** Display youch error page w/ user error page in dev ([#33359](https://github.com/nuxt/nuxt/pull/33359))
- **nuxt:** Experimental typescript plugin support ([#33314](https://github.com/nuxt/nuxt/pull/33314))
- **nuxt,schema:** Extract asyncData handlers to chunks ([#33131](https://github.com/nuxt/nuxt/pull/33131))
- **kit:** Add `setGlobalHead` utility ([#33512](https://github.com/nuxt/nuxt/pull/33512))
- **kit,vite:** Allow enabling vite environment api ([#33492](https://github.com/nuxt/nuxt/pull/33492))
### 🔥 Performance
- **nuxt:** Precompute renderer dependencies at build time ([#33361](https://github.com/nuxt/nuxt/pull/33361))
- **kit,schema:** Remove some unnecessary dependencies ([bdf34c263](https://github.com/nuxt/nuxt/commit/bdf34c263))
### 🩹 Fixes
- **nuxt:** Preserve hash with redirecting based on `routeRules` ([#33222](https://github.com/nuxt/nuxt/pull/33222))
- **kit:** Safely cleanup `loadNuxtConfig` in concurrent calls ([#33420](https://github.com/nuxt/nuxt/pull/33420))
- **nuxt:** Allow object-format `href` in `` ([b97ae2f70](https://github.com/nuxt/nuxt/commit/b97ae2f70))
- **nuxt:** Remove `mergeModels` from auto imports ([#33344](https://github.com/nuxt/nuxt/pull/33344))
- **nuxt:** Add back `shortPath` property ([#33384](https://github.com/nuxt/nuxt/pull/33384))
- **nuxt:** Do not allow native attrs to shadow nuxt link props ([0981990a7](https://github.com/nuxt/nuxt/commit/0981990a7))
- **nuxt:** Remove `declarationPath` from component dirs ([e384ba3cb](https://github.com/nuxt/nuxt/commit/e384ba3cb))
- **nuxt:** Preserve root route in `isPrerendered` check ([#33476](https://github.com/nuxt/nuxt/pull/33476))
- **nuxt:** Exempt webpack vfs from pkg lookup ([4df1e8275](https://github.com/nuxt/nuxt/commit/4df1e8275))
- **nitro:** Exempt nightly release from import protections ([272d9abbe](https://github.com/nuxt/nuxt/commit/272d9abbe))
- **webpack,rspack:** Preserve prerender + nitro flags in server builds ([#33503](https://github.com/nuxt/nuxt/pull/33503))
- **nuxt:** Support component auto-imports as arguments of `h()` ([#33509](https://github.com/nuxt/nuxt/pull/33509))
- **vite:** Prevent assignment for rolldown's replacement plugin ([#33526](https://github.com/nuxt/nuxt/pull/33526))
- **nuxt:** Use sha256 hash for prerender cache keys ([#33505](https://github.com/nuxt/nuxt/pull/33505))
- **nuxt:** Add `NuxtTime` relative time `numeric` prop ([#33552](https://github.com/nuxt/nuxt/pull/33552))
- **nuxt:** Add `NuxtTime` relative time `relativeStyle` prop ([#33557](https://github.com/nuxt/nuxt/pull/33557))
- **nuxt:** Handle arrays in app config correctly during HMR ([#33555](https://github.com/nuxt/nuxt/pull/33555))
### 💅 Refactors
- Remove obsolete `shortPath` property ([#33384](https://github.com/nuxt/nuxt/pull/33384))
- **kit:** Extract trace utilities ([ddaedfa51](https://github.com/nuxt/nuxt/commit/ddaedfa51))
- **nuxt,vite,webpack:** Allow builders to augment types ([#33427](https://github.com/nuxt/nuxt/pull/33427))
- **schema:** Deprecate `extend`, `extendConfig`, and `configResolved` hooks ([932a80dc6](https://github.com/nuxt/nuxt/commit/932a80dc6))
- **nitro,nuxt:** Extract `@nuxt/nitro-server` package ([#33462](https://github.com/nuxt/nuxt/pull/33462))
- **nuxt:** Use `RouteLocationNormalizedLoadedGeneric` internally ([aa211fb4f](https://github.com/nuxt/nuxt/commit/aa211fb4f))
- **vite:** Make vite plugins environment-compatible ([#33445](https://github.com/nuxt/nuxt/pull/33445))
### 📖 Documentation
- Add nuxt module `addServerPlugin` note ([#33409](https://github.com/nuxt/nuxt/pull/33409))
- Remove deprecated node version ([#33411](https://github.com/nuxt/nuxt/pull/33411))
- Update `declarationPath` in `addComponent` ([#33380](https://github.com/nuxt/nuxt/pull/33380))
- Add some notes/deprecations for vite hooks ([2c6912d2f](https://github.com/nuxt/nuxt/commit/2c6912d2f))
- Fix incorrect ESM module field info ([#33451](https://github.com/nuxt/nuxt/pull/33451))
- Recommend `getLayerDirectories()` instead of `nuxt.options._layers` ([#33484](https://github.com/nuxt/nuxt/pull/33484))
- Add docs for `moduleDependencies` ([#33499](https://github.com/nuxt/nuxt/pull/33499))
- Pin codemod to v0.18.7 for migration recipe ([#33522](https://github.com/nuxt/nuxt/pull/33522))
### 🏡 Chore
- Migrate gitpod to ona ([#33159](https://github.com/nuxt/nuxt/pull/33159))
- Use native node to run `test:prepare` ([cbad63c02](https://github.com/nuxt/nuxt/commit/cbad63c02))
- Do not use native node to run `test:prepare` ([672c09423](https://github.com/nuxt/nuxt/commit/672c09423))
- Update valid semantic scopes ([4ca29168b](https://github.com/nuxt/nuxt/commit/4ca29168b))
- Ignore nitro templates ([ec59aceeb](https://github.com/nuxt/nuxt/commit/ec59aceeb))
- Remove `vue-demi` from `ignoredBuiltDependencies` ([#33494](https://github.com/nuxt/nuxt/pull/33494))
- Update vscode url ([#33360](https://github.com/nuxt/nuxt/pull/33360))
- Correct jsdoc location for function used as parameters ([#33507](https://github.com/nuxt/nuxt/pull/33507))
- Remove code comment ([#33515](https://github.com/nuxt/nuxt/pull/33515))
- Patch changelogen for large numbers of commits ([b6530b5b6](https://github.com/nuxt/nuxt/commit/b6530b5b6))
- Filter out commits before last tag when constructing changelog ([257049712](https://github.com/nuxt/nuxt/commit/257049712))
- Ignore `@rollup/plugin-commonjs` ([c2bd323b8](https://github.com/nuxt/nuxt/commit/c2bd323b8))
- Pin `@rollup/plugin-commonjs` ([a524522ea](https://github.com/nuxt/nuxt/commit/a524522ea))
### ✅ Tests
- Update runtime test to use `asyncDataDefaults.errorValue` ([b6f1c9b0d](https://github.com/nuxt/nuxt/commit/b6f1c9b0d))
- Refactor suite to use common matrix utils ([#33483](https://github.com/nuxt/nuxt/pull/33483))
- Update typed router test ([c55db2854](https://github.com/nuxt/nuxt/commit/c55db2854))
### 🤖 CI
- Publish `@nuxt/nitro-server` on pkg-pr-new ([d37ef17b0](https://github.com/nuxt/nuxt/commit/d37ef17b0))
- Remove nitro-server publish until v4.2 is released ([e34c2f52f](https://github.com/nuxt/nuxt/commit/e34c2f52f))
- For now, use tag push to trigger release ([0705b835f](https://github.com/nuxt/nuxt/commit/0705b835f))
### ❤️ Contributors
- Daniel Roe (@danielroe)
- 山吹色御守 (@KazariEX)
- Matej Černý (@cernymatej)
- Trung Dang (@NamesMT)
- 纸鹿/Zhilu (@L33Z22L11)
- Florian Heuberger (@Flo0806)
- Alexander Lichter (@TheAlexLichter)
- Julien Huang (@huang-julien)
- abeer0 (@iiio2)
- Max (@onmax)
- Octavio Araiza (@8ctavio)
- Bobbie Goede (@BobbieGoede)
- DipakHalkude (@DipakHalkude)
- Aleksander Błaszkiewicz (@ablaszkiewicz)