Changelog

Discover the latest releases from Nuxt and the official modules.
Nuxt WebsiteSource Code
nuxt

v4.3.1

4.3.1 is a regularly scheduled patch release.

👉 Changelog

compare changes

🩹 Fixes

  • nuxt: Correct reference format of server builder (#34177)
  • nuxt: Add status/statusText getters to NuxtError (#34188)
  • nuxt: Don't inject shared types for differing auto-imports (#34191)
  • schema: Add direnv and vendor to default ignore (#34190)
  • nuxt: Focus hash links after navigation (#34193)
  • nuxt: Exclude head runtime from unhead imports transform (#34195)
  • kit: Include prereleases in semver satisfy check (#34210)
  • nitro: Encode unicode paths in x-nitro-prerender header (#34202)
  • nuxt: Watch server/ for builder:watch hook (#34208)
  • nitro: Preserve error.message for fatal errors (#34226)
  • Only enable dynamic imports when ts plugin (#34205)
  • webpack: Use H3Error for 403 in dev server (#34233)
  • nuxt: Ensure NuxtError extends Error type (#34242)
  • vite: Use H3Error for 404 in dev server (#34225)
  • nuxt: Add backwards compat for #app barrel export in keyed functions (#34199)
  • nuxt: Track + re-add custom routes on hmr (#32044)
  • nuxt: Keep vnode when leaving deeper nested route (#33778)
  • vite: Prevent CSS flickering in dev mode after config changes (#33856)
  • nuxt: Do not start view transition if there is no route (#33723)
  • nuxt: Call deferHydration done on NuxtPage unmount (#34152)
  • nuxt: Handle invalid datetime in ` (#33992)
  • nuxt: Preserve middleware error status in 404 fallback (#34148)
  • nitro: Do not augment nuxt/schema (#34255)
  • nuxt: Cache manifest files to preserve buildId (#34002)
  • nuxt: Don't decode query string in SSR context URL (#34252)
  • nuxt: Allow specifying moduleDependencies by meta.name (#34263)
  • nuxt: Resolve #components import mapping conflict for packages outside rootDir (#34139)
  • vite,webpack: Use node.res to send 403/404 (#34266)
  • nitro,nuxt: Align path encoding with vue-router (#34265)
  • nitro: Augment nuxt/schema once more (552bbd8d1)

💅 Refactors

  • nuxt: Prefer genObjectKey to omit unnecessary quotes (#34245)
  • nuxt: Use ComponentProps helper to extract layout props (#34248)

📖 Documentation

  • Update roadmap dates (#34166)
  • Correct default value of nitroAutoImports (#34182)
  • Clarify shared type context limitations for custom imports (#34194)
  • Fix broken links (#34223)
  • Document payload extraction for ISR/SWR routes (#34222)
  • Update default aliases in configuration reference (#34237)
  • Update example of email validation (#34247)
  • Align server alias examples with #server and rootDir (#34259)
  • Add documentation for keyedComposables (#34201)

🏡 Chore

  • Remove px from width attribute (8d1cbb27a)
  • Add ai config in gitignore (#34220)

✅ Tests

  • Vitest v4 compatibility (825b2c202)
  • Add runtime tests for deeply nested <NuxtPage> navigation (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)
nuxt

v3.21.1

3.21.1 is a regularly schedule patch release.

👉 Changelog

compare changes

🩹 Fixes

  • nuxt: Correct reference format of server builder (#34177)
  • nuxt: Add status/statusText getters to NuxtError (#34188)
  • schema: Add direnv and vendor to default ignore (#34190)
  • nuxt: Focus hash links after navigation (#34193)
  • nuxt: Exclude head runtime from unhead imports transform (#34195)
  • kit: Include prereleases in semver satisfy check (#34210)
  • nuxt: Watch server/ for builder:watch hook (#34208)
  • nitro: Encode unicode paths in x-nitro-prerender header (#34202)
  • nitro: Preserve error.message for fatal errors (#34226)
  • Only enable dynamic imports when ts plugin (#34205)
  • webpack: Use H3Error for 403 in dev server (#34233)
  • nuxt: Ensure NuxtError extends Error type (#34242)
  • vite: Use H3Error for 404 in dev server (#34225)
  • nuxt: Add backwards compat for #app barrel export in keyed functions (#34199)
  • nuxt: Track + re-add custom routes on hmr (#32044)
  • nuxt: Keep vnode when leaving deeper nested route (#33778)
  • vite: Prevent CSS flickering in dev mode after config changes (#33856)
  • nuxt: Do not start view transition if there is no route (#33723)
  • nuxt: Call deferHydration done on NuxtPage unmount (#34152)
  • nuxt: Handle invalid datetime in ` (#33992)
  • nuxt: Preserve middleware error status in 404 fallback (#34148)
  • nitro: Do not augment nuxt/schema (#34255)
  • nuxt: Cache manifest files to preserve buildId (#34002)
  • nuxt: Don't decode query string in SSR context URL (#34252)
  • nuxt: Allow specifying moduleDependencies by meta.name (#34263)
  • nuxt: Resolve #components import mapping conflict for packages outside rootDir (#34139)
  • vite,webpack: Use node.res to send 403/404 (#34266)
  • nitro,nuxt: Align path encoding with vue-router (#34265)
  • nitro: Augment nuxt/schema once more (9f5bb611d)

💅 Refactors

  • nuxt: Prefer genObjectKey to omit unnecessary quotes (#34245)
  • nuxt: Use ComponentProps helper to extract layout props (#34248)

📖 Documentation

  • Remove link to ai guide entirely (084b5d7f2)
  • Update roadmap dates (#34166)
  • Clarify shared type context limitations for custom imports (#34194)
  • Fix broken links (#34223)
  • Document payload extraction for ISR/SWR routes (#34222)
  • Update example of email validation (#34247)
  • Add documentation for keyedComposables (#34201)

🏡 Chore

  • Remove px from width attribute (e80147f7d)
  • Add ai config in gitignore (#34220)

✅ Tests

  • Vitest v4 compatibility (70e147b71)
  • Add runtime tests for deeply nested <NuxtPage> navigation (707a9dc44)
  • Resolve merge issues in tests (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)
@nuxt/test-utils

v4.0.0

4.0.0 is the next major release.

👀 Highlights

We're releasing Nuxt Test Utils v4, with support for Vitest v4. 🚀

Better mocking support

The biggest improvement in this release is how mocking works. Nuxt initialization has been moved from setupFiles to the beforeAll hook (#1516), which means vi.mock and mockNuxtImport calls now take effect before Nuxt starts. This fixes a long-standing issue where mocks for composables used in middleware or plugins wouldn't apply reliably (#750, #836, #1496).

On top of that, mockNuxtImport now passes the original implementation to the factory function (#1552), making partial mocking much more natural:

mockNuxtImport('useRoute', original => vi.fn(original))

it('my test', async () => {
  vi.mocked(useRoute).mockImplementation(
    (...args) => ({ ...vi.mocked(useRoute).getMockImplementation()!(...args), path: '/mocked' }),
  )

  const wrapper = await mountSuspended(MyComponent)
  expect(wrapper.find('#path').text()).toBe('/mocked')
})

registerEndpoint improvements

registerEndpoint now works correctly with query parameters in URLs (#1560), and endpoints registered in setup files are no longer lost when modules reset (#1549).

🚧 Migration

@nuxt/test-utils v4 contains a few breaking changes, almost all related to requiring at least vitest v4 as a peer dependency (if you are using vitest). It replaces vite-node with Vite's native Module Runner and simplifies pool configuration.

This will mean improvements for test performance and mocking, but does require some changes to your test code.

!TIP Most of the changes below are straightforward. The biggest thing to watch out for is code that runs at the top level of a describe block — see below.

Update your dependencies

Update vitest and its companion packages together:

{
  "devDependencies": {
-   "@nuxt/test-utils": "^3.x",
-   "vitest": "^3.x",
-   "@vitest/coverage-v8": "^3.x"
+   "@nuxt/test-utils": "^4.0",
+   "vitest": "^4.0",
+   "@vitest/coverage-v8": "^4.0"
  }
}

Peer dependencies

We've tightened peer dependency ranges. You may need to update some of these:

Dependencyv3v4
vitest^3.2.0^4.0.2
happy-dom*>=20.0.11
jsdom*>=27.4.0
@jest/globals^29.5.0 || >=30.0.0>=30.0.0
@cucumber/cucumber^10.3.1 || >=11.0.0>=11.0.0
@testing-library/vue^7.0.0 || ^8.0.1^8.0.1

Later environment setup

This is the change that might require most change in your tests. Because we've moved the nuxt environment setup into beforeAll, this means composables called at the top level of a describe block will fail with [nuxt] instance unavailable.

// Before (worked in vitest v3)
describe('my test', () => {
  const router = useRouter() // ran lazily, after environment setup
  // ...
})

// After (vitest v4)
describe('my test', () => {
  let router: ReturnType<typeof useRouter>

  beforeAll(() => {
    router = useRouter() // runs after environment setup
  })
  // ...
})

This applies to useRouter(), useNuxtApp(), useRoute(), and any other Nuxt composable or auto-import.

!TIP If you only need the value within individual tests, beforeEach or directly within the test works too.

Stricter mock exports

If you use vi.mock with a factory function, accessing an export that the factory doesn't return will now throw an error instead of silently returning undefined.

// Before: accessing `bar` would silently return undefined
vi.mock('./module', () => ({ foo: 'mocked' }))

// After: accessing `bar` throws
// Fix: use importOriginal to include all exports
vi.mock('./module', async (importOriginal) => ({
  ...await importOriginal(),
  foo: 'mocked',
}))

!NOTE If you're mocking a virtual module (like #build/nuxt.config.mjs) where importOriginal can't resolve the real module, you might need to explicitly list all accessed exports in your mock factory.

Other changes

For the full list, see the vitest v4 migration guide.

👉 Changelog

compare changes

🚀 Enhancements

  • deps: ⚠️ Upgrade to vitest v4 (#1481)
  • deps: ⚠️ Drop official support for older versions of test runners + dom environments (31fdc262a)
  • runtime-utils: Pass original to mockNuxtImport factory (#1552)
  • runtime: ⚠️ Change nuxt start timing to beforeAll hook (#1516)
  • e2e: Support setup and teardown timeouts in setupBun (#1578)

🩹 Fixes

  • runtime: Handle optional chaining vueWrapper plugin installed check (#1547)
  • runtime-utils: Keep endpoints from registerEndpoint in setup file (#1549)
  • runtime-utils: Support registerEndpoint with query params (#1560)
  • runtime-utils: Avoid local variable in mockNuxtImport macro (#1564)
  • runtime-utils: Add missing nextTick import (#1563)
  • Pin h3-next to patch (1ff3bbb91)
  • playwright: Bump windows timeout (63e39b7c9)
  • config: Respect include options in non nuxt environment simple setup (#1570)

💅 Refactors

  • module: Use @nuxt/devtools-kit for devtools hooks (426e0b537)
  • runtime: Remove unnecessary querySelector (#1577)

📖 Documentation

🏡 Chore

  • Allow changelog update util to return major bump (9e86cadab)
  • Make app-vitest follow advised setup guidelines (#1542)
  • Update lockfile (6d798b5e1)
  • config: Migrate Renovate config (#1568)
  • Add test utils setup to .nuxtrc (b4021dee4)

✅ Tests

  • Avoid running root test script twice (44f6bd396)

⚠️ Breaking Changes

  • deps: ⚠️ Upgrade to vitest v4 (#1481)
  • deps: ⚠️ Drop official support for older versions of test runners + dom environments (31fdc262a)
  • runtime: ⚠️ Change nuxt start timing to beforeAll hook (#1516)

❤️ Contributors

  • Yoshihiro Yamaguchi (@yamachi4416)
  • Daniel Roe (@danielroe)
  • Adam DeHaven (@adamdehaven)
nuxt

v4.3.0

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 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 – 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). This provides a centralized, declarative way to manage layouts across your application without scattering definePageMeta calls throughout your pages.

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.

📦 ISR/SWR Payload Extraction

Payload extraction now works with ISR (incremental static regeneration), SWR (stale-while-revalidate) and cache routeRules (#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
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). 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). Just pass false to the module's options:

nuxt.config.ts
export default defineNuxtConfig({
  extends: ['../shared-layer'],
  // disable @nuxt/image from layer
  image: false,
})

🏷️ Route Groups in Page Meta

Route groups (folders wrapped in parentheses like (protected)/) are now exposed in page meta (#33460). This makes it easy to check which groups a route belongs to in middleware or anywhere you have access to the route.

pages/(protected)/dashboard.vue
<script setup lang="ts">
// This page's meta will include: { groups: ['protected'] }
useRoute().meta.groups
</script>
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):

middleware/admin.ts
export default defineNuxtRouteMiddleware((to) => {
  setPageLayout('admin', {
    sidebar: true,
    theme: 'dark'
  })
})
layouts/admin.vue
<script setup lang="ts">
defineProps<{
  sidebar?: boolean
  theme?: 'light' | 'dark'
}>()
</script>

🔧 #server Alias

A new #server alias provides clean imports within your server directory (#33870), similar to how #shared works:

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). 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):

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)
  • SSR styles optimization - The nuxt:ssr-styles plugin is now significantly faster (#33862, #33865)
  • Layer alias transform - Skipped when using Vite (it handles this natively) (#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)

🎨 Inline Styles for Webpack/Rspack

The inlineStyles feature now works with webpack and rspack builders (#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). The old properties still work but are deprecated in advance of v5:

- 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, #33963)
  • Fixed async data properties not being reactive in Options API (#34119)
  • Fixed useCookie unsafe number parsing during decode (#34007)
  • Fixed NuxtPage not re-rendering when nested NuxtLayout has layouts disabled (#34078)
  • Fixed client-side pathname decoding for non-ASCII route aliases (#34043)
  • Fixed suspense remounting when navigating after pending state (#33991)
  • Fixed clipboard copy in error overlay (#33873)
  • Enabled allowArbitraryExtensions by default in TypeScript config (#34084)
  • Added noUncheckedIndexedAccess to server tsconfig for safer typing (#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).

While we recommend keeping this enabled for better type safety, you can disable it if needed:

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)
  • Added MCP setup instructions for Claude Desktop (#33914)
  • Added layers directory documentation (#33967)
  • Added Deno package manager examples (#34070)
  • Clarified type-checking context limitations for server routes (#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:

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 if upgrading from an older version.

👉 Changelog

compare changes

🚀 Enhancements

  • kit: Support async constructor for adding plugins (#33619)
  • kit: Export Nuxt major version type (#33700)
  • schema: Add #server alias for server directory imports (#33870)
  • ui-templates: Let it snow! ❄️ (#33804)
  • schema: Hoist nitro crossws types (5b16a51f5)
  • nitro,nuxt: Compile route rules into client chunk (#33920)
  • nuxt: Allow disabling modules by setting module options to false (#33883)
  • kit: Allow specifying moduleDependencies as an async function (#33504)
  • nuxt: Support appLayout in route rules (#31092)
  • nuxt: Add route groups to page meta (#33460)
  • nuxt: Enable payload extraction for ISR/SWR routes (#33467)
  • nuxt: Allow updating props with setPageLayout (#33805)
  • nuxt: Enable dragging and minimizing for error overlay (#33695)
  • nitro,nuxt: Add support for payload extraction in dev (#30784)
  • rspack,webpack: Add inline styles (#33966)
  • kit: Add forward-compatible nitro types (#34036)

🔥 Performance

  • nuxt: Do not init layer alias transform when using vite (#33864)
  • vite: Add hook filters for ssr styles plugin (#33865)
  • vite: Optimize nuxt:ssr-styles plugin (#33862)
  • nuxt: Use filter for vfs plugin load (eb3d2d4c6)
  • nuxt,vite: Use filters to avoid running hooks unnecessarily (6b7fc7477)
  • nuxt,vite: Add more filters to internal plugins (#33898)

🩹 Fixes

  • kit: Normalize local layer paths with trailing slashes (#33858)
  • nuxt: Avoid overwriting multiple head input in island handler (#33849)
  • nuxt: Update meta instead of calling router.replace in page hmr (#33897)
  • nuxt: Don't call page:loading:end in cache if already called (7789f73bd)
  • vite: Add error handling for parsing NUXT_VITE_NODE_OPTIONS (41a564d23)
  • nuxt: Do not skip middleware when appMiddleware references invalid key (323f27bc8)
  • nitro: Clipboard copy in error overlay (#33873)
  • webpack,rspack: Resolve deep imports in virtual files (#33927)
  • webpack: Disable async chunks in dev mode (0310c4070)
  • webpack: Correctly evaluate sourcemap name (653f364af)
  • nuxt: Handle node10 resolution for nuxt/meta (01c2c9b13)
  • nuxt: Do not early return if component priorities conflict (#33955)
  • nuxt: Use key for tag deduplication in <Head> component (#33958)
  • schema,vite: Resolve build.transpile when initialising vite (#33868)
  • nuxt,rspack,webpack: Inject module identifiers for webpack builders (#33962)
  • nuxt: Add key to head components for proper deduplication (#33963)
  • nitro: Check prettyResponse.body type before error overlay (#33977)
  • nuxt: Don't URI-encode static route paths (#33990)
  • nuxt: Skip internal stub routes from prerender (#34001)
  • kit,schema: Align module onUpgrade arguments with types (#33988)
  • nuxt: Handle unsafe number parsing in useCookie decode (#34007)
  • nuxt: Do not externalise rou3 (2df4e1ae3)
  • nitro: Add noUncheckedIndexedAccess to server tsconfig (#33985)
  • nuxt: Add auto-import declarations for shared/ context (#33978)
  • nuxt: Update global reference to globalThis in useRequestFetch (#33976)
  • vite: Configure hmr port for server build (#33929)
  • kit: Add forward compatible nitro v3 types (#34053)
  • nitro,nuxt: Do not import nitro deps in builders (#34054)
  • nitro: Add h3 types to auto-imports (#34035)
  • schema: Add some more directories to ignore (ebc2a66ab)
  • nitro: Also augment nuxt/schema (a6a044d81)
  • nuxt: Make asyncData properties reactive in Options API (#34119)
  • nuxt: Rerender NuxtPage when nested NuxtLayout has explicitly disabled layouts (#34078)
  • kit,nitro: Enable allowArbitraryExtensions by default (#34084)
  • nuxt: Decode client-side pathname for non-ASCII route aliases (#34043)
  • nuxt: Force remount suspense when navigating after pending (#33991)
  • nuxt: Add documentation link to server builder error message (#34122)
  • nuxt: Validate placeholder/fallback tags + warn about placeholder/fallback props (567a1c6fb)
  • nuxt: Force flush useAsyncData debounced execute post watcher flush (#34125)
  • nitro: Process isr/swr/cache keys (d84278622)
  • nuxt: Add typeFrom support for imports.d.ts template exports (#34135)
  • nuxt: Ensure we inline styles for hydrate-never components (#34132)

💅 Refactors

  • kit: Add explicit return types for kit utilities (6cd1289d1)
  • nitro,nuxt,schema,vite: Provide explicit return types (1d2c0c25f)
  • kit,nuxt,schema: Use named imports from defu + consola (322dae3e0)
  • Add explicit .ts file extensions to relative imports (80778c0cd)
  • kit,nitro,nuxt,schema: Reduce barrels + move <> to as (f1713850c)
  • nitro,nuxt: Use ~ prefix for internal ssrContext properties (#33896)
  • nitro: Add explicit return types for runtime utils (a4fda917e)
  • nitro: Move tree-shaken flags from replace plugin -> vfs (#33907)
  • nitro,nuxt,vite,webpack: Use status/statusText + deprecate old props (#33912)
  • webpack: Use RuntimeModule API for chunk preloads (#33930)
  • nuxt: Use AST-aware function key injection (#33446)
  • nitro,nuxt,schema: Use augments for nitro schema types (#34039)
  • nitro,rspack,vite,webpack: Move cors handling -> nitro builder (#34048)

📖 Documentation

  • Split and improve Module Author Guides (#33803)
  • Update links to module guide (86d67b24f)
  • Fix useHead return type (#33857)
  • Add note that middleware doesn't run when rendering islands (7df27c781)
  • Add note on default branch for layers (#33919)
  • Add mcp setup instructions for claude desktop (#33914)
  • Mention deno as package manager (#33875)
  • Clarify purpose of statusText (#32834)
  • Update lychee config and remove medium article link (c0b4e0f28)
  • Update module count and fix typo (#33950)
  • Add DeepWiki badge (#33508)
  • Give example of usage of defineWrappedResponseHandler (#33952)
  • Provide cleaner example code for vitest projects (#33960)
  • Improve addImports example (#34011)
  • Update yarn create command (4a3c08874)
  • Update roadmap with a11y (d3453d6a5)
  • Add a11y release (#34041)
  • Remove Nuxtr from recommendations (#34045)
  • Typo (#34050)
  • Remove duplicate feature (#34058)
  • Fix typo (#34057)
  • Provide deno package manager examples (#34070)
  • Update JSDoc for config.experimental properties (#34069)
  • Fix transition types (#34082)
  • Make custom wrapper recipe link more prominent (#34085)
  • Remove null from getCachedData trigger (f7cf3747e)
  • nuxt: Mention custom serializers in useState docs (#34105)
  • Add info about runtime directories + type checking (#34097)
  • Clarify module setups in .nuxtrc example (#34107)
  • Remove duplicate entries in table (#34094)
  • Clarify catch all notation for addServerHandler (#34060)
  • Add layers directory documentation (#33967)
  • Clarify type-checking context limitations for server routes (#33964)
  • Add a tip for appLayout (beda47955)
  • Add docs for disabling modules by passing false to its options (cdad9310c)
  • Add info about caching payloads with isr/swr (6e10ff04f)
  • Add example for async addVitePlugin (1098254f7)
  • Add example of passing props to layouts (1f9e6b82c)
  • Mark vite plugin as not typed (5e09fddfb)
  • Add warning about source from <NuxtIsland> (1586bbb6e)

📦 Build

  • Remove babel debugging plugin from jiti stub options (bce8248b4)
  • vite: Add build entries for vite-node entrypoints (#33893)
  • nuxt: Tidy up subpath export types (a63d4a014)
  • Use obuild except for nuxt + nitro-server packages (#34049)
  • schema: Fix /builder-env subpath types (7f5034288)

🏡 Chore

✅ Tests

  • Update tests for new version of nuxt/test-utils (#33842)
  • Avoid unnecessary tick (988f6657a)
  • Add regression test for asyncData HMR (#32182)
  • Add test for page hmr resetting state (#32418)
  • Add reproduction for vite pre-transform error (#31574)
  • Add regression test for #32154 (#32154)
  • Use vi.hoisted for klona mock (#34113)

🤖 CI

  • Directly call webhook url (ce15997ce)
  • Use new reusable triage workflows (#34072)
  • Use new shared dependency review workflow (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)
nuxt

v3.21.0

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 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 – 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). This provides a centralized, declarative way to manage layouts across your application without scattering definePageMeta calls throughout your pages.

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.

📦 ISR/SWR Payload Extraction

Payload extraction now works with ISR (incremental static regeneration), SWR (stale-while-revalidate) and cache routeRules (#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
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). 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). Just pass false to the module's options:

nuxt.config.ts
export default defineNuxtConfig({
  extends: ['../shared-layer'],
  // disable @nuxt/image from layer
  image: false,
})

🏷️ Route Groups in Page Meta

Route groups (folders wrapped in parentheses like (protected)/) are now exposed in page meta (#33460). This makes it easy to check which groups a route belongs to in middleware or anywhere you have access to the route.

pages/(protected)/dashboard.vue
<script setup lang="ts">
// This page's meta will include: { groups: ['protected'] }
useRoute().meta.groups
</script>
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):

middleware/admin.ts
export default defineNuxtRouteMiddleware((to) => {
  setPageLayout('admin', {
    sidebar: true,
    theme: 'dark'
  })
})
layouts/admin.vue
<script setup lang="ts">
defineProps<{
  sidebar?: boolean
  theme?: 'light' | 'dark'
}>()
</script>

🔧 #server Alias

A new #server alias provides clean imports within your server directory (#33870), similar to how #shared works:

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). 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):

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)
  • SSR styles optimization - The nuxt:ssr-styles plugin is now significantly faster (#33862, #33865)
  • Layer alias transform - Skipped when using Vite (it handles this natively) (#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)

🎨 Inline Styles for Webpack/Rspack

The inlineStyles feature now works with webpack and rspack builders (#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). The old properties still work but are deprecated in advance of v5:

- 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, #33963)
  • Fixed async data properties not being reactive in Options API (#34119)
  • Fixed useCookie unsafe number parsing during decode (#34007)
  • Fixed NuxtPage not re-rendering when nested NuxtLayout has layouts disabled (#34078)
  • Fixed client-side pathname decoding for non-ASCII route aliases (#34043)
  • Fixed suspense remounting when navigating after pending state (#33991)
  • Fixed clipboard copy in error overlay (#33873)
  • Enabled allowArbitraryExtensions by default in TypeScript config (#34084)
  • Added noUncheckedIndexedAccess to server tsconfig for safer typing (#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).

While we recommend keeping this enabled for better type safety, you can disable it if needed:

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)
  • Added MCP setup instructions for Claude Desktop (#33914)
  • Added layers directory documentation (#33967)
  • Added Deno package manager examples (#34070)
  • Clarified type-checking context limitations for server routes (#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:

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 if upgrading from an older version.

👉 Changelog

compare changes

🚀 Enhancements

  • kit: Support async constructor for adding plugins (#33619)
  • kit: Export Nuxt major version type (#33700)
  • schema: Add #server alias for server directory imports (#33870)
  • schema: Hoist nitro crossws types (6ff79ea6c)
  • nitro,nuxt: Compile route rules into client chunk (#33920)
  • nuxt: Allow disabling modules by setting module options to false (#33883)
  • kit: Allow specifying moduleDependencies as an async function (#33504)
  • nuxt: Support appLayout in route rules (#31092)
  • nuxt: Add route groups to page meta (#33460)
  • nuxt: Enable payload extraction for ISR/SWR routes (#33467)
  • nuxt: Allow updating props with setPageLayout (#33805)
  • nuxt: Enable dragging and minimizing for error overlay (#33695)
  • nitro,nuxt: Add support for payload extraction in dev (#30784)
  • rspack,webpack: Add inline styles (#33966)
  • kit: Add forward-compatible nitro types (#34036)

🔥 Performance

  • nuxt: Do not init layer alias transform when using vite (#33864)
  • vite: Add hook filters for ssr styles plugin (#33865)
  • vite: Optimize nuxt:ssr-styles plugin (#33862)
  • nuxt: Use filter for vfs plugin load (5bd8e81ed)
  • nuxt,vite: Use filters to avoid running hooks unnecessarily (e762a1e20)
  • nuxt,vite: Add more filters to internal plugins (#33898)

🩹 Fixes

  • kit: Normalize local layer paths with trailing slashes (#33858)
  • nuxt: Avoid overwriting multiple head input in island handler (#33849)
  • nuxt: Update meta instead of calling router.replace in page hmr (#33897)
  • nuxt: Don't call page:loading:end in cache if already called (fbbe10133)
  • vite: Add error handling for parsing NUXT_VITE_NODE_OPTIONS (8abb7ef5b)
  • nuxt: Do not skip middleware when appMiddleware references invalid key (ed8bb68c5)
  • nitro: Clipboard copy in error overlay (#33873)
  • webpack,rspack: Resolve deep imports in virtual files (#33927)
  • webpack: Disable async chunks in dev mode (c4bfd0a49)
  • webpack: Correctly evaluate sourcemap name (93e3d92b9)
  • nuxt: Handle node10 resolution for nuxt/meta (b748840bc)
  • nuxt: Do not early return if component priorities conflict (#33955)
  • nuxt: Use key for tag deduplication in <Head> component (#33958)
  • schema,vite: Resolve build.transpile when initialising vite (#33868)
  • nuxt,rspack,webpack: Inject module identifiers for webpack builders (#33962)
  • nuxt: Add key to head components for proper deduplication (#33963)
  • nitro: Check prettyResponse.body type before error overlay (#33977)
  • nuxt: Don't URI-encode static route paths (#33990)
  • nuxt: Skip internal stub routes from prerender (#34001)
  • kit,schema: Align module onUpgrade arguments with types (#33988)
  • nuxt: Handle unsafe number parsing in useCookie decode (#34007)
  • nuxt: Do not externalise rou3 (7da94e8c3)
  • nitro: Add noUncheckedIndexedAccess to server tsconfig (#33985)
  • nuxt: Update global reference to globalThis in useRequestFetch (#33976)
  • vite: Configure hmr port for server build (#33929)
  • kit: Add forward compatible nitro v3 types (#34053)
  • nitro,nuxt: Do not import nitro deps in builders (#34054)
  • nitro: Add h3 types to auto-imports (#34035)
  • schema: Add some more directories to ignore (9cb9a19dd)
  • nitro: Also augment nuxt/schema (9b40196a6)
  • nuxt: Make asyncData properties reactive in Options API (#34119)
  • nuxt: Rerender NuxtPage when nested NuxtLayout has explicitly disabled layouts (#34078)
  • nuxt,schema: Clean up types (5ce351d0f)
  • nuxt: Allow user augmentation of runtime config (dd30410cb)
  • kit,nitro: Enable allowArbitraryExtensions by default (#34084)
  • nuxt: Decode client-side pathname for non-ASCII route aliases (#34043)
  • nuxt: Force remount suspense when navigating after pending (#33991)
  • nuxt: Add documentation link to server builder error message (#34122)
  • nuxt: Validate placeholder/fallback tags + warn about placeholder/fallback props (f7912d3f3)
  • nuxt: Force flush useAsyncData debounced execute post watcher flush (#34125)
  • nitro: Process isr/swr/cache keys (7f2bf4d13)
  • nuxt: Add typeFrom support for imports.d.ts template exports (#34135)
  • nuxt: Ensure we inline styles for hydrate-never components (#34132)

💅 Refactors

  • kit: Add explicit return types for kit utilities (ec2239cb4)
  • nitro,nuxt,schema,vite: Provide explicit return types (2564002de)
  • kit,nuxt,schema: Use named imports from defu + consola (e31668f67)
  • Add explicit .ts file extensions to relative imports (458f3c9b6)
  • kit,nitro,nuxt,schema: Reduce barrels + move <> to as (08f72881e)
  • nitro,nuxt: Use ~ prefix for internal ssrContext properties (#33896)
  • nitro: Add explicit return types for runtime utils (74bb6ddeb)
  • nitro: Move tree-shaken flags from replace plugin -> vfs (#33907)
  • nitro,nuxt,vite,webpack: Use status/statusText + deprecate old props (#33912)
  • webpack: Use RuntimeModule API for chunk preloads (#33930)
  • nuxt: Use AST-aware function key injection (#33446)
  • nitro,nuxt,schema: Use augments for nitro schema types (#34039)
  • nitro,rspack,vite,webpack: Move cors handling -> nitro builder (#34048)
  • nitro: Move to nitropack/runtime namespace (b06d53166)
  • nitro,nuxt: Move to nitropack/runtime namespace (897a2259f)

📖 Documentation

  • Fix useHead return type (#33857)
  • Add correct instructions to upgrade to latest Nuxt 3.x (#33866)
  • Improve grammar (#34093)
  • Use h2 for nuxt add command page (a0a1763d5)
  • Update links to module guide (c9c1282f8)
  • Split and improve Module Author Guides (#33803)
  • Split directory structure and re-order guides (v4) (#33691)
  • Add mcp server and llms.txt (#33371)
  • Add note that middleware doesn't run when rendering islands (d22cf7903)
  • Add note on default branch for layers (#33919)
  • Add mcp setup instructions for claude desktop (#33914)
  • Mention deno as package manager (#33875)
  • Clarify purpose of statusText (#32834)
  • Update lychee config and remove medium article link (36c19ce73)
  • Update module count and fix typo (#33950)
  • Add DeepWiki badge (#33508)
  • Give example of usage of defineWrappedResponseHandler (#33952)
  • Provide cleaner example code for vitest projects (#33960)
  • Update yarn create command (b30432979)
  • Update roadmap with a11y (7ea35137c)
  • Add a11y release (#34041)
  • Remove Nuxtr from recommendations (#34045)
  • Remove duplicate feature (#34058)
  • Provide deno package manager examples (#34070)
  • Make custom wrapper recipe link more prominent (#34085)
  • nuxt: Mention custom serializers in useState docs (#34105)
  • Clarify module setups in .nuxtrc example (#34107)
  • Add layers directory documentation (#33967)
  • Add a tip for appLayout (9b78698c3)
  • Add docs for disabling modules by passing false to its options (18500730c)
  • Add info about caching payloads with isr/swr (4b055548e)
  • Add example for async addVitePlugin (4407f6862)
  • Add example of passing props to layouts (401aa90ab)
  • Mark vite plugin as not typed (25eae7699)
  • Add warning about source from <NuxtIsland> (08778c98c)
  • Sync with main branch (e8c04aaa6)
  • Fix ai guide link (01c173b78)

📦 Build

  • Remove babel debugging plugin from jiti stub options (1ec010681)
  • vite: Add build entries for vite-node entrypoints (#33893)
  • nuxt: Tidy up subpath export types (fe92e9c17)
  • Use obuild except for nuxt + nitro-server packages (#34049)
  • schema: Fix /builder-env subpath types (1951648fa)

🏡 Chore

✅ Tests

  • Update tests for new version of nuxt/test-utils (#33842)
  • Avoid unnecessary tick (fb4720840)
  • Add regression test for asyncData HMR (#32182)
  • Add test for page hmr resetting state (#32418)
  • Add reproduction for vite pre-transform error (#31574)
  • Add regression test for #32154 (#32154)
  • Use vi.hoisted for klona mock (#34113)
  • Update bundle size (e6c8d10c6)
  • Fix paths in hmr test (3b8b2138a)
  • Update snapshots (51c83b8ec)
  • Update bundle size (22708c05c)

🤖 CI

  • Directly call webhook url (4eedbcae5)
  • Use new reusable triage workflows (#34072)
  • Use new shared dependency review workflow (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)
@nuxt/ui

v4.4.0

🚀 Features

  • Calendar: add weekNumbers prop (#4555) (7a1a71b)
  • ChangelogVersions: handle scroll options in indicator prop (#5257) (6a925cd)
  • CommandPalette/InputMenu/SelectMenu/Tree: handle virtualizer estimateSize as function (#5748) (d51b424)
  • CommandPalette: add input prop (#5736) (12052e8)
  • CommandPalette: add size prop (#5878) (3ae04c6)
  • components: add by prop (#5906) (36cd5e5)
  • components: add valueKey prop (#5905) (55646ea)
  • Editor: add placeholder.mode prop (d90acb3), closes #5785
  • Editor: add size prop in menus (#5889) (571d50d)
  • Editor: add taskList handler (#5837) (db04197)
  • Editor: add support for code inside links (2ed2d5d)
  • Editor: handle boolean in image and mention props (b6fa83a), closes #5820
  • EditorMentionMenu: handle async search with ignoreFilter prop (#5880) (f8d1883)
  • InputMenu/Select/SelectMenu: expose viewportRef for infinite scroll (#5836) (f4a945c)
  • InputMenu/SelectMenu: add clear prop (#5643) (ec6b8ec)
  • Link: support custom navigate function in vue (#5860) (f51e58a)
  • ProseTd/ProseTh: handle align prop (859390e), closes #5795
  • Timeline/Stepper: add wrapper slot and fix dynamic slot conditions (#5868) (8610d4d)
  • Timeline: add select event (#5826) (8e431be)

🐛 Bug Fixes

  • Banner: isolate banner visibility using per-instance CSS variables (#5751) (c7332eb)
  • Banner: prevent XSS via id prop injection (4e334a0)
  • CommandPalette/ContextMenu/DropdownMenu: keyboard selection on link items (3f5bdb3)
  • CommandPalette: prevent XSS in search highlight (e12ceb6)
  • ContentSurround: align next link to right on tablet without prev (#5833) (b3adccc)
  • defineShortcuts: check shift modifier for special character shortcuts (bd344d7), closes #5911
  • Editor: set contentType when updating value (c37d6f7), closes #5709
  • Editor: support all heading levels by default (3046c3e)
  • EditorToolbar: prevent onClick from being called twice on items (cbed0cc), closes #5784
  • EditorToolbar: prevent disabled dropdown when items have no kind (d473f63)
  • Error/Main: render as main instead of div (6ccb1f5)
  • FileUpload: emit null when clearing file (#5892) (1d9a2fd)
  • FileUpload: keep input visible when preview is disabled with multiple files (597ac29), closes #5875
  • locale: improve cs and sk terminology for correct inflection (#5789) (af6f288)
  • module: only override primary color and md size default variants (f422de8)
  • ProseCodeTree: prevent infinite update loop with expandAll prop (c79cb77), closes #5828
  • useOverlay: refine close event argument extraction (#5775) (182af20)

👋 New Contributors

Full Changelog: https://github.com/nuxt/ui/compare/v4.3.0...v4.4.0

@nuxt/content

v3.11.0

🚀 Features

🐞 Bug Fixes

🏎 Performance

@nuxt/test-utils

v3.23.0

3.23.0 is the next minor release.

👉 Changelog

compare changes

🚀 Enhancements

  • runtime-utils: Support h3 v2 (#1515)
  • module: Add install wizard when freshly installed (#1538)

🩹 Fixes

  • e2e: Ensure $fetch is not typed as any (1f4754ea9)

🏡 Chore

✅ Tests

  • Add cleanup to resolve-config tests (#1537)

🤖 CI

  • Prepare build environment in autofix workflow (2c0864ed6)

❤️ Contributors

  • Daniel Roe (@danielroe)
  • yamachi4416 (@yamachi4416)
@nuxt/test-utils

v3.22.0

3.22.0 is the next minor release.

👉 Changelog

compare changes

🚀 Enhancements

  • runtime-utils: Unify logic of mount + render helpers (#1522)
  • module: Run vitest in separate process (#1524)
  • runtime-utils: Allow skipping initial route change (fd77ec066)
  • runtime: Skip route sync emulation when NuxtPage exists (#1530)

🔥 Performance

  • module: Skip nuxt-root stub plugin when building (#1512)

🩹 Fixes

  • runtime-utils: Reject promise on error render + mount helpers (#1503)
  • runtime-utils: Support new .sync method for syncing route (1148c3cf1)
  • e2e: Always override global env options with inline options (c8f881b3d)
  • runtime-utils: Avoid missing render warn on reject render + suspend helpers (#1520)
  • e2e: Use server.deps rather than deps (2b3c86921)
  • config: Also call sync() in initial setup (ec555192c)
  • module: Use devtools:before hook instead of direct config check (#1532)
  • config: Do not override vitest root with nuxt rootDir (#1531)

💅 Refactors

  • runtime-utils: Do not export addCleanup (86b4998bb)
  • module: Extract nuxt environment options plugin (5ada22a9f)

📖 Documentation

  • Fix link to module authors testing guide (#1511)

🏡 Chore

✅ Tests

  • Use local kit version for module (79f1e14d5)
  • Add defaultLocale in i18n test (059988fc3)
  • Avoid definePageMeta compiler-hint warning (#1523)

🤖 CI

❤️ Contributors

  • Daniel Roe (@danielroe)
  • yamachi4416 (@yamachi4416)
  • Maurice Putz (@Shooteger)