Releases · nuxt/nuxt

19 Nov 20:54

danielroe

v3.14.1592

3894e9d

v3.14.1592 Latest

Latest

3.14.1592 is the next patch release.

👉 Changelog

compare changes

🩹 Fixes

rspack: Update webpackbar with support for rspack (#29823)
nuxt: Assign default name to component without setup (#29869)
kit: Use dst to deduplicate templates when adding them (#29895)
nuxt: Handle empty plugin files (d44408e87)
vite: Use resolved nuxt template dst to invalidate modules (6cd3352de)
nuxt: Return null map for empty plugin metadata (302a66da9)
kit: Resolve module paths before appending subpaths (#29955)
nuxt: Recompile templates on change events (#29954)
nuxt: Do not include <NuxtWelcome> when building (#29956)
nuxt: Allow scanning metadata from 2+ files at same path (#29969)
nuxt: Do not disallow importing nitro dependencies (#29975)

💅 Refactors

nuxt: Define layouts as async vue components (#29957)

📖 Documentation

Update custom environment example (e3759ad55)
Update minimal example (7973f5ed4)
Add tip about islands directory (#29913)
Fix typo in composable name (#29910)
Rename @nuxt/auth to @nuxt/auth-utils in roadmap (#29906)
Capitalize text (#29938)
Improve clarity in seo meta example (#29930)
Update getting started to include WebStorm (#29845)

🏡 Chore

Remove unused imports and update eslint config (#29876)

✅ Tests

Add import protection test (fbd5c33ba)

🤖 CI

Remove release-pr workflow (2915f93c3)

❤️ Contributors

Daniel Roe (@danielroe)
Gustavo Aquino Torres Teixeira (@guska8)
Stephanie Smith (@stephiescastle)
@beer (@iiio2)
Maxime Pauvert (@maximepvrt)
crisarji (@crisarji)
RBV1 (@RBV1)
Adrien Foulon (@Tofandel)
Julien Huang (@huang-julien)
Horu (@HigherOrderLogic)
Jan-Niklas W. (@niklas-wortmann)

Contributors

beer, stephiescastle, and 10 other contributors

Assets 2

06 Nov 11:37

danielroe

v3.14.159

6256890

v3.14.159

3.14.159 is a hotfix release to address regressions in v3.14.

We're leaning into the π theme - future patch releases of this minor version will just continue adding digits. (Sorry for any inconvenience! 😆)

👉 Changelog

compare changes

🩹 Fixes

nuxt: Update nitropack preset directory (#29780)
kit: Fall back to meta version if there's no module.json (#29793)
kit: Use mlly to resolve module paths to avoid cjs fallback (#29799)
webpack,rspack: Add adapter for webpack-dev-middleware (#29806)
nuxt: Remove null-byte prefix for virtual files (#29809)
kit: Convert module path to file url before reading meta (fb833ac64)

📖 Documentation

Capitalize titles (#29768)
Fix rou3 link in nitro.js (#29775)
Fix tip formatting (#29792)
Add link to h3 blogpost (#29794)
Remove outdated cloudflare tip (auto minify deprecated) (#29812)

🏡 Chore

nuxt: Remove redundant type (#29810)

❤️ Contributors

Daniel Roe (@danielroe)
xjccc (@xjccc)
Efraim (@EfraimGENC)
Aurion SARL (@Aurion72)
Erik Lilja (@Lilja)
Markus Oberlehner (@maoberlehner)
Lukas Bauer (@luxterful)
@beer (@iiio2)

Contributors

beer, Lilja, and 7 other contributors

Assets 2

04 Nov 16:06

danielroe

v3.14.0

4242052

v3.14.0

3.14.0 is the next minor release.

👀 Highlights

Behind the scenes, a lot has been going on in preparation for the release of Nuxt v4 (particularly on the unjs side with preparations for Nitro v3!)

⚡️ Faster starts powered by `jiti`

Loading the nuxt config file, as well as modules and other build-time code, is now powered by jiti v2. You can see more about the release in the jiti v2 release notes, but one of the most important pieces is native node esm import (where possible), which should mean a faster start. ✨

📂 Shared folder for code and types shared with client/server

You should never import Vue app code in your nitro code (or the other way around). But this has meant a friction point when it comes to sharing types or utilities that don't rely on the nitro/vue contexts.

For this, we have a new shared/ folder (#28682). You can't import Vue or nitro code into files in this folder, but it produces auto-imports you can consume throughout the rest of your app.

If needed you can use the new #shared alias which points to this folder.

The shared folder is alongside your server/ folder. (If you're using compatibilityVersion: 4, this means it's not inside your app/ folder.)

🦀 `rspack` builder

We're excited to announce a new first-class Nuxt builder for rspack. It's still experimental but we've refactored the internal Nuxt virtual file system to use unplugin to make this possible.

Let us know if you like it - and feel free to raise any issues you experience with it.

👉 To try it out, you can use this starter - or just install @nuxt/rspack-builder and set builder: 'rspack' in your nuxt config file.

✨ New composables

We have new useResponseHeader and useRuntimeHook composables (#27131 and #29741).

🔧 New module utilities

We now have a new addServerTemplate utility (#29320) for adding virtual files for access inside nitro runtime routes.

🚧 v4 changes

We've merged some changes which only take effect with compatibilityVersion: 4, but which you can opt-into earlier.

previously, if you had a component like ~/components/App/Header.vue this would be visible in your devtools as <Header>. From v4 we ensure this is <AppHeader>, but it's opt-in to avoid breaking any manual <KeepAlive> you might have implemented. (#28745).
Nuxt scans page metadata from your files, before calling pages:extend. But this has led to some confusing behaviour, as pages added at this point do not end up having their page metadata respected. So we now do not scan metadata before calling pages:extend. Instead, we have a new pages:resolved hook, which is called after pages:extend, after all pages have been augmented with their metadata. I'd recommend opting into this by setting experimental.scanPageMeta to after-resolve, as it solves a number of bugs.

🗺️ Roadmap to v3.15

They didn't quite make it in time for v3.14 but for the next minor release you can expect (among other things):

auto-imported directives from modules (#29203)
'isolated' page renders (#29366)
delayed hydration (#26468)

✅ Upgrading

As usual, our recommendation for upgrading is to run:

npx nuxi@latest upgrade --force

This will refresh your lockfile as well, and ensures that you pull in updates from other dependencies that Nuxt relies on, particularly in the unjs ecosystem.

👉 Changelog

compare changes

🚀 Enhancements

deps: Upgrade to latest version of jiti (#27995)
kit,nuxt,vite,webpack: Reimplement cjs utils using jiti (#29073)
nuxt: Normalise component names to match nuxt pattern (#28745)
kit,schema: Add addServerTemplate utility (#29320)
nuxt: Add useResponseHeader composable (#27131)
rspack,webpack: Add rspack builder (#29142)
nuxt,schema: pages:resolved hook + scan meta post extend (#28861)
nuxt: Allow enabling route props in definePageMeta (#29586)
schema,nuxt: Add shared/ folder and #shared alias (#28682)
nuxt: Allow chunk error or manifest update -> reload (#28160)
nuxt: Add useRuntimeHook composable (#29741)

🔥 Performance

nuxt: Remove unneeded second call to useNuxtApp (#29514)
vite: Avoid redundant postcss plugins overwrite (#29619)
kit,nuxt,vite,webpack: Hoist regex patterns (#29620)

🩹 Fixes

nuxt: Simplify plugin InjectionType template conditional (#29023)
nuxt: Access server build from webpack memfs (#29027)
nuxt: Do not resolve non-absolute component paths (#29036)
nuxt: Defer unsetting error handler until suspense resolves (#29037)
nuxt: Pass DOMException as fetch abort exception (#29058)
vite: Don't force protocol if disabled devServer.https (#29049)
nuxt: Empty nitro buildDir in dev mode (#29068)
nuxt: Don't resolve relative import type paths for deps (#29069)
kit: Handle passing 'bare' relative paths to modules (c7fecd8a1)
kit: Try resolving module path from each node_modules dir (70a622d43)
kit,vite,webpack: Resolve postcss paths from each modules dir (#29096)
kit,vite,webpack: Strip node_modules/ from parent urls (5bd42c893)
nuxt: Add crossorigin attribute for stylesheets (#29138)
nuxt: Use routeRules to hint pages to prerender (#29172)
nuxt: Pass absolute external link urls to link:prefetch (#29321)
nuxt: Error on build when required module is missing (#29287)
nuxt: Prevent 404 when hitting component test endpoint (cb725f014)
nuxt: Avoid throwing 404 error before middleware finishes (#29054)
schema: Use ConfigLayer type from c12 (#29370)
nuxt: Fix nested page types in typedPages (#29352)
nuxt: Allow islands to manipulate head client-side (#29186)
vite: Dim repeat count in logs (#29392)
schema: Mark configFile as required in layer type (3bbcd7d21)
nuxt: Remove vue compiler hints from auto import (#29713)
vite: Update signature for createIsExternal (686be8168)
nuxt: Respect existing props value in definePageMeta (#29683)
schema: Hoist nitropack/types to ensure api routes are typed (54096875e)

💅 Refactors

nuxt: Use addBuildPlugin internally (#29157)
nuxt,schema,vite,webpack: Use unplugin for vfs (#29165)

📖 Documentation

Use defineNuxtComponent instead of defineComponent (#29011)
Remove duotone icons for clarity (#29040)
Fix typo (#29045)
Remove specific Nuxt 4 release date (#29151)
Remove redundant newlines and indentations (#29190)
Add links to short videos from daniel (#29185)
Fix comments typo in auto-imports example (#29195)
Add missing word (#29230)
Add a section about useRequestFetch and event.$fetch (#29099)
Add example of typing custom useFetch errors (#29253)
Ensure manifest code snippet works with pnpm (#29273)
Consistent directory structure (#29292)
Update to new ofetch...

Contributors

cheike569, atinux, and 34 other contributors

Assets 2

15 Sep 21:27

danielroe

v3.13.2

a507253

v3.13.2

3.13.2 is the next regularly scheduled patch release.

✅ Upgrading

As usual, our recommendation for upgrading is to run:

npx nuxi@latest upgrade --force

This will refresh your lockfile as well, and ensures that you pull in updates from other dependencies that Nuxt relies on, particularly in the unjs ecosystem.

👉 Changelog

compare changes

🔥 Performance

nuxt: Remove interop default for dynamic components (#28912)

🩹 Fixes

nuxt: Fix ssr log querySelector (#28864)
schema: Enable propsDestructure by default (#28830)
nuxt: Ensure injected route has enumerable keys (#28841)
nuxt: Don't override vue instance with legacy asyncData (#28842)
nuxt: Render server errors with ssr: false (#28834)
nuxt: Resolve full component paths (#28843)
nuxt: Improve accuracy of module resolution conditions (#28846)
nuxt: Log more context of prerendering errors (#28895)
nuxt: Enable injectAtEnd to reduce circular auto-imports (#28822)
nuxt: Ensure we process files in buildDir for unimport (#28899)
nuxt: Do not accept attrs on <NuxtErrorBoundary> (#28901)
nuxt,schema: Accept any module in inline modules array (#28922)
nuxt: Fall back to original component filePath (#28925)
nuxt: Make runWithContext generic (#28926)
nuxt: Set inheritAttrs: false for fragment components (#28939)
nuxt: Use case-insensitive regexp for <script> blocks (4fd24381c)
nuxt: Ensure component imports are injected last (#28944)
nuxt: Catch chunk errors directly in navigation (820908696)
nuxt: Add missing isNuxtMajorVersion export (#29016)
nuxt: Correct type for useError (#28996)

💅 Refactors

nuxt: Use vite:preloadError event (#28862)

📖 Documentation

Add known limitations for app.config.ts (#28875)
Typo fixed missing closing angle bracket (#28880)
Update useFetch troubleshooting section (#28918)
Capitalize text (#28972)
Fix typo (#28983)
Add clarity to useFetch parameter signature (#28993)
Remove confusing reference to 'SPA' (#28991)

🏡 Chore

Use consola to log out compatibility info (#28854)
vite: Use correct type import (3f508d521)
Enable noUncheckedSideEffectImports (#28903)
Add pending triage to blank issues (#28923)
Correct comment style (c4181b5a2)
Fix typos (462380d45)
Refresh lockfile, use htmlnano + pin workflow deps (#28946)
Pin dep + workflow by hash (4d81334c9)
ui-templates: Use class-selector (043329f52)

✅ Tests

Collect bundle sizes in parallel (1ce81069d)
Add regression test for using route in template (#28967)
Convert set to array (6ee3b3adc)
Switch inline snapshot to object comparison (ae5135363)

🤖 CI

Access issue number from payload (8e4585c14)
Configure codeql to ignore tests (d5f98a757)
Add default permissions for workflows (3ede01cd4)
Scan source files with codeql (#28943)
Skip setting up node before codeql scan (c4d7c92e9)

❤️ Contributors

Daniel Roe (@danielroe)
Artem Maslov (@Twocram)
Paulo Ricardo Severo (@prsevero)
Nishant Aanjaney Jalan (@cybercoder-naj)
@beer (@iiio2)
Julien Huang (@huang-julien)
Liran Tal (@lirantal)
Anthony Fu (@antfu)
Osama Abdallah Essa Haikal (@OsamaHaikal)

Contributors

beer, lirantal, and 8 other contributors

Assets 2

04 Sep 09:43

danielroe

v3.13.1

9983e83

v3.13.1

3.13.1 is the next regularly scheduled patch release.

👀 Highlights

Although this is a patch release, there are two features I'd love to draw your attention to.

🆔 useId now uses a built-in Vue composable for stable ids between server + client! #28285
🔥 a new experimental.buildCache feature now allows for quicker app rebuilds #28726

As always, feedback is appreciated 🙏 ❤️

✅ Upgrading

As usual, our recommendation for upgrading is to run:

npx nuxi@latest upgrade --force

This will refresh your lockfile as well, and ensures that you pull in updates from other dependencies that Nuxt relies on, particularly in the unjs ecosystem.

👉 Changelog

compare changes

🔥 Performance

nuxt: Cache vue app build outputs (#28726)
nuxt: Use ServerPlaceholder for ssr client components (#28563)
nuxt: Use reducer array + handle modified proto (#28768)

🩹 Fixes

schema: Resolve user-provided serverDir relative to root (#28700)
nuxt: Handle mismatching declaration/plugin extensions (#28709)
nuxt: Do not accept arbitrary strings for MiddlewareKey (#28676)
nuxt: Do not pass listeners to custom NuxtLink (#28738)
nuxt: Generate basic jsdoc for module config entry (#27689)
nuxt: Augment NuxtOptions as well as config (#28747)
nuxt: Improve error logging in import protections (#28753)
nuxt: Handle deleted cookies from CookieStore events (#28760)
nuxt: Allow updating appConfig with non-iterable objects (#28773)
nuxt: Improve isNuxtError type inference (#28814)

💅 Refactors

nuxt: Update to vue v3.5 + native useId (#28285)

📖 Documentation

Fix typo (#28724)
Update broken/redirected links (#28739)
Capitalize text (#28734)
Updated line number for nuxt build-time hooks (#28746)
Add missing query returned value from useRoute() (#28743)
Persist package manager choice in code blocks (#28514)
Fix postcss codeblock typo (#28801)
Include --frozen-lockfile when installing dependencies (#28794)

🏡 Chore

Use tinyexec internally (#28684)
Use tinyglobby internally (#28686)
Trim tag (#28687)
Fix ci typo (#28721)
Tidying workflows + add sherif workflow (#28793)
Ignore eslint warnings about console logging (#28795)

✅ Tests

Update bundle size (99df4c222)

❤️ Contributors

Gianluca Di Francesco (@gianlucadifrancesco)
Daniel Roe (@danielroe)
Joaquín Sánchez (@userquin)
Heb (@Hebilicious)
Eckhardt (Kaizen) Dreyer (@Eckhardt-D)
Gustav Odinger (@gustavwilliam)
Julien Huang (@huang-julien)
Ismail Sabet (@ismailsabet)
Max (@onmax)
Anthony Fu (@antfu)
@beer (@iiio2)
riskrole (@riskrole)
Thimo Sietsma (@th1m0)

Contributors

beer, userquin, and 12 other contributors

Assets 2

22 Aug 16:09

danielroe

v3.13.0

74ef96d

v3.13.0

👀 Highlights

I'm pretty excited about this release - we've ported some features we had planned for Nuxt v4 back to v3, as well as a raft of bug fixes and performance improvements - as usual.

Here are a few of things I'm most excited about.

🏘️ Route Groups

We now support naming directories with parentheses/brackets to organise your routes without affecting the path.

For example:

-| pages/
---| index.vue
---| (marketing)/
-----| about.vue
-----| contact.vue

This will produce /, /about and /contact pages in your app. The marketing group is ignored for purposes of your URL structure.

🏝️ Islands and Head Metadata

It's now possible for server component islands to manipulate the head, such as by adding SEO metadata when rendering.

🪝 Custom Prefetch Triggers

We now support custom prefetch triggers for NuxtLink (#27846).

For example:

<template>
  <div>
    <NuxtLink prefetch-on="interaction">
      This will prefetch when hovered or when it gains focus
    </NuxtLink>
    <!-- note that you probably don't want both enabled! -->
    <NuxtLink :prefetch-on="{ visibility: true, interaction: true }">
      This will prefetch when hovered/focus - or when it becomes visible
    </NuxtLink>
  </div>
</template>

It's also possible to enable/disable these globally for your app and override them per link.

For example:

export default defineNuxtConfig({
  experimental: {
    defaults: {
      nuxtLink: {
        prefetch: true,
        prefetchOn: { visibility: false, interaction: true }
      }
    }
  }
})

🗺️ Better Server Source Maps

When running with node --enable-source-maps, you may have noticed that the source maps for the Vue files in your server build pointed to the Vite build output (something like .nuxt/dist/server/_nuxt/index-O15BBwZ3.js).

Now, even after your Nitro build, your server source maps will reference your original source files (#28521).

Note that one of the easiest ways of improving your build performance is to turn off source maps if you aren't using them, which you can do easily in your nuxt.config:

export default defineNuxtConfig({
  sourcemap: {
    server: false,
    client: true,
  },
})

🎁 New Features for Module Authors

In the run-up to Nuxt v4, we're working on adding some key functionality for module authors, including a new isNuxtMajorVersion utility where required (#27579) and better inferred typing for merged module options using the new defineNuxtModule().with() method (#27520).

✨ Improved Dev Warnings

We no longer warn when using data fetching composables in middleware (#28604) and we warn when user components' names begin with Lazy (#27838).

🚨 Vue TypeScript Changes

For a while, in the Vue ecosystem, we've been augmenting @vue/runtime-core to add custom properties and more to vue. However, this inadvertently breaks the types for projects that augment vue - which is now the officially recommended in the docs way to augment these interfaces (for example, ComponentCustomProperties, GlobalComponents and so on).

This means all libraries must update their code (or it will break the types of libraries that augment vue instead).

We've updated our types in Nuxt along these lines but you may experience issues with the latest vue-router when used with libraries which haven't yet done so.

Please create an issue with a reproduction - I'll happily help create a PR to resolve in the upstream library in question. Or you may be able to work around the issue by creating a declarations.d.ts in the root of your project with the following code (credit):

import type {
  ComponentCustomOptions as _ComponentCustomOptions,
  ComponentCustomProperties as _ComponentCustomProperties,
} from 'vue';

declare module '@vue/runtime-core' {
  interface ComponentCustomProperties extends _ComponentCustomProperties {}
  interface ComponentCustomOptions extends _ComponentCustomOptions {}
}

✅ Upgrading

As usual, our recommendation for upgrading is to run:

npx nuxi@latest upgrade --force

This will refresh your lockfile as well, and ensures that you pull in updates from other dependencies that Nuxt relies on, particularly in the unjs ecosystem.