Skip to content

Conversation

@renovate
Copy link
Contributor

@renovate renovate bot commented Jan 1, 2025

ℹ️ Note

This PR body was truncated due to platform limits.

This PR contains the following updates:

Package Change Age Confidence
@antfu/eslint-config 2.10.02.27.3 age confidence
@nuxt/kit (source) ^3.11.1^3.21.1 age confidence
@nuxt/module-builder ^0.5.5^0.8.4 age confidence
@nuxt/schema (source) ^3.11.1^3.21.1 age confidence
@nuxt/test-utils ^3.12.0^3.23.0 age confidence
@types/node (source) ^20.11.30^20.19.33 age confidence
@vitejs/plugin-vue (source) ^5.0.4^5.2.4 age confidence
@vitest/coverage-v8 (source) ^1.4.0^1.6.1 age confidence
bumpp ^9.4.0^9.11.1 age confidence
eslint (source) ^8.57.0^8.57.1 age confidence
lint-staged ^15.2.2^15.5.2 age confidence
playwright-core (source) ^1.42.1^1.58.2 age confidence
simple-git-hooks ^2.11.1^2.13.1 age confidence
typescript (source) ^5.4.3^5.9.3 age confidence
unconfig (source) ^0.3.11^0.6.1 age confidence
unplugin-vue-macros (source) ^2.7.13^2.14.5 age confidence
vue (source) ^3.4.21^3.5.28 age confidence

Release Notes

antfu/eslint-config (@​antfu/eslint-config)

v2.27.3

Compare Source

   🐞 Bug Fixes
    View changes on GitHub

v2.27.2

Compare Source

   🚀 Features
   🐞 Bug Fixes
    View changes on GitHub

v2.27.1

Compare Source

   🐞 Bug Fixes
    View changes on GitHub

v2.27.0

Compare Source

   🚀 Features
   🐞 Bug Fixes
    View changes on GitHub

v2.26.1

Compare Source

No significant changes

    View changes on GitHub

v2.26.0

Compare Source

   🐞 Bug Fixes
    View changes on GitHub

v2.25.2

Compare Source

   🐞 Bug Fixes
    View changes on GitHub

v2.25.1

Compare Source

   🐞 Bug Fixes
    View changes on GitHub

v2.25.0

Compare Source

   🐞 Bug Fixes
    View changes on GitHub

v2.24.1

Compare Source

   🚀 Features
    View changes on GitHub

v2.24.0

Compare Source

   🚀 Features
    View changes on GitHub

v2.23.2

Compare Source

No significant changes

    View changes on GitHub

v2.23.1

Compare Source

   🐞 Bug Fixes
    View changes on GitHub

v2.23.0

Compare Source

   🚀 Features
  • Introduce type options, enable ts/explicit-function-return-type for lib  -  by @​antfu (3dd7b)
   🐞 Bug Fixes
    View changes on GitHub

v2.22.4

Compare Source

   🐞 Bug Fixes
    View changes on GitHub

v2.22.3

Compare Source

   🐞 Bug Fixes
    View changes on GitHub

v2.22.2

Compare Source

   🚀 Features
   🐞 Bug Fixes
    View changes on GitHub

v2.22.1

Compare Source

No significant changes

    View changes on GitHub

v2.22.0

Compare Source

   🚀 Features
   🐞 Bug Fixes
    View changes on GitHub

v2.21.3

Compare Source

No significant changes

    View changes on GitHub

v2.21.2

Compare Source

   🚀 Features
   🐞 Bug Fixes
    View changes on GitHub

v2.21.1

Compare Source

   🚀 Features
   🐞 Bug Fixes
    View changes on GitHub

v2.21.0

Compare Source

   🐞 Bug Fixes
    View changes on GitHub

v2.20.0

Compare Source

   🚀 Features
    View changes on GitHub

v2.19.2

Compare Source

   🚀 Features
   🐞 Bug Fixes
    View changes on GitHub

v2.19.1

Compare Source

   🚀 Features
    View changes on GitHub

v2.19.0

Compare Source

   🚀 Features
    View changes on GitHub

v2.18.1

Compare Source

   🚀 Features
    View changes on GitHub

v2.18.0

Compare Source

   🚀 Features
    View changes on GitHub

v2.17.0

Compare Source

   🚀 Features
    View changes on GitHub

v2.16.4

Compare Source

No significant changes

    View changes on GitHub

v2.16.3

Compare Source

   🚀 Features
    View changes on GitHub

v2.16.2

Compare Source

No significant changes

    View changes on GitHub

v2.16.1

Compare Source

   🐞 Bug Fixes
    View changes on GitHub

v2.16.0

Compare Source

   🚀 Features
   🐞 Bug Fixes
    View changes on GitHub

v2.15.0

Compare Source

   🚨 Breaking Changes
    View changes on GitHub

v2.14.0

Compare Source

   🚀 Features
    View changes on GitHub

v2.13.4

Compare Source

   🚀 Features
   🐞 Bug Fixes
    View changes on GitHub

v2.13.3

Compare Source

   🐞 Bug Fixes
    View changes on GitHub

v2.13.2

Compare Source

   🐞 Bug Fixes
    View changes on GitHub

v2.13.1

Compare Source

   🚀 Features
    View changes on GitHub

v2.13.0

Compare Source

   🚀 Features
    View changes on GitHub

v2.12.2

Compare Source

   🚀 Features
    View changes on GitHub

v2.12.1

Compare Source

   🐞 Bug Fixes
    View changes on GitHub

v2.12.0

Compare Source

   🚀 Features
    View changes on GitHub

v2.11.6

Compare Source

   🚀 Features
    View changes on GitHub

v2.11.5

Compare Source

   🐞 Bug Fixes
    View changes on GitHub

v2.11.4

Compare Source

   🐞 Bug Fixes
    View changes on GitHub

v2.11.3

Compare Source

   🚀 Features
    View changes on GitHub

v2.11.2

Compare Source

No significant changes

    View changes on GitHub

v2.11.1

Compare Source

   🚀 Features
    View changes on GitHub

v2.11.0

Compare Source

   🚀 Features
    View changes on GitHub

v2.10.1

Compare Source

No significant changes

    View changes on GitHub
nuxt/nuxt (@​nuxt/kit)

v3.21.1

Compare Source

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
✅ Tests
  • Vitest v4 compatibility (70e147b71)
  • Add runtime tests for deeply nested <NuxtPage> navigation (707a9dc44)
  • Resolve merge issues in tests (85abddc54)
❤️ Contributors

v3.21.0

Compare Source

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.

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

export default defineNuxtConfig({
  extends: ['../shared-layer'],
  // disable @&#8203;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.

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

export default defineNuxtRouteMiddleware((to) => {
  setPageLayout('admin', {
    sidebar: true,
    theme: 'dark'
  })
})
<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:

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

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](https://redirect.github.com/nu

Configuration

📅 Schedule: Branch creation - "every 8 months on the first day of the month" (UTC), Automerge - At any time (no schedule defined).

🚦 Automerge: Disabled by config. Please merge this manually once you are satisfied.

Rebasing: Whenever PR becomes conflicted, or you tick the rebase/retry checkbox.

👻 Immortal: This PR will be recreated if closed unmerged. Get config help if that's undesired.


  • If you want to rebase/retry this PR, check this box

This PR was generated by Mend Renovate. View the repository job log.

@renovate renovate bot added the dependencies label Jan 1, 2025
@renovate renovate bot force-pushed the renovate/root branch 4 times, most recently from 6cf4f5d to 0f2f8d9 Compare January 6, 2025 11:18
@renovate renovate bot force-pushed the renovate/root branch 8 times, most recently from 038f3f0 to f66baad Compare January 15, 2025 06:56
@renovate renovate bot force-pushed the renovate/root branch 9 times, most recently from 8db8172 to 52fb833 Compare January 22, 2025 11:40
@renovate renovate bot force-pushed the renovate/root branch 8 times, most recently from d1792a7 to 88bcb57 Compare January 29, 2025 11:25
@renovate renovate bot force-pushed the renovate/root branch 4 times, most recently from 719ce71 to 26d4b12 Compare December 9, 2025 17:41
@renovate renovate bot force-pushed the renovate/root branch 2 times, most recently from 5559790 to 187b221 Compare December 18, 2025 15:43
@renovate renovate bot force-pushed the renovate/root branch 3 times, most recently from 2512766 to 219d2da Compare January 6, 2026 19:02
@renovate renovate bot force-pushed the renovate/root branch 4 times, most recently from 209bb2d to 7af4a69 Compare January 15, 2026 19:10
@renovate renovate bot force-pushed the renovate/root branch 5 times, most recently from 14fd50e to cdb5638 Compare January 23, 2026 20:51
@renovate renovate bot force-pushed the renovate/root branch 6 times, most recently from cd14ec3 to 604f15e Compare February 5, 2026 15:41
@renovate renovate bot force-pushed the renovate/root branch 4 times, most recently from a381185 to 5baac2d Compare February 9, 2026 11:16
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

0 participants