You are reading Nuxt 2 docs. Head over nuxt.com for Nuxt 3 docs.

Release Notes

Discover all the release notes for the Nuxt framework

A landscape image A landscape image

Version v3.5.1

Released on May 21, 2023

3.5.1 is a patch release, with bug fixes and performance improvements.

✅ Upgrading

As usual, our recommendation for upgrading is to run:

nuxi 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: Use granular watcher to avoid crawling ignored dirs (#20836 )

🩹 Fixes

  • webpack: Analyze report path (#20878 )
  • nuxt: Allow island renders without / route (#20894 )
  • nuxt: Infer useFetch method when generic is passed (#20797 )
  • nuxt: Prioritise vue app context when available (#20910 )
  • nuxt: Don't refresh when hydrating when data is present (#20916 )
  • nuxt: Resolve layer assets in relation to layer directory (#20932 )
  • nuxt: Don't match partial component names with prefix (#20939 )
  • kit: Resolve relative module paths when installing (#20896 )
  • nuxt: Exclude plugin declaration from non-existent files (#20974 )
  • nuxt: Use default type for initial value for composables (#20968 )
  • nuxt: Skip middleware for islands components (#20924 )
  • nuxt: Use resolvePath to handle edge cases for modules (#20975 )

📖 Documentation

  • Fix defaults in custom fetch example (#20898 )
  • Fix typo (#20907 )
  • Add pnpm test command to run whole test suite (4907660ff )
  • Remove warning around experimental.renderJsonPayloads (891ba880e )
  • Add example of 'alphabetical' plugin numbering (#20930 )
  • rendering: Improve rendering modes section (244c68108 )
  • rendering: Lint fix (ef8b5b593 )
  • Sync useAsyncData and useFetch types (#20935 )
  • Update static to isr (#20964 )
  • Add advanced usage example of useState (#20249 )
  • Add link to layers from pages/ docs (#20976 )

🏡 Chore

🤖 CI

❤️ Contributors

Version v3.5.0

Released on May 16, 2023

3.5.0 is a minor (feature) release with lots of new features to play with.

👀 Highlights

⚡️ Vue 3.3 released!

Vue 3.3 has been released, with lots of exciting features, particularly around type support. This also brings a significant improvement to data fetching when navigating between nested pages (#20777 ), thanks to @antfu and @baiwusanyu-c .

  • new defineOptions macro
  • 'generic' components
  • typed slots and using external types in defineProps
  • ... and more

Read the full release announcement for more details.

🙌 Nitropack v2.4

We've been working on lots of improvements to Nitro and these have landed already in Nitro v2.4 - you may already have this upgrade, which contains a lot of bug fixes, updates to the module worker format for Cloudflare, Vercel KV support and more.

One note: if you're deploying to Vercel or Netlify and want to benefit from incremental static regeneration, you should now update your route rules:

routeRules: {
--  '/blog/**': { swr: 3000 },
++  '/blog/**': { isr: 3000 },
}

Read the full release notes .

💖 New defaults

Rich JSON payload serialisation is now enabled by default (#19205 , #20770 ). This is both faster and allows serialising complex objects in the payload passed from the Nuxt server to client (and also when extracting payload data for prerendered sites).

This now means that various rich JS types are supported out-of-the-box: regular expressions, dates, Map and Set and BigInt as well as NuxtError - and Vue-specific objects like ref, reactive, shallowRef and shallowReactive.

You can find an example in our test suite.

This is all possible due to Rich-Harris/devalue#58 . For a long time, Nuxt has been using our own fork of devalue owing to issues serialising Errors and other non-POJO objects, but we now have transitioned back to the original.

You can even register your own custom types with a new object-syntax Nuxt plugin:

plugins/custom-payload-type.ts
export default definePayloadPlugin(() => {
  definePayloadReducer('BlinkingText', data => data === '<original-blink>' && '_')
  definePayloadReviver('BlinkingText', () => '<revivified-blink>')
})

You can read more about how this works here .

🛝 Interactive server components

This feature should be considered highly experimental, but thanks to some great work from @huang-julien we now support interactive content within server components via slots (#20284 ).

You can follow the server component roadmap at #19772 .

⏰ Environment config

You can now configure fully typed, per-environment overrides in your nuxt.config:

export default defineNuxtConfig({
  $production: {
    routeRules: {
      '/**': { isr: true }
    }
  },
  $development: {
    //
  }
})

If you're authoring layers, you can also use the $meta key to provide metadata that you or the consumers of your layer might use.

Read more: #20329 .

💪 Fully typed pages

You can benefit from fully typed routing within your Nuxt app via this experimental integration with https://github.com/posva/unplugin-vue-router - thanks to some great work from @posva ! Out of the box, this will enable typed usage of navigateTo, <NuxtLink>, router.push() and more. You can even get typed params within a page by using const route = useRoute('route-name').

export default defineNuxtConfig({
  experimental: {
    typedPages: true
  }
})

🔎 'Bundler' module resolution

We now have full support within Nuxt for the bundler strategy of module resolution . We would recommend adopting this if possible. It has type support for subpath exports, for example, but more exactly matches the behaviour of build tools like Vite and Nuxt than Node16 resolution.

export default defineNuxtConfig({
  typescript: {
    tsConfig: {
      compilerOptions: {
        moduleResolution: 'bundler'
      }
    }
  }
})

This turns on TypeScript's ability to 'follow' Node subpath exports. For example, if a library has a subpath export like mylib/path that is mapped to mylib/dist/path.mjs then the types for this can be pulled in from mylib/dist/path.d.ts rather than requiring the library author to create mylib/path.d.ts.

⚗️ Separate server types

We plan to improve clarity within your IDE between the 'nitro' and 'vue' part of your app, and we've shipped the first part of this via a separate generated tsconfig.json for your ~/server directory (#20559 ). You can use by adding an additional ~/server/tsconfig.json with the following content:

{
  "extends": "../.nuxt/tsconfig.server.json"
}

Although right now these values won't be respected when type checking, you should get better type hints in your IDE.

💀 Deprecations

Although we have not typed or documented the build.extend hook from Nuxt 2, we have been calling it within the webpack builder. We are now explicitly deprecating this and will remove it in a future minor version.

✅ Upgrading

As usual, our recommendation for upgrading is to run:

nuxi 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

  • kit: Add prepend option to addImportsDir (#20307 )
  • nuxt: Add scoped helper for clearing error within boundary (#20508 )
  • nuxt: Auto import 'watchPostEffect' and 'watchSyncEffect' from vue (#20279 )
  • vite: Introduce vite:configResolved hook (#20411 )
  • webpack: Introduce webpack:configResolved hook (#20412 )
  • kit: Allow vite and webpack plugins to be prepended (#20403 )
  • nuxt: Add layer meta and env overrides to config types (#20329 )
  • test-utils: Add option to configure test server port (#20443 )
  • nuxt: Allow access to components within app (#20604 )
  • kit: Support passing getter to addVitePlugin and addWebpackPlugin (#20525 )
  • cli: Allow greater control of nuxi analyze from cli (#20387 )
  • nuxt: Add nuxtApp.runWithContext (#20608 )
  • deps: Upgrade to nitropack v2.4 (#20688 )
  • nuxt: Add experimental typedPages option (#20367 )
  • nuxt: Add apps to nuxt build-time instance (#20637 )
  • cli: Allow passing overrides to other nuxi commands (#20760 )
  • schema: Enable rich json payloads by default (#20770 )
  • deps: Update vue to v3.3 (#20478 )
  • nuxt: Use runWithContext within callWithNuxt (#20775 )
  • nuxt: Add useRequestURL helper (#20765 )
  • nuxt: Allow fallback production content in <DevOnly> (#20817 )
  • kit: addBuildPlugin for builder-agnostic implementation (#20587 )
  • nuxt: Allow keeping fallback for NuxtClientFallback (#20336 )
  • nuxt: Support separate server tsconfig (#20559 )
  • nuxt: Full scoped slots support for server components (#20284 )
  • nuxt: Support parallel plugins (#20460 )

🩹 Fixes

  • nuxt: Remove backwards-compatible runtimeConfig proxy (#20340 )
  • nuxt: Add @nuxt/devtools module before core modules (#20595 )
  • nuxt: Properly handle query for component wrapper (#20591 )
  • nuxt: Skip payload extraction for island context (#20590 )
  • nuxt: Remove internal <FragmentWrapper> (#20607 )
  • nuxt: Ensure useError is called with nuxt app context (#20585 )
  • nuxt: Run page meta plugin on all pages (and only pages) (#20628 )
  • nuxt, vite: Ignore nuxt_component ssr style and isVue (#20679 )
  • webpack: Warn when using deprecated build.extend hook (#20605 )
  • nuxt: Allow resolving client nuxt app to singleton (#20639 )
  • nuxt: Generate empty sourcemaps for wrappers (#20744 )
  • nuxt: Prevent treeshaking hooks with composable names (#20745 )
  • kit: Prefer esm resolution for modules to install (#20757 )
  • vite: Expand fs.allow dirs to include app files (#20755 )
  • nuxt: Deduplicate global components before registration (#20743 )
  • nuxt: Remove webstorm compatibility augmentation (0258acdc8 )
  • nuxt: Enable suspensible behaviour for nested pages (#20777 )
  • cli: Hard-reload nuxt when .env changes (#20501 )
  • nuxt: Avoid destructuring error prop (works around upstream bug) (#20795 )
  • nuxt: Always inline styles for server/island components (#20599 )
  • nuxt: Allow serialising undefined refs (#20828 )
  • nuxt: Transform client fallbacks directly on SFCs (#20835 )
  • vite: Dedupe/optimize more vue core deps (#20829 )
  • nuxt: Get fallback for <DevOnly> from parsed html (#20840 )
  • nuxt: Ensure all dir parts are present in component name (#20779 )
  • nuxt: Allow pages:extend to enable pages module (#20806 )
  • nuxt: Stop loading indicator on vue errors (#20738 )
  • nuxt: Add types for webpack/vite environments (#20749 )
  • nuxt: Pass from + savedPosition to first scrollBehavior (#20859 )

💅 Refactors

  • schema: Move runtimeCompiler option out of experimental (#20606 )
  • kit: Use esm utils for resolvePath (#20756 )

📖 Documentation

  • Fix typo (#20577 )
  • Update tailwind configuration guide (#20598 )
  • Fix fetch composable examples (#20603 )
  • Note that useCookie does not share state (#20665 )
  • Selective pre-rendering options (#20670 )
  • Ensure we guard all navigateTo examples (#20678 )
  • Add useSeoMeta and useServerSeoMeta pages (#20656 )
  • Recommend <NuxtLayout> when migrating error.vue (#20690 )
  • Add lagon to presets list (#20706 )
  • Add await before lazy composable examples (7e7e006e9 )
  • Add missing step migrating to pinia (#20778 )
  • Server directory improvements (d53cc604d )

🏡 Chore

✅ Tests

  • Test with bundler module resolution (#20629 )

🤖 CI

❤️ Contributors

Version v3.4.3

Released on April 28, 2023

3.4.3 is a patch release with the latest bug fixes. 🐞 It is expected that the next release will be v3.5, in approximately two weeks' time.

✅ Upgrading

As usual, our recommendation for upgrading is to run:

nuxi 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

🩹 Fixes

  • nuxt: Don't call timeEnd unless we're debugging (#20424 )
  • nuxt: Use key to force server component re-rendering (#19911 )
  • nuxt: Add basic typings for <ClientOnly> (f1ded44e8 )
  • nuxt: Use event.node.req in cookie utility (#20474 )
  • deps: Relax upper node version constraint (#20472 )
  • nuxi,schema: Support devServer.https: true (#20498 )
  • nuxt: Throw 404 when accessing /__nuxt_error directly (#20497 )
  • nuxt: Use callAsync for executing hooks with context (#20510 )
  • nuxt: Improved typing support for app config (#20526 )
  • nuxt: Call app:error in SSR before rendering error page (#20511 )
  • nuxt: Restrict access to single renderer outside of test/rootDir (#20543 )
  • nuxt: Throw errors when running legacy asyncData (#20535 )
  • nuxt: Transform #components imports into direct component imports (#20547 )
  • nuxt: Return RenderResponse for redirects (#20496 )

📖 Documentation

  • Fix typos on docs homepage (#20456 )
  • Update links to vue-router docs (#20454 )
  • Remove RC reference and add link to vue migration build (#20485 )
  • Add cdn proxy section (#20408 )
  • Add a next steps link to first page of migration docs (#20512 )
  • Add custom fetch composable example (#20115 )
  • Adjust wrong link after repo migration (#20536 )

✅ Tests

🤖 CI

  • Publish edge release with provenance (ec1503731 )
  • Run release script with node 18 (0d10e9734 )
  • Try releasing nuxt-edge with provenance (753c4c2a3 )
  • Run nuxt2 nightly release on node 14 again (48c034cf0 )

❤️ Contributors

Version v3.4.2

Released on April 20, 2023

3.4.2 is a patch release with the latest bug fixes and performance improvements

✨ What's new?

Apart from the normal bug fixes, we have a couple things we should call out.

  1. 🔥 We're now on Vite 4.3 (#20405 ). This was a performance-focused release and hopefully you'll be enjoying the speed improvements! Check out the release announcement for more info.
  2. 👀 It's now possible to experimentally enable @parcel/watcher for the Nuxt dev watcher (#20179 ). This may improve performance if you're on Windows. You'll probably also want to install watchman in that case.

✅ Upgrading

As usual, our recommendation for upgrading is to run:

nuxi 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: Share lazy component definitions (#20259 )
  • Remove unused deps and add implicit deps (#20356 )
  • Allow using @parcel/watcher for dev watcher (#20179 )

🩹 Fixes

  • vite: Set different cache dirs for client/server (#20276 )
  • nuxt: Generate hi-res sourcemaps (#20280 )
  • nuxt: Return type directly if not picking asyncData (#20288 )
  • nuxt: Provide more helpful error when instance unavailable (#20289 )
  • nuxt: Mark useRequestHeaders keys as optional (#20286 )
  • vite: Avoid serving arbitrary file in vite-node middleware (#20345 )
  • nuxt: Swap preloads for json/js payloads (#20375 )
  • nuxt: Handle pages with no content and log warning (#20373 )
  • test-utils: Import jest functions from @jest/globals (#20360 )
  • core,kit: Ensure module transpilation paths are dirs (#20396 )
  • schema: Rely on installed telemetry types (#19640 )
  • cli: Load kit from rootDir when preparing project (#20401 )
  • nuxt: Clone app config on server (#20278 )

💅 Refactors

  • nuxt: Rework and use isJS and isVue utilities consistently (#20344 )
  • vite: Use native isFileServingAllowed util (#20414 )

📖 Documentation

  • Update links on hooks page (#20296 )
  • Add brief information on debugging a nuxt app (#20282 )
  • Fix vue-tsc link (#20350 )
  • Update lint command for the documentation (#20399 )

🏡 Chore

🤖 CI

❤️ Contributors

Version v3.4.1

Released on April 13, 2023

3.4.1 is a patch release. We've pulled it forward slightly to fix a couple of breaking bugs in 3.4.0.

👉 Changelog

compare changes

🩹 Fixes

  • nuxt: Set config on ssrContext in spa renderer (#20216 )
  • nuxt: Mark entire payload as reactive (#20218 )
  • nuxt: Add missing imports to <NuxtClientFallback> (#20237 )
  • nuxt: Improve handling of redirects within middleware (#20244 )
  • nuxt: Do not redirect when vue-router normalises url (#20247 )

📖 Documentation

  • Add a brief description of transform/pick (#20186 )

✅ Tests

  • Add js payload test suite (#20217 )

❤️ Contributors

Version v3.4.0

Released on April 11, 2023

3.4.0 is a minor (feature) release for Nuxt 3 bringing exciting new features, including support for the View Transitions API, transferring rich JavaScript payloads from server to client - and much more.

👀 Highlights

🪄 View Transitions API Support

https://user-images.githubusercontent.com/904724/231222082-6bd4aeae-3026-407e-b3be-658df6305748.mp4


You can see a demo on https://nuxt-view-transitions.surge.sh

You may have noticed that Chromium-based browsers now ship a new web platform API: the View Transitions API . This is an exciting new ability for native browser transitions which (among other things) have the ability to transition between unrelated elements on different pages.

Nuxt now ships with an experimental implementation, which will be under active development during the v3.4 release cycle. See the known issues in the linked PR .

export default defineNuxtConfig({
  experimental: {
    viewTransition: true
  }
})

✨ Payload Enhancements

We've merged a significant change to how Nuxt handles payloads (under an experimental flag). Payloads are used to send data from the server to the client when doing server-side rendering and avoid double data-fetching during the hydration phase.

nuxt.config.ts
export default defineNuxtConfig({
  experimental: {
    renderJsonPayloads: true
  }
})

With this new option enabled, this now means that various rich JS types are supported out-of-the-box: regular expressions, dates, Map and Set and BigInt as well as NuxtError - and Vue-specific objects like ref, reactive, shallowRef and shallowReactive.

You can find an example in our test suite.

This is all possible due to Rich-Harris/devalue#58 . For a long time, Nuxt has been using our own fork of devalue owing to issues serialising Errors and other non-POJO objects, but we now have transitioned back to the original.

You can even register your own custom types with a new object-syntax Nuxt plugin:

plugins/custom-payload-type.ts
export default definePayloadPlugin(() => {
  definePayloadReducer('BlinkingText', data => data === '<original-blink>' && '_')
  definePayloadReviver('BlinkingText', () => '<revivified-blink>')
})

You can read more about how this works here .

Note: this only affects payloads of the Nuxt app, that is, data stored within useState, returned from useAsyncData or manually injected via nuxtApp.payload. It does not affect data fetched from Nitro server routes via $fetch or useFetch although this is one area I am keen to explore further.

Preliminary testing shows a significant speed-up: 25% faster in total server response time for a very minimal app with a large JSON payload, but I'd urge you to run your own tests and share the results with us.

As mentioned, we're merging this behind a flag so we can test this broadly and gather feedback on the new approach. The most significant potential change is that the payload is now no longer available on window.__NUXT__ immediately. Instead, we now need to initialise the Nuxt app to parse the payload so any code that accesses __NUXT__ will need to be run in a plugin or later in the Nuxt app lifecycle. Please feel free to raise an issue if you foresee or encounter issues in your projects.

🎁 Object-syntax Nuxt plugins

We now support object-syntax Nuxt plugins for better control over plugin order and easier registration of hooks.

plugins/my-plugin.ts
export default defineNuxtPlugin({
  name: 'my-plugin',
  enforce: 'pre', // or 'post'
  async setup (nuxtApp) {
    // this is the equivalent of a normal functional plugin
  },
  hooks: {
    // You can directly register Nuxt app hooks here
    'app:created'() {
      const nuxtApp = useNuxtApp()
      // 
    }
  }
})

In future we plan to enable build optimizations based on the metadata you pass in your Nuxt plugins.

🛠️ Easier Devtools Configuration

It's even easier to enable Nuxt DevTools in your project: just set devtools: true in your nuxt.config file to enable devtools.

nuxt.config.ts
export default defineNuxtConfig({
  devtools: true
})

If it's not already installed, Nuxt will prompt to install it locally. This means you no longer need to have Nuxt DevTools enabled globally.

Note: the DevTools is still experimental and under active development, so do be prepared for occasional unexpected behaviour, and please report issues directly to https://github.com/nuxt/devtools 🙏

📚 Layers Improvements

We now support transforming ~/~~/@/@@ aliases within layers , meaning you now no longer need to use relative paths when importing within layers.

This should mean it is much easier to use a 'normal' Nuxt project as a layer without needing to specially write it as one.

🧸 Better Context Transforms

We now transform certain keys of definePageMeta and defineNuxtComponent which means you should have fewer issues with a missing Nuxt instance. This includes support accessing the Nuxt instance after an await within asyncData and setup functions for those still using the Options API. And you no longer need to wrap middleware and validate with defineNuxtRouteMiddleware when using async functions.

♻️ Ecosystem Updates

As usual, this release will pull in upstream improvements, including the new Consola v3 and Nitropack v2.3.3 (a new minor is expected shortly).

🚨 'Breaking fixes'

We've also taken the opportunity to do some cleanup in this minor release.

  1. Previously it was possible to pass the x-nuxt-no-ssr header (undocumented) to force SPA rendering. We've now disabled this behaviour by default but you can get it back by setting experimental.respectNoSSRHeader to true. Alternatively, you can set event.context.nuxt.noSSR on the server to force SPA rendering.
  2. We've removed the (deprecated) #head alias and also disabled the polyfill for @vueuse/head behaviour by default. (It can still be enabled with experimental.polyfillVueUseHead.)
  3. We've removed the (deprecated) experimental.viteNode option . It can be configured instead with vite.devBundler.
  4. We've deprecated accessing public runtime config without the public key . This was an undocument compatibility measure with Nuxt 2 and we plan to remove it entirely in v3.5.
  5. To fix a bug with our vue-router integration, we now generate a slightly different path matching syntax. If you were relying on the exact path generated, have a look at #19902 for more information.

✅ Upgrading

As usual, our recommendation for upgrading is to run:

nuxi 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.

With Nuxt v3.4.0, we now advise that you explicitly install the @types/node version that matches your Node version.

👉 Changelog

compare changes

🚀 Enhancements

  • nuxt: Warn in dev when useRoute is used in middleware (#20050 )
  • nuxt: Support disabling watch with useFetch (#19823 )
  • nuxt: Support ~/~~/@/@@ aliases within layers (#19986 )
  • nuxt: Respect custom dir.pages in page placeholder (#20079 )
  • nuxt: Support vue runtime compiler (#4762 )
  • test-utils: Allow mounting single component for testing (#5723 )
  • nuxt: Experimental option for rich json payloads (#19205 )
  • nuxt: Prompt to install devtools when it's enabled (#20126 )
  • Upgrade to consola v3.x prerelease (#20141 )
  • nuxt: Add experimental View Transitions API support (#20092 )
  • nuxt: Support async transform of object properties (#20182 )
  • nuxt: Support object-syntax plugins (#20003 )
  • nuxt: Add experimentalNoScripts route rule (#19805 )
  • nuxt: Add chokidar watcher debug timing (#20176 )

🔥 Performance

  • head: Disable @vueuse/head polyfill by default (#20131 )

🩹 Fixes

  • nuxt: End route param tokens manually (#19902 )
  • nuxt: Disable x-nuxt-no-ssr header by default (#20024 )
  • kit: Support calling Nuxt 2 modules with module container (#20023 )
  • nuxt: Add types for globally injected $config object (#20081 )
  • nuxt: Throw error on protocol relative path in useFetch (#20052 )
  • nuxt: Add @types/node as a peerDependency (#20025 )
  • nuxt: Test all custom app config keys for any (#20105 )
  • nuxt: Add key to .client component placeholders (#20093 )
  • nuxt: Add undefined type for useCookie return value (4f0b3c722 )
  • nuxt: Deprecate old (pre-rc) runtimeConfig (#20082 )
  • cli: Preview nitro build with custom dir config (#18882 )
  • nuxt: Default nitro autoImports to imports.autoImport (#20180 )
  • nuxi, vite: Suppress sourcemap + native fetch warnings (#20198 )
  • schema: Allow ignorePrefix to be changed (#20202 )

💅 Refactors

  • schema: Clean up experimental options (#20112 )
  • nuxt: Remove #head alias (#20111 )

📖 Documentation

  • Add interop default to dynamic vue import example (8908aa7c5 )
  • Add short note about custom imports configuration (#20073 )
  • Re-enable docs linting and update docs (#20084 )
  • Fix type of headers option for useFetch (#20148 )
  • Fix typo in @pinia/nuxt module name (#20199 )
  • Add import to server-side cookies example (#20197 )

🏡 Chore

✅ Tests

🎨 Styles

🤖 CI

❤️ Contributors

Version v3.3.3

Released on April 2, 2023

3.3.3 is your regularly scheduled bugfix/patch release.

✅ Upgrading

As usual, our recommendation for upgrading is to run:

nuxi 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

🩹 Fixes

  • schema: Prefer src to rootDir aliases (#19937 )
  • nuxt: Don't override options signature with schema (#19934 )
  • vite: Allow extending vue config per-environment (#19968 )
  • nuxt: Store payloads in cache without trailing slash (#19992 )
  • webpack: Transpile rest of nuxt runtime directories (#19936 )
  • nuxt: Suppress handled errors (#20002 )
  • vite: Remove separate rollup dependency (#20013 )
  • nuxt: Sync setResponseStatus signature with h3 (#19987 )
  • schema: Add export condition for nuxt2 support (1fd491f1a )

💅 Refactors

  • vite: Use rollup types re-exported from vite (#20011 )

📖 Documentation

🏡 Chore

✅ Tests

  • Skip bundle size test in ecosystem-ci suites (434e2013e )
  • Bump bundle size test by 100 bytes (5785908ec )

🤖 CI

❤️ Contributors

Version v3.3.2

Released on March 24, 2023

3.3.2 is a patch release with plenty of bug fixes.

✅ Upgrading

As usual, our recommendation for upgrading is to run:

nuxi 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: Experimentally disable vue server renderer nitro endpoint (#19825 )

🩹 Fixes

  • kit: Provide name to performance.mark() (#19687 )
  • nuxt: Unpause DOM updates on suspense resolve (#19740 )
  • kit: Handle node 14 performance behaviour (#19733 )
  • webpack: Transpile app directory (#19773 )
  • nuxt: Unset context after app is created (#19753 )
  • cli: Watch dist and register restart hook after nuxt is ready (#19736 )
  • nuxt: Ignore falsy modules (#19684 )
  • nuxt: Use h3 utilities to set response status/code (#19713 )
  • nuxt: Add temporary augmentation for webstorm (and docs) (#19400 )
  • nuxt: Handle external navigation to api routes (#19829 )
  • nuxt: Observe slot element in custom nuxt-link (#19802 )
  • nuxt: Directly render server components (#19605 )
  • vite: Support multiple rollup entries (#19842 )
  • nuxt: Ignore schema types that eval to any (#19835 )
  • nuxt: Use prerender cache for islands (#19822 )
  • nuxt: Add missing import in islands template (#19870 )
  • kit: Check if nuxt is restarting before updating templates (#19830 )
  • test-utils: Allow overriding nitro options (#19872 )
  • kit: Add legacy entrypoints for pre v3.3 usage (#19874 )

📖 Documentation

  • Fix auto-imports example (#19520 , #19690 )
  • Update seo and meta page (#19697 )
  • introduction: First batch of improvements (98b9afa6d )
  • Update module author guide (#18551 )
  • Add 'going further' section for custom routing (#19565 )
  • Improve installation prerequisites (c570ae272 )
  • Update custom routing link (8d644903b )
  • Add backticks (#19721 )
  • Add link to layout transitions (#19770 )
  • Fix typo (#19775 )
  • Fix typo (#19779 )
  • Fix typo (#19785 )
  • Add missing comma (#19791 )
  • Update legacy server examples (#19797 )
  • Third-party state management and migration guide (#19798 )
  • Link to module request issue template (#19754 )
  • Improve swr documentation (#18743 )
  • Add another example for useAsyncData (#19225 )
  • Avoid $fetch in top-level <script setup> (#19357 )
  • Removing deprecated coming soon banner (#19817 )
  • Add serialization section to data fetching (#19336 )
  • Add protocol to superjson link (cebfcb3da )
  • Update play on X links (8c11498a5 )
  • Add missing return statement (fc7867fb0 )
  • Replace @nuxt/kit example with node built-ins (#19873 )
  • Add layers video by LearnVue (d3d09d5d3 )
  • Improve components page (340725bb0 )

🏡 Chore

✅ Tests

🤖 CI

❤️ Contributors

Version v3.3.1

Released on March 14, 2023

3.3.0 is a minor (feature) release with lots of new features to play with. 3.3.1 was a swiftly following release to patch an issue with nuxi on Windows.

👀 Highlights

✨ Local module development DX

We've landed a raft of changes to enable local modules and improve DX. We now auto-scan your ~/modules folder and register top level files there as modules in your project (#19394 ). When these files are changed, we'll automatically restart the nuxt server.

  export default defineNuxtConfig({
    modules: [
      '@nuxtjs/tailwindcss',
-     '~/modules/purge-comments'
    ]
  })

We also now expose nuxt/kit for easy access to kit composables in your local project without having to install @nuxt/kit (#19422 ).

♻️ Restarting Nuxt

You can add files to the watch array to automatically restart the server (#19530 ). This is likely to be particularly useful for module authors. You can also trigger a restart of the Nuxt server with the new restart hook (#19084 ). We also landed a couple of fixes on restarting the Nuxt server which should improve your experience when developing.

🔥 Performance improvements

We've increased static asset maxAge to 1yr as a matter of best practice (#19335 ), and support tree-shaking more of your build (#19508 ). We also now support preloading <NuxtLink>s with a route in object-syntax (#19120 ).

CleanShot 2023-03-14 at 12 19 50

We also track how long it takes each module you use to perform its setup, and warn if it takes too long. You can see all these values by running your dev server with DEBUG=1

You can also opt-in to some of Nuxt's internal optimisations by configuring composables to be treeshaken in a particular environment (#19383 ), or to have magic keys automatically injected (#19490 ) - primarily useful for module authors.

🐛 Error handling

We now handle chunk errors by default (#19086 ), meaning if your site updates with a redeploy, we automatically handle reloading it on navigation. You can disable this and handle it yourself with the new reloadNuxtApp composable. You can also set experimental.restoreState to preserve some of your app state across reloads.

We also have a new experimental error handling component: <NuxtClientFallback> (nuxt/framework#8216 ) which can capture errors rendering on server, replace them with fallback content, and granularly trigger rerendering the part with an error on the client. This can be enabled with experimental.clientFallback - feedback very welcome!

⚡️ Head improvements

We've migrated to use unhead directly (#19519 ) - and automatically tree-shake server-only head composables like useServerHead from your client build (#19576 ), meaning you can have great SEO without needing to include meta tag logic that's relevant only for crawlers in your client build.

There's also a new useHeadSafe composable that handles santising untrusted user input (#19548 ).

🪵 Better logging in browser DevTools

Working with the Chrome DevTools team, we've landed a couple of features across the unjs + Nuxt ecosystem meaning we now have first-class support for hiding Nuxt internal stack traces from logs in your (Chromium-based, for now) browser (#19243 ). We also landed a couple of improvements with stacktraces involving Nuxt hooks (unjs/hookable#69 and unjs/hookable#68 ) implementing console.createTask .

Before After
CleanShot 2023-03-14 at 11 55 00 CleanShot 2023-03-14 at 11 52 27

💪 Type improvements

Types for server API routes are now more correct - with non-serialisable types stripped out of the return type (unjs/nitro#1002 ).

We also now type more of NuxtApp and correctly type unknown injections for greater type-safety (#19643 ).

CleanShot 2023-03-14 at 11 59 58

And if you were struggling with correct types when using transform + default with Nuxt data fetching composables, fear no more - we now infer the types correctly (#19487 ).

⚗️ Nitro enhancements

This release comes with Nitro v2.3, which brings lots of improvements of its own. Check out the release for more info.

We now support useAppConfig in nitro server routes (#19489 ) - a long-awaited change. Now useAppConfig is consistently available throughout your app for non-runtime configuration from layers, modules, etc.

We've also added a nitro:build:public-assets hook to allow modifying assets output from nitro's prerender/build phase (#19638 ).

🛠️ Build changes

As part of moving towards first-class support for PNP and pnpm support without --shamefully-hoist , we've dropped support for some internal (deprecated) utilities using CJS resolve patterns (#19537 , #19608 ). We also now resolve dependencies like nuxt, @nuxt/kit and more using ESM search-paths. We'll be keeping a close eye on this.

We're also preparing the groundwork for support of new TypeScript Node16 module resolution (#19606 ), and as part of this have changed the format of our runtime output (using .js instead of .mjs extensions, providing types fields for subpath exports, and more).

🗺️ Custom config schema (advanced)

We've been testing out an experimental feature to allow modules and users to extend the Nuxt config schema (#15592 ), and we've now enabled this by default (#19172 ). We expect this will be particularly useful for module and layer/theme authors, and should result in some nicer DX for their users.

Changelog

compare changes

🚀 Enhancements

  • nuxi: Enforce consistent casing in filenames (#19088 )
  • nuxi: Reload nuxt when restart hook is called (#19084 )
  • nuxt: Scan composables with star export (#19249 )
  • nuxt: Add versions to runtime nuxtApp (#19064 )
  • vite: Add node_modules and buildDir to x_google_ignoreList (#19243 )
  • nuxi: Cli wrapper for self restart (#18641 )
  • schema: Allow adding page routes without a matching file (#19173 )
  • nuxt: Add support for nuxt/kit subpath for local use (#19422 )
  • nuxt: Auto-register modules in ~/modules (#19394 )
  • nuxt: Enable config schema by default (#19172 )
  • kit,nuxt: Add component priority to allow overriding (#19252 )
  • nuxt: Enable preloading object-syntax routes (#19120 )
  • nuxt: Support trailingSlashBehavior in defineNuxtLink (#19458 )
  • nuxt: Allow configuring treeshakeable composables (#19383 )
  • nuxi,schema: Add support for setting nuxt logLevel (#19369 )
  • nuxt: Support custom keyed composables (#19490 )
  • nuxi: Programmatically pass nuxt config overrides (to dev) (#19371 )
  • vite: Use custom logger to show vite logs (#19523 )
  • nuxt: Enable chunk error handling by default (#19086 )
  • nuxt: Add <NuxtClientFallback> component (#8216 )
  • nuxt: Add watch option and refactor dev server restarting (#19530 )
  • nuxt: Add useHeadSafe and remove layer around head imports (#19548 )
  • kit, schema: Measure module setup timings (#18648 )
  • nuxt: Support app config for server routes (#19489 )
  • nuxt: Add nitro:build:public-assets hook (#19638 )

🔥 Performance

  • nuxt: Increase static asset maxAge to 1yr (#19335 )
  • vite: Mark more core functions as side-effect free (#19508 )
  • nuxt: Drop @vueuse/head dependency (#19519 )
  • nuxt: Tree-shake server composables + prefer server head (#19576 )

🩹 Fixes

  • nuxt: Clear loading indicator on unmount (#19340 )
  • nuxt: Deprecate scanning directory index plugins (#18418 )
  • nuxt: Prevent fallthrough attributes on custom NuxtLink (#19379 )
  • schema: Update vite import.meta types (#19338 )
  • vite: Omit / from sourcemapIgnoreList for windows support (73ade185b )
  • nuxt: Pass transform options to component loader plugin (#19414 )
  • nuxi: Avoid top-level await in wrapper (44068420d )
  • nuxt: Add kit.* files to published package (#19430 )
  • nuxt: Don't print layout warning if page is not ssr (#19434 )
  • kit: Match commit hashes of other lengths (#19450 )
  • nuxi: Handle different kind of shutdown signals (#19485 )
  • nuxt: Exclude nitro output dir from type checking (#19532 )
  • vite: Allow disabling clear screen behaviour (#19531 )
  • nuxt: Only log boot errors on client-side (#19553 )
  • nuxt: Dedupe payload cache by payload url (#19563 )
  • nuxt: Provide node16-style type exports (#18431 )
  • nuxt: Avoid injecting adhoc modules in schema (#19607 )
  • nuxt: Improve types for data fetching with transform (#19487 )
  • nuxi: Resolve kit from nuxt modules dir (#19601 )
  • nuxt,schema: Merge custom and resolved app configs (#19602 )
  • nuxt: Resolve builder using esm syntax (#19608 )
  • nuxt: Exclude boolean from inline module definitions (#19621 )
  • schema: Show payloadExtraction warning only when unset (#18516 )
  • nuxt: Mark non-augmented NuxtApp properties as unknown (#19643 )
  • nuxt: Fix default injection type for plugins (#19669 )

💅 Refactors

  • nuxi: Hard restart with communication channel (#19423 )
  • kit,nuxi: Resolve module paths using node algorithm (#19537 )
  • nuxt: Let mlly handle search paths (#19635 )

📖 Documentation

  • Use consistent indentation in examples (#19342 )
  • Update esm link (c35104c76 )
  • Add frontmatter note for docs readme to remove from live preview (008426cd3 )
  • Add edge banners on versions and modules (#19448 )
  • Add local modules ordering (5977adb4d )
  • Fix link to nitro routeRules (#19455 )
  • Fix dead link to useSeoMeta guide (#19463 )
  • Update devServer.https example (#19486 )
  • Add info ~/server/utils directory in ~/utils page (#19500 )
  • Update addComponent jsdoc comment (#19503 )
  • Update cli docs for --log-level (06b9233b1 )
  • Update pr template to include jsdoc annotations (#19511 )
  • Add new release cycle info (#19509 )
  • Fix local modules (c4222b1f6 )
  • Update nitro plugins url (#19547 )
  • Ui components - pinceau migration (#19533 )
  • Update $fetch documentation (#19356 )
  • Move prerequisites into a summary (e0cb950f0 )
  • Remove note since already in code block for pnpm (d67a873c4 )
  • Add nuxt 2 to nuxt 3 workshop (2905282de )
  • Update various nitro links (#19562 )
  • Use consistent page name in example (#19583 )
  • Add missing backquotes (#19590 )
  • Remove reference to beta/rc/coming soon (4ad5c959e )
  • Warn about modules with side-effects (#19592 )
  • Mention config file name before code block (#19634 )

🏡 Chore

  • Bump edge version based on commits (#19397 )
  • Add branch to edge release script (171288586 )
  • Add chore to type of change in pr template (#19420 )
  • Mark @nuxt/test-utils package as external group (#19419 )
  • Restrict commit hash strings to 8 chars (abcd27ae0 )
  • deps: ⚠️ Update dependency fork-ts-checker-webpack-plugin to v8 (main) (#19468 )
  • Force minor bumps at most (0b82f6751 )
  • nuxt: Update to new hasProtocol options format (#19555 )
  • Improve internal type safety (#19599 )
  • Refresh lockfile (#19653 )
  • Constrain nitro to minor version (88a5f38de )
  • Bump package versions (615750614 )

✅ Tests

🤖 CI

⚠️ Breaking Changes

  • deps: ⚠️ Update dependency fork-ts-checker-webpack-plugin to v8 (main) (#19468 )

❤️ Contributors

Version v3.2.3

Released on February 28, 2023

3.2.3 is a patch release with bug fixes and performance improvements.

👉 Changelog

compare changes

🔥 Performance

  • nuxt: Don't update manifest in dev mode (#19315 )

🩹 Fixes

  • cli: Restart nuxt when distDir is unlinked (#19131 )
  • vite: Normalize path emitted by vite watcher (#19179 )
  • nuxt: Prefetch object-syntax routes with <NuxtLink> (#19144 )
  • webpack: Use default export from webpack (#19166 )
  • nuxt: Preserve (re)named imports in meta (#19192 )
  • nuxt: Log errors thrown when booting the nuxt app (#19187 )
  • nuxt: Preserve explicit rel attribute on internal link (#19309 )
  • nuxt: Compatible route object for custom external routes (#19261 )
  • vite: Handle non-iterable noExternal option (#19256 )

📖 Documentation

  • Fix components path (#19163 )
  • pages: Add example of limiting scanned routes (#19181 )
  • Update link (#19197 )
  • Clarify that app config is not available (yet) in nitro (#19200 )
  • Improved going further modules documentation (#19219 )
  • Add docs badge (3c006b33c )

🏡 Chore

🤖 CI

❤️ Contributors

Version v3.2.2

Released on February 17, 2023

3.2.1 is a patch release with (lots of) bug fixes and performance improvements since last week's minor release. 3.2.2 was a swiftly following release to patch an issue with nuxi init

👀 Highlights

As a patch release, there are mostly bug fixes and performance improvements in the changelog. (Nevertheless, it's always worth reading through!) But one point of note is an experimental reload strategy when chunk errors are encountered. We're hoping to finalise the API and land it in v3.3 (our next feature release) with #19086 , but you can test out an experimental version with the following config:

export default defineNuxtConfig({
  experimental: {
    emitRouteChunkError: 'reload'
  }
})

With this strategy, your app will hard reload on route changes if there's a chunk error. More info at #19038 .

👉 Changelog

compare changes

🚀 Enhancements

  • nuxt: Add experimental app:chunkError hook and reload strategy (#19038 )

🔥 Performance

  • nuxt: Allow tree-shaking empty meta from build (#19032 )
  • nuxt: Animate transform rather than width (#19073 )
  • nuxt: Don't include side-effects from #components (#19008 )

🩹 Fixes

  • schema: Allow type inference of arrays in runtime config (#18931 )
  • nuxt: Avoid recursive import in nitro renderer (#18948 )
  • nuxt: Expose nuxt/schema subpath for augmentation (#18922 )
  • nitro: Ensure ssr error statusCode is a number (#19001 )
  • nuxt: Prevent hyphens forming child routes & warn if dupes are detected (#18944 )
  • schema: Transpile nuxt/app by default (#19009 )
  • vite: Exclude nuxt/app from optimised deps (9e789c76c )
  • vite: Respect isCustomElement config for jsx transform (#19053 )
  • nuxt: Use parser to treeshake client-only declarations (#18951 )
  • cli: Pass through exit code from test errors (#18959 )
  • nuxt: Show client error if no page matches after validate fails (#18978 )
  • cli: Read devServer options from nuxt config (#19055 )
  • nuxt: Validate no // in path when constructing payload url (#19085 )
  • nuxt: Restore previous check on payload url (e9ff34ace )
  • nuxt: Test generated pathname (af55b9882 )
  • nuxt: Respect redirects which differ only by trailing slash (#18593 )
  • nuxt: Pass nuxt + workspace paths when importing builder (#19099 )

💅 Refactors

  • nuxt: Combine imports from same relative path (ee2f568fc )

📖 Documentation

  • Add info for nuxi devtools command (#18888 )
  • Update link to bridge repo (#18950 )
  • Fix typos (#18976 )
  • Fix typo (#18975 )
  • Fix link to ESM page (#19000 )
  • Fix spacing (#19018 )
  • Flatten top-level project in layers example (#18967 )
  • Remove reference to obsolete static property (80f73d39c )
  • Add note about nested directory order (#19061 )
  • Updated public directory explanation (#18464 )
  • Add information on when mw runs & how to skip (#19083 )
  • Add sendRedirect usage (#19070 )

📦 Build

🏡 Chore

  • Increase node 14 minor version constraint (#19111 )
  • Update nitropack and unjs dependencies (#19100 )
  • Dedupe rollup (576ce9ee3 )

✅ Tests

  • Skip vnode warning on windows dev mode (71bcd9550 )

🤖 CI

  • Run webpack/vite and dev/prod as matrices (#18905 )

❤️ Contributors

Version v3.2.0

Released on February 9, 2023

3.2.0 is the first minor release since we've started our new release schedule. We've brought it forward by a couple of weeks to include some goodies we want you to be able to play with soon.

👀 Highlights

  • ⚡️ Nuxt DevTools

    You can opt-in to Nuxt DevTools per-project by going to the project root and running:

    npx [email protected] devtools enable

    Restart your Nuxt server and open your app in browser. Click the Nuxt icon on the bottom (or press Alt+D) to toggle the DevTools.


    More information in the docs !
  • ✨ Better DX for overriding runtimeConfig, including inline type helpers

  • 🪄 Automatically inferred return type for useFetch and $fetch based on method.

    It'll be a type error to use the wrong method when hitting an endpoint.

    Plus, if you have multiple methods served by a single endpoint (like ~/server/api/test.get.ts and ~/server/api/test.post.ts then the response type will match the kind of response you make.

  • 🍪 useFetch is now integrated with event.$fetch, meaning cookies and context are now passed to api requests automagically within internal requests.
  • 🔥 We now treeshake client-only components out of the server build more effectively using the experimental treeshakeClientOnly feature

    This is turned on by default but if you experience any issues, you can turn this off via:

    export default defineNuxtConfig({
  experimental: {
    treeshakeClientOnly: false
  }
})
  • 🛠️ New addRouteMiddleware kit utility for module authors
  • 💪 Nitropack v2.2 has been released

    Lots of features, including runtime proxy support using route rules, nested fetch calls, binary and raw storage operations, exposed event.context.cf (cloudflare) and built-in session support.

    For full details see release notes

Changelog

compare changes

🚀 Enhancements

  • kit: Add addRouteMiddleware method (#18553 )
  • cli: Warn when prerendering routes with ssr: false (#18783 )
  • schema: Add type hints for runtime config (#18652 )
  • nuxt: Support type auto-import (#18859 )
  • nuxt: Infer useFetch return based on the method (#18526 )
  • cli: Add initial support for enabling/disabling devtools (#18864 )
  • nuxt: Upgrade to nitropack 2.2 (#18889 )

🔥 Performance

  • vite: Use stub entry in vite server build when ssr: false (#18782 )

🩹 Fixes

  • nuxt: Treeshake client-only components with placeholders (#8789 )
  • webpack: Client-side typechecking when ssr: false (#18828 )
  • vite: Exclude styles, not all assets (#18752 )
  • nuxt: Defer adding route path to preloaded record (#18862 )
  • nuxt: Don't exclude pnpm layers from nitro esbuild/imports (#9952 )
  • nuxt: Use parser to treeshake <ClientOnly> (#8713 )
  • Reorder the types field in package.json (#18880 )

💅 Refactors

  • nuxt: Within nuxt app, import directly from source file (#18902 )

📖 Documentation

  • Remove extra word (#18750 )
  • example: Fix app config link (#18760 )
  • Add useError composable (#8912 )
  • Clarify augmenting input/output app config (#8953 )
  • Add explanation of composable lifecycle (#8116 )
  • typescript: Type-checking guide (#18768 )
  • schema: Add NuxtHooks interface documentation (#18756 )
  • Resolve preloadRouteComponents page heading error (#18804 )
  • Update to nuxt 2.16.0 in bridge installation (#18836 )
  • Add link to vue hydration mismatch docs (#18842 )
  • Update auto-imports for the server part (#18848 )
  • Warn about slots in server components (#18854 )
  • Add explanation with augmented meta for new routes (#18901 )

✅ Tests

❤️ Contributors

Version v3.1.2

Released on February 3, 2023

3.1.2 is a patch release with bug fixes (particularly focusing on performance and DX).

Changelog

compare changes

🔥 Performance

  • nuxt: Simplify generated variable names (#18629 )
  • vite: Use compiled regexp for test (#18646 )
  • nuxt: Cache result of importing styles module (#18734 )

🩹 Fixes

  • nuxt: Provide fallback values for undefined runtime config (#18586 )
  • kit: Don't use default export of defu (#18589 )
  • Use named export from defu in all places (#18624 )
  • nuxt: Dedupe vue-router (#18626 )
  • test-utils: Prevent orphaned processes and use baseURL when loading (#18623 )
  • vite: Ensure __publicAssetsURL set before loading assets (#18642 )
  • kit: Avoid adding already installed modules to internal _installedModules (#18647 )
  • nuxt: Make onNuxtReady safe to run on server-side (#18706 )
  • vite, webpack: Omit magic keys when import of same name is detected (#18733 )

📖 Documentation

  • Update vue-gtag plugin example (#18528 )
  • Mention virtual file system (#18546 )
  • Mention head composable as alternative to useHead (#18552 )
  • Use defineEventHandler() to avoid warnings (#18557 )
  • Remove unnecessary JSON.stringify() (#18590 )
  • Updated unreachable docus url in documentation (#18618 )
  • Add link to pages documentation to routing (#18602 )
  • Add comment about needing to install @types/node manually (6b2bc680b )
  • Add note about directory import (d2c00dc46 )
  • Fix array syntax (f14f3815f )
  • Fix buttons width on getting started (#18643 )
  • Add .env to directory structure and improve config docs (#18594 )
  • Mention options api equivalent for head() (#18650 )
  • Fix broken link to esm section (#18716 )
  • Improve routing validate example (#18728 )

🏡 Chore

✅ Tests

  • nuxt: Exclude new internal vue assertNumber helper (aa646f065 )

🤖 CI

❤️ Contributors

Version v3.1.1

Released on January 25, 2023

3.1.1 is a bugfix release to address a problem rendering components injected by Vue or Nuxt plugins.

Update notes

There's also a Nitro upgrade to v2.1.0 released shortly after v3.1.1, so when upgrading, please either run nuxt upgrade --force or refresh your lockfile.

Changelog

compare changes

🩹 Fixes

  • nuxt: Do not override inferred type of <NuxtPage> (#18495 )
  • nuxt: Don't render unknown components with placeholder (#18494 )
  • vite: Ensure newly created pages do not return 404 (#18447 )
  • nuxt: Async transform for inline middleware (#18460 )
  • nuxt: Augment interfaces exported from vue (#18505 )

📖 Documentation

  • Remove useNuxtData release alert (#18488 )
  • Simplify the docs directory (#18506 )
  • Add info about server-components async limits (#18513 )
  • Keep app.vue file name consistent (#18517 )

❤️ Contributors

Version v3.1.0

Released on January 24, 2023

3.1.0 is the first minor release after Nuxt 3.0 including bug fixes and enhancements.

💬 Release Discussion

👀 Highlights

Changelog

compare changes

🚀 Enhancements

  • nuxt: Experimental server component islands (#5689 )
  • nuxt: Add onNuxtReady composable (#9478 )
  • useNuxtData composable (#9262 )
  • nuxt: Support for extending error.vue in layers (#9521 )
  • vite: Upgrade to vite 4 (#9238 )
  • nuxt: Deep watch useCookie ref value by default (#9664 )
  • vite: Display production build stats (#9761 )
  • nuxt: Server-only components (#9972 )
  • imports: imports:context hook for unimport context (#9971 )
  • vite: Support build.transpile as function (#7767 )
  • nuxt: Prefetch middleware/layouts + await layout loading (#10155 )
  • nuxt: Support server components with extracted payloads (#10113 )
  • kit: Add extendRouteRules method (#9771 )
  • nuxt: Allow disabling color for <NuxtLoadingIndicator> (#18432 )
  • head: useSeoMeta composable (#18441 )
  • Experimental config schema (#18410 )

🔥 Performance

  • nuxt: Use static import of @unhead/ssr (#9826 )
  • nuxt: Add tree-shaken useServerSeoMeta composable (#18476 )

🩹 Fixes

  • Remove postcss.config from schema (#9181 )
  • nuxt: Include missing <NuxtPage> component props (#9204 )
  • nuxt: Allow layouts to receive custom props (#9395 )
  • test-utils: Do not hide vitest output (#9442 )
  • nuxt: useCookie with defaults should return non-null value (#9449 )
  • nuxt: Defer render-blocking prefetches until after load (#9475 )
  • nuxt: Speculation rules should be reactive (#9472 )
  • kit: Support applying .nuxtignore within external layers (#9599 )
  • nuxt: Remove deprecated req/res access (#9636 )
  • nuxt: Await plugin asyncdata promises in nuxt hook (#9616 )
  • schema: Add hookable dependency (#9648 )
  • vite: Skip only vite transform middleware (#9602 )
  • nuxt: Remove absolute paths from routes objects (#9655 )
  • nuxt: Make dev-only regexp less greedy (#9679 )
  • nuxt: Set is loading state for <NuxtLoadingIndicator> after throttle (#9832 )
  • cli: Show an error if no value is supplied for the --template flag (#9946 )
  • vite: Defer to nitro to copy public dir (#10013 )
  • nuxt: Include components runtime dir in build output (#10046 )
  • nuxt: Add build.transpile strings to nitro inline list (#10094 )
  • nuxt: Support deep assign on empty object for app config (#10087 )
  • nuxt: Don't short circuit middleware after validate function (#9180 )
  • nuxt: Don't try to override computed layouts in definePageMeta (#9161 )
  • nuxt: Allow overriding lower layer composables (#10017 )
  • nuxt: Update class prop type for head components (#9133 )
  • nuxt: Avoid injecting url helpers into globalThis (#9627 )
  • nuxt: Name anonymous components in render tree (#10011 )
  • vite: Add additional before skipping vite transform (#10120 )
  • kit: Resolve group syntax of ignore (#15884 )
  • nuxt: Use query for hashing the fetch key (#18411 )
  • cli: Prevent showing stack traces while scaffolding (#9962 )
  • nuxt: Provide types for modules as array (#18416 )
  • vite: Don't skip loading styles in hydration phase (#18433 )
  • vite: Enable css sourcemaps in dev based on sourcemap (#18446 )
  • nuxt: Await async callWithNuxt calls (#18443 )
  • nuxt: Let router handle internal redirects within middleware (#18445 )
  • nuxt: Import onServerPrefetch (629d2c099 )
  • Upgrade unimport, close #15594 (#15594 )
  • Upgrade unimport (#18475 )

💅 Refactors

  • jobs: Remove unused asset (#9116 )
  • nuxt: Fix typo in internal plugin names (#9201 )
  • nuxt: Use pathe.join for layer lookup (#9540 )
  • Split out type imports from value imports (#9225 )
  • nuxt: Remove vue-meta for head support (#9638 )
  • nuxt: Do not add all composable auto-imports to globalThis (#9630 )
  • vite: Show log when client build is starting (#9759 )
  • home: Sections (#9882 )
  • Heros (#9886 )
  • Improve internal type definitions of <NuxtLink> (#9869 )

📖 Documentation

  • Update to 3.0 and upgrade theme (cd2ad7108 )
  • Fix paths to migration guides (#9071 )
  • Fix broken paths (#9076 )
  • Set nuxt stability to stable (#9075 )
  • Fix broken link (24c8653b2 )
  • Update redirects (f01fc1863 )
  • seo: Add robots file (#9111 )
  • Improve images quality (#9112 )
  • Fix broken links in examples (#9119 )
  • Bump website theme version to 0.1.5 (#9125 )
  • Bump nuxt-website-theme to 0.1.6 (71fed589c )
  • Update vercel icon to support dark mode (a4768fd56 )
  • Update website-theme version (16117060e )
  • Fix typo in commands/add (#9206 )
  • Remove stable release warning regarding options api (#9186 )
  • Fix typos in modules section (#9227 )
  • Updated info about 404.vue (#9155 )
  • External configuration table (#9189 )
  • homepage: Optimize gem textures (#9234 )
  • Add space between sentences (#9207 )
  • Improve seo titleTemplate and add social images (#9235 )
  • Update link to mdc extension (#9251 )
  • Add missing space (#9276 )
  • partners: Add brain agency partner (#9277 )
  • Bump website theme to 0.1.11 (#9299 )
  • Add warning about .client onMounted hook (#9263 )
  • Use layout in example of definePageMeta (#9322 )
  • schema: Add example and description for imports.dirs (#9346 )
  • Change app-config url to avoid naming conflicts with app.vue (#9377 )
  • Add redirect for app.config to app-config (66efcd59d )
  • installation: Add button to nuxt.new (7c998982f )
  • installation: Typo in sentence (53d5a5a5a )
  • roadmap: Add i18n module to the roadmap (#9403 )
  • Add more social cards (a50855bab )
  • Bump version to 0.1.12 (#9423 )
  • seo: Add sitemap url to robots.txt (#9309 )
  • introduction: Add hero and cards (#9334 )
  • Disable markdownlint on mdc file (#9428 )
  • homepage: Fix typo (#9426 )
  • Add Project name placeholder (#9421 )
  • Update announcements to add stable release (a73a75c39 )
  • Theme version 0.1.13 (#9453 )
  • Website theme 0.1.16 (#9456 )
  • Update playwright url (#9483 )
  • Make vite monospace too (#9490 )
  • Update agencies expertises (d36d11552 )
  • Add nuxt layers introduction and authoring guide (#9405 )
  • Heading and formatting improvements for layers (c307ee8b5 )
  • Update website-theme (cf4e7bf33 )
  • Update internal links to bridge overview page (228bc9ce2 )
  • Recommend to install non-edge version of @nuxt/test-utils (#9543 )
  • Compress social image to jpg and upgrade website-theme (770cdf90d )
  • agencies: Add liip (#9552 )
  • Fix typo and update theme (d500ac4e3 )
  • Update theme version (5fdb7b6f8 )
  • rendering: Hide light image in dark mode (#9620 )
  • Update examples link (#9152 )
  • Add docs for preloadRouteComponents (#9607 )
  • Add missing line breaks (#9671 )
  • Indicate navigateTo options are optional (#9672 )
  • Add community page (#9519 )
  • Bump website theme to 0.1.23 (#9703 )
  • community: Fix client-side images display (#9704 )
  • theme: Version 0.1.24 (#9716 )
  • version: Theme 0.1.25 (#9729 )
  • community: Temporary disable newsletter subscription (#9740 )
  • concepts: Add utils/ to directory-based auto-imports (#9739 )
  • Link to nuxt.com instead of v3.nuxtjs.org (#9786 )
  • Version 0.1.27 (#9788 )
  • community: Fix missing image (ce9141285 )
  • Improve wording and fix typo (#9795 )
  • getting-started: Improve usage of pnpm (#9775 )
  • index: Fix typo in 'GitHub' (#9807 )
  • Enable hybrid rendering (#9823 )
  • Rename svg asset (dbc31869b )
  • Add docs landing page (#9706 )
  • homepage: Add module cta (#9591 )
  • Fix layouts typo in nuxtignore page (#9893 )
  • Fix url for prettier.io pointing to stylelint.io (#9892 )
  • Fixed typos and improved wording (#9848 )
  • Fix typos and capitalisation (#9844 )
  • Clarify plugins are auto-registered, remove components default (#9815 )
  • Fix markdown (#9838 )
  • Fix typos (#9919 )
  • release: Theme 0.2.2 (#9920 )
  • example: Fix runtimeConfig extension in config-extends example (#9912 )
  • sponsors: Fix hero (#9941 )
  • configuration: Clarify the location of app.config.ts in the source directory (#9937 )
  • support: Update wording (#9821 )
  • Refactor cards (#9935 )
  • guide: Fix the link to deploy in guide/.output (#9994 )
  • Update generate doc to include --dotenv (#9991 )
  • Remove nuxt 2 information from generate schema (#10002 )
  • partners: Fix spacing (#10025 )
  • Fix typo (#10019 )
  • partners: Add macopedia as partner (#10028 )
  • Update testimonials (685cb100f )
  • Add back the newsletter (#10032 )
  • version: 0.3.5 (#10078 )
  • version: 0.3.6 (#10093 )
  • Update link (#10056 )
  • version: Use nuxt edge channel (#10117 )
  • version: Revert back to stable nuxt version (d6c7676f1 )
  • Update hooks source line number (#10102 )
  • version: 0.3.8 (#10127 )
  • Update nested router example (#10115 )
  • Add Nuxt: A vision for 2023 post (#10141 )
  • Add link! (02df51dd5 )
  • Remove stray parenthesis (#10144 )
  • Add port example in ecosystem.config (#10076 )
  • Add description of returning different status codes (#10059 )
  • Add info about extensions and pathPrefix keys (28a2a91b6 )
  • version: 0.3.10 (#10170 )
  • Fix hydration warnings on 2023 vision article (#10171 )
  • Add redirect for workshop (371bc1aff )
  • Remove line break (940720a58 )
  • Add buttons slot on PageHero component (#10139 )
  • Rename layer0 to Edgio (#9900 )
  • Update links to nuxt.com (#18425 )
  • examples: Fix error handling example (#18434 )
  • Add nuxt 2 section (ce8ad33ed )
  • partners: Update webreinvent description (#18473 )
  • Add link to config api (#18474 )
  • Update partners (#18482 )

🏡 Chore

✅ Tests

🎨 Styles

❤️ Contributors

Version v3.0.0

Released on January 20, 2023

✨ Official Release Announcenment

💬 Release Discussion

📝 Changelog

Check out release candidate notes for older releases and migration steps if you using an older version of Nuxt 3.

🩹 Fixes

  • nuxt: Removed auto imports (#9045 )
  • schema: Initialise runtimeConfig.public with empty object (#9050 )
  • cli: Upgrade with latest tag (#9060 )
  • nuxt: Allow union type arguments for useAsyncData (#9061 )

📖 Documentation

  • New website design (#9007 )
  • Update website theme version (819deb89 )
  • Minor style improvements (9ab069b2 )
  • Update website-theme (780b17b1 )
  • Add warning about definePageMeta issues with transitions and NuxtLoadingIndicator (#9055 )
  • Add missing agencies (#9059 )

🏡 Chore

  • Update readme design (#9048 )
  • Ignore parse5 for renovate update (#9046 )

❤️ Contributors

Version v3.0.0-rc.14

Released on January 19, 2023

Originally published at https://github.com/nuxt/framework/releases/tag/v3.0.0-rc.14

Note This is the last release candidate for Nuxt v3! Are you ready? 👀

👉 Release Discussion

Changelog

compare changes

⚠️ Breaking Changes

  • cli: Setup nuxt globally with nuxt test (#4578 )
  • nuxt: Only add $f fetch prefix to auto-keys (#8852 )
  • test-utils: Use vitest/node subpath export (#8815 )
  • nuxt: Remove initialCache option (#8885 )
  • nuxt: Enable payload extraction only for nuxi generate (#9018 )
  • nuxt: Include request url and params in useFetch key (#6632 )
  • nuxt: Fix typo for NuxtRenderHTMLContext.bodyPrepend (#8712 ) (#8704 )
  • nuxt: Remove support for 404.vue shorthand (#8809 )
  • kit: Remove support for module container (#9010 )
  • nuxt: Move head option support into defineNuxtComponent (#8901 )
  • Remove deprecated api (#9029 ) - Remove PrivateRuntimeConfig interface support - Remove autoImports option - Remove autoImports:extend hook support - Remove deprecated addAutoImport and addAutoImport utilities (use addImports and addImportsDir) - Remove defer option for useAsyncData - Remove support for installModule(nuxt, nuxtModule) - Remove support for module defenition as function - Remove support for name in module definition (use meta.name) - Remove deprecated throwError (use showError) - Remove deprecated useActiveRoute (use useRoute) - Remove deprecated NuxtConfig and defineNuxtConfig imports from nuxt (import from nuxt/config) - Remove deprecated <Script> component (use useHead) - Remove deprecated RouterConfigOptions interface (use RouterConfigSerializable) - Remove deprecated fileName for template options (use filename) - Remove deprecated <NuxtNestedPage> and <NuxtChild> components - Remove deprecated buildModules config - Remove deprecated privateRuntimeConfig and publicRuntimeConfig options - Remove deprecated imports.presets[].name (use presets.imports instead)

🚀 Enhancements

  • nuxt: Add isExternal to <NuxtLink> slot props (#8800 )
  • nuxt: Auto-import utils/ directory (#8817 )
  • cli: Wrap and normalize all console outputs (#8846 )
  • nuxt: Allow customizing root id and tag (#8883 )
  • nuxt: Add onBeforeRouteLeave and onBeforeRouteUpdate composables (#8889 )
  • cli: ⚠️ Setup nuxt globally with nuxt test (#4578 )
  • cli: Auto-generate .npmrc and setting for pnpm (#7407 )
  • nuxt, schema: Migrate to @vueuse/head v1 (#8975 )

🩹 Fixes

  • nuxt: Check if global transitions are activated for scroll behavior (#8700 )
  • nuxt: Allow cookies to be set to null to unset them (#8769 )
  • nuxt: Add catchall paths to prerender list (#8782 )
  • schema: Add declarations to ignore list (#8787 )
  • ssr: Ensure useRequestHeaders are case-insensitive (#8805 )
  • nuxt: Do not render page if we are throwing error (#8821 )
  • nuxt: Swallow issues with query selectors (#8843 )
  • nuxt: ⚠️ Only add $f fetch prefix to auto-keys (#8852 )
  • test-utils: Detect project root using nuxt.config with .mjs and .cjs extensions (#8855 )
  • cli: Exclude dist from type checking (#8848 )
  • test-utils: ⚠️ Use vitest/node subpath export (#8815 )
  • nuxt: Detect non-functional imports within page meta (#8881 )
  • nuxt: Preserve render errors (#8884 )
  • nuxt: ⚠️ Remove initialCache option (#8885 )
  • nuxt: Use app.baseURL when fetching error page on server (#8888 )
  • nuxt: Avoid passing attrs to default slot for <ClientOnly> component (#8921 )
  • vite: Add extend layers to fs.allow (#9006 )
  • nuxt: Include layers in esbuild transform (#9014 )
  • kit: Add external module to transpile (#8963 )
  • nuxt: ⚠️ Enable payload extraction only for nuxi generate (#9018 )
  • nuxt: ⚠️ Include request url and params in useFetch key (#6632 )
  • nuxt: Improve hmr for pages macros (#8940 )

💅 Refactors

  • nuxt: ⚠️ Fix typo for NuxtRenderHTMLContext.bodyPrepend (#8712 )
  • nuxt: ⚠️ Fix typo for NuxtRenderHTMLContext.bodyPrepend (#8704 )
  • nuxt: ⚠️ Remove support for 404.vue shorthand (#8809 )
  • nuxt: Explicitly import app in nuxt-root (#8729 )
  • kit: ⚠️ Remove support for module container (#9010 )
  • Update unjs dependencies to stable v1 (#9011 )
  • nuxt: ⚠️ Move head option support into defineNuxtComponent (#8901 )
  • ⚠️ Remove deprecated api (#9029 )

📖 Documentation

  • Update 2.nuxt-page.md (#8761 )
  • Update roadmap for november (#8766 )
  • Use update import for defineLazyEventHandler (#8767 )
  • Remove stability-edge (507f444c )
  • deployment: Remove usage of custom icons (8e4068b7 )
  • Improve examples content (1582f8ec )
  • api: Add useRequestHeaders composable example (#8833 )
  • Add entry for extendPages (#8860 )
  • api: Add refreshNuxtData util examples (#8845 )
  • Get event before running async function (#8861 )
  • api: Add useHydration composable (#8768 )
  • Add query option with example for useFetch (#8719 )
  • Add initial documentation for router composables (#8895 )
  • Add tls option to redis example (#8900 )
  • Fix syntax errors in server storage example (#8906 )
  • Fix typo (#8970 )
  • api: Add spaces to avoid breaking mobile layout (#8967 )
  • Typo in available (#8966 )
  • Add a bit more detail in the definePageMeta warning to specify it needs to be in a page (#8923 )
  • Match the open graph protocol markup (#8959 )
  • Fix typos (#8976 )

❤️ Contributors

Version v3.0.0-rc.13

Released on January 19, 2023

Originally published at https://github.com/nuxt/framework/releases/tag/v3.0.0-rc.11

👉 Release discussion

⭐ What is New?

🔰 Security Fixes

This release contains multiple security related fixes #8675 , #8674 and #8673 reported via huntr.dev platform by OhB00 .

We recommend you upgrade to the latest version as soon as possible.

If you encounter "The request URL ... is outside of Vite service allow list" issue, try adding path to vite.server.fs.allow in nuxt.config. read more .

🚀 Performance Improvements

Using a new method to extract definePageMeta improves vite performance and makes lazy compilation of pages possible (#8536 ).

💯 Strict Config Schema and Types

We have cleaned up the configuration schema (#8487 ) so that you no longer would be confused with Nuxt 2 options and also can quickly notice any typos in nuxt.config file.

Typescript strict mode is also enabled by default with this release as best practice. (#8667 )

🚇 Nitro Development Server Proxy

Using nitro.devProxy option you can now configure proxies for the development server. (learn more )

Changelog

compare changes

⚠️ Breaking Changes

  • nuxt: ⚠️ Use parser to generate page metadata (#8536 )
  • schema: ⚠️ Use strict typescript mode by default (#8667 )
  • test-utils: ⚠️ Update vitest args (#8325 )
  • schema: ⚠️ Disable app.pageTransition and app.layoutTransition by default (#8436 )
  • nuxt: ⚠️ Cleanup schema and split nuxt 2 types (#8487 )

🚀 Enhancements

  • nuxt: Default router scroll behavior (#3851 )
  • nuxt: Make useFetch options reactive (#8374 )
  • kit: Add updateTemplates utility (#8413 )
  • nuxt: Add dev warnings when setPageLayout is used incorrectly (#8464 )
  • Add <devOnly> component (#7950 )
  • nuxt: Allow setting name and path for a route in definePageMeta (#8633 )
  • kit: Add addServerPlugin utility (#8635 )
  • kit, nuxt: Support prerender:routes and addPrerenderRoutes (#8670 )

🩹 Fixes

  • nuxt: Don't use or assignment (#8299 )
  • nuxt: Pass original request headers to the error page (#7340 )
  • nuxt: Scroll to top on dynamic routes with different params (#8327 )
  • nuxt: Router defaults overwrite custom options always (#8334 )
  • cli: Update analzye main handler (#8339 )
  • nuxt: RouterBehavior comparison for hash block (#8383 )
  • nuxt: Don't load payloads for external urls (#8370 )
  • vite: Invalidate virtual modules with vite-node (#8389 )
  • nuxt: Avoid directly importing vue-router inside <NuxtLayout> (#8421 )
  • webpack: Print build errors (#8388 )
  • kit: Use pathe to resolve aliases (#8453 )
  • test-utils: Override NITRO_PORT as well (#8458 )
  • nuxt: Call data refresh hook in parallel (#8470 )
  • nuxt: Allow responding with custom headers from error.vue (#8469 )
  • schema: Disable early hints by default (#8486 )
  • kit: Don't require nuxt context when resolving path (#8504 )
  • nuxt, nuxi: Improve pages creation and removal DX (#8502 )
  • nuxt: Add vue-router to optimized deps (#8544 )
  • vite: Handle all vite middleware routes (#8601 )
  • nuxt: Pass async-data errors through to client (#8521 )
  • nuxt: Check before appending comma in composable keys (#8529 )
  • nuxt: ⚠️ Use parser to generate page metadata (#8536 )
  • kit: Normalize handler paths (#8626 )
  • nuxt: Don't force prerender / if user doesn't have that route (#8639 )
  • nuxt: Do not inline global styles in html response (#8666 )
  • schema: ⚠️ Use strict typescript mode by default (#8667 )
  • nuxt: Disallow directly rendering error page (#8673 )
  • Resolve ids to support pnpm (#8671 )
  • vite: Enable fs strict mode (#8674 )
  • nuxt: Ensure payload url has no protocol (#8675 )

💅 Refactors

  • test-utils: ⚠️ Update vitest args (#8325 )
  • schema: ⚠️ Disable app.pageTransition and app.layoutTransition by default (#8436 )
  • nuxt: ⚠️ Cleanup schema and split Nuxt 2 types (#8487 )

📖 Documentation

  • Add route rules to concepts > rendering (#8292 )
  • Fix broken link (#8319 )
  • Fix link to documentation guide (#8322 )
  • Update website-theme to 0.1.7 (dbc2c8ce )
  • Add missing opening <NuxtLayout> tag in a code sample (#8349 )
  • Update links for external tools (#8382 )
  • Update for clarity and fix typos (#8375 )
  • Add missing app key for transitions (#8385 )
  • api: Add <ClientOnly> to API docs (#8400 )
  • Fix typo (#8427 )
  • Disable transitions by default as hotfix (#8434 )
  • Add note about runtime config serialization (#8432 )
  • Change required node version to be above 16.11 (#8408 )
  • Use LinkExample as block component (#8459 )
  • Add note about early hints and nginx (#8485 )
  • Updated bridge migration guide (#8471 )
  • Mention use case for <KeepAlive> in definePageMeta (#8491 )
  • Update stability edge banners (#8498 )
  • Generate docs for unversioned schema (#8535 )
  • Fix transition wording to include layouts (#8600 )
  • Add information about type checking to typescript.typeCheck config. (#8632 )

📦 Build

  • pkg: Support Node.js 19 (#8324 )

🏡 Chore

  • renovate: Ignore monorepo dependency upgrades (f934343b )
  • Upgrade vitest to 0.24 (#6764 )
  • nuxt: Add type for headers (#8326 )
  • examples: Add missing dependency and script for testing example (#8457 )
  • Reenable auto-upgrades for vueuse/head (#8506 )
  • Update nitropack to 0.6.1 (5a43e68e )

✅ Tests

  • Add bundle size test (#8133 )
  • Update type test for strict mode (#8669 )

❤️ Contributors

  • Adewale Adeyemi
  • Anthony Fu
  • Christian Burkhart
  • Clément Ollivier
  • Damian Głowala
  • Daniel Roe
  • David Stack
  • Dawid Stefanko
  • Dmitriy
  • Farnabaz
  • Joel
  • Joel Wenzel
  • Johann Schopplich
  • Johnson Chu
  • Josh Deltener
  • Julien Huang
  • Nils
  • Ondřej Misák
  • Pascal Sthamer
  • Pooya Parsa
  • Rajendra
  • Sacha STAFYNIAK
  • Sébastien Chopin
  • Zecka

Version v3.0.0-rc.12

Released on January 19, 2023

Originally published at https://github.com/nuxt/framework/releases/tag/v3.0.0-rc.12

💬 Release Discussion

🚀 How to Upgrade

Note Make sure to recreate the lock file in the project in case of any issues after the upgrade.

⭐ What is New?

📍 Route Rules

RC.12 comes with the first public beta for route rules and hybrid rendering support. Using route rules you can define rules for a group of nuxt routes, change rendering mode or assign a cache strategy based on route! Nuxt server will automatically register corresponding middleware and wrap routes with cache handlers using Nitro caching layer. Whenever possible, route rules will be automatically applied to the deployment platform's native rules (currently Netlify and Vercel are supported).

👉 See docs for examples and more info .

⚗️ Nitropack 0.6

Nitropack upgraded to 0.6 (Release Notes ) and h3 upgraded to 0.8 (Release Notes )

⚠️ Breaking changes: Using defineEventHandler() or eventHandler() is now required. If you were previously using a Node.js middleware with (req, res, next?) syntax you need to wrap them with fromNodeMiddleware() to convert it into an h3 handler.

👦 useHead updates

This release brings a brand-new version of @vueuse/head with some significant performance improvements and bug fixes. Check out nuxt/framework#8000 for more details, but in particular:

  • Fully-typed usage of useHead
  • No more flickering when transitioning between routes
  • Support ordering of head metadata
  • Faster head hydration and deduping

⚠️ Breaking changes: The shortcuts viewport and charset can only be used within nuxt.config and not within useHead directly. For more information on how to update, see nuxt/framework#8000 .

⚡ Page Meta

New router options validate and redirect are now supported directly in definePageMeta - so you can perform additional validation for dynamic routes, or implement route redirects directly within pages.

definePageMeta({
  // redirect: '/admin',
  validate: async (route) => {
    const nuxtApp = useNuxtApp()
    // Check if the id is made up of digits
    return /^\d+$/.test(params.id)
  }
})

🌅 Early Hints

Nuxt's node server renderer will now respond with 103 Early Hints before the server renders the app, meaning that you should see a decreased TTFB and earlier resource loading in a supported environment - which at the moment is Chrome with your Nuxt app served over HTTPS with newer than HTTP/1.1.

📖 Nuxt 3 Docs

Nuxt's documentation is now written with Nuxt 3's new theming system and the latest Docus and Content module versions. Check it out at https://v3.nuxtjs.org ! Expect more coming soon!

nuxt 3 docs

Changelog

compare changes

🚀 Enhancements

  • nuxt: Support redirect within page metadata (#7746 )
  • cli: Support --dotenv for dev, build and preview commands (#7660 )
  • nuxt: Allow configuring plugins directory (#7981 )
  • nuxt: Add default slot to <NuxtLoadingIndicator> (#7128 )
  • pages: Add validate hook for definePageMeta (#7870 )
  • nuxt: Refresh override for data fetching composables (#7864 )
  • schema, nuxt: Allow user-configurable serverDir (#7868 )
  • nuxt: Parse html to treeshake client-only components (#7527 )
  • nuxt: Wrap #components client exports with createClientOnly (#7412 )
  • nuxt: Add ssr: false route rule to enable SPA mode (#7938 )
  • nuxt: Migrate to latest @vueuse/head (#8000 )
  • nuxt: ⚠️ Add <NuxtPage> to #components (#8145 )
  • nuxt: Add hook debug mode (#7690 )
  • cli: Add nuxi build-module command (#7610 )
  • schema: Add experimental routesRules shortcut (#7954 )
  • kit: Support plugin array for addVitePlugin and addWebpackPlugin (#8270 )

🔥 Performance

  • nitro: Respond with early hints in node-based environments (#7893 )
  • nuxt: ⚠️ Use component loader to add meta components (#8167 )
  • nuxt: Remove vue-router dependency from minimal app (#8188 )
  • nuxt: Improve link prefetching (#8225 )

🩹 Fixes

  • nuxt: Export and auto-import clearNuxtData (#7710 )
  • test-utils: Support vitest v0.20.x (#7712 )
  • cli: Include workspaceDir in tsconfig include (#7726 )
  • cli: Stub defineNuxtConfig for nuxi info (#7728 )
  • nuxt: Do not warn for non-existent default layout (#7748 )
  • nuxt: Respect immediate option in useFetch (#7720 )
  • nuxt: Respect baseURL when rendering payload path (#7809 )
  • nuxt: Don't disable scripts in dev mode with experimental noScripts (#7745 )
  • Downgrade Node.js ^16.11.0 requirement to ^16.10.0 (#7865 )
  • nuxt: Handle schema types for relative module paths (#7946 )
  • vite: Add type-checker to client build for ssr: false (#7930 )
  • nuxt: Allow auto-import component with same filename (#7713 )
  • test-utils: Respect setupTimeout (#7866 )
  • nuxt: Fix lazy import of .client components (#7422 )
  • nuxt: Remove fragment from createClientOnly (#7774 )
  • head: Allow using the default slot for script content like noscript (#7858 )
  • nuxt: Don't prerender index.html with a server (#7831 )
  • docs: Link to api config reference (#8038 )
  • docs: Link to installation section (#8040 )
  • nuxt: Page hydration and double load (#7940 )
  • schema: Declare untyped dependency (#8064 )
  • nuxt: Use correct cache and add baseURL to payload (#7984 )
  • cli: Replace lazyHandle with defineLazyHandler (#8049 )
  • schema: Evaluate environment variables when resolving values (#8079 )
  • vite: Prevent overlap between vite assets and app routes (#7989 )
  • nuxt: Don't inline styles for per-request ssr: false (#8106 )
  • nuxt: ⚠️ refresh to override previous requests by default (#8190 )
  • nuxt: Enable router when app/router.options.ts file is present (#8193 )
  • kit: Log module id to the console when import fails (#8198 )
  • nuxt: Avoid head dom update on same route click (#8206 )
  • webpack: Add global to new line (#8226 )
  • schema: RouteRules config (#8252 )
  • cli: Don't includeworkspaceDir in tsconfig by default (#8256 )
  • nuxt: Avoid preloading external routes (#8255 )
  • nuxt: Allow disabling early hints (#8264 )
  • nuxt: Lazy-load entry CSS (#8278 )
  • nuxt: Ignore cache rules for middleware and errors (#8291 )

💅 Refactors

  • nuxt: Use unref in layout.ts (#7818 )
  • nuxt: Use unref in fetch.ts (#7813 )
  • nuxt: Deprecate <Script> component tag in template (#8197 )
  • nuxt: Use writeEarlyHints from h3 (#8245 )
  • nuxt: Use getRouteRules from nitropack (#8251 )

📖 Documentation

  • getting-started: Fix typo in views (#7687 )
  • getting-started: Configuration page (#7689 )
  • Recommend to not overwrite some keys in tsconfig (#7717 )
  • directory-structure: Fix typo in server (#7752 )
  • navigate-to: Use await instead of return (#7734 )
  • error-handling: Fix useError() type definition (#7749 )
  • migration: Restructure upgrade guide (#7730 )
  • Document nitro hooks (#7782 )
  • roadmap: Update the release times for v2 and v3 (#7808 )
  • guide: Add nitro plugins to server directory (#7780 )
  • roadmap: Remove not working link from nuxt/auth (#7781 )
  • Updated nuxt bridge migration guide (#7775 )
  • Merge deployment pages in getting started (#7765 )
  • Add newline at end of sass import (#7810 )
  • examples: Optimize writing of : ? (#7928 )
  • Update definePageMeta docs (#7888 )
  • Use nuxt 3 and website theme (#5479 )
  • getting-started: Add transitions page (#7987 )
  • Fix path of nuxt config (#8021 )
  • introduction: Add nuxt key features to the introduction (#8013 )
  • transitions: Add poster for videos (99907dbf )
  • Fix netlify redirects (#8028 )
  • Use webp for 3D gem asset (93c3f30b )
  • Upgrade docus (aef32577 )
  • Upgrade docus to fix docsearch input focus (fc2d74a2 )
  • Update to [email protected] (3218356d )
  • Fix indentation in "Views" code blocks (#8039 )
  • Fix more redirect issues (#8045 )
  • example: Replace useQuery to getQuery (#8047 )
  • Fix code highlighting (#8057 )
  • Add recommendation for controlling plugin registration order. (#8096 )
  • Add back deleted sections in definePageMeta (c804daa0 )
  • Update line number for NuxtHooks source (#8128 )
  • Fix typo (#8129 )
  • Update badges color (bc3016f8 )
  • Add app.config route to pre-render (#8131 )
  • Clarify access of RuntimeConfig with Options API (#8147 )
  • Close alert (#8157 )
  • Fix 404 page (#8136 )
  • Use RouterConfig interface in examples (#8151 )
  • Add support for WEBSITE_THEMe env variable (6ad0f3f1 )
  • Update route middleware link (#8196 )
  • Adds missing quote in example code (#8209 )
  • Fix validate example (#8231 )
  • Change deprecated useBody with readBody (#8266 )
  • Add spacing between multiple button-link (#8275 )
  • Add cleavr to supported hosting providers (#8285 )

🌊 Types

  • Include nuxt-link target types (#8172 )

🏡 Chore

  • Use pnpm for framework monorepo (#7895 )
  • Add start command for stackblitz codeflow (#8279 )

⚠️ Breaking Changes

  • nuxt: ⚠️ Add <NuxtPage> to #components (#8145 )
  • nuxt: ⚠️ Use component loader to add meta components (#8167 )
  • nuxt: ⚠️ refresh to override previous requests by default (#8190 )

❤️ Contributors

  • Alex
  • Alex C
  • Alexander Lichter
  • Andrew Mudrov
  • Anish Ghimire
  • Anthony Fu
  • AuroraTea
  • Barbapapazes
  • Benicio Cardozo
  • Chenying
  • Christian Preston
  • Cinob
  • Clément Ollivier
  • Cupid Valentine
  • Damian Głowala
  • Daniel Kelly
  • Daniel Roe
  • Daniil Chudo
  • Fumihiro-Yano
  • Harlan Wilton
  • Israel Ortuño
  • James Ray
  • Josh Deltener
  • Julien Huang
  • Krutie Patel
  • Lovue
  • Martin Benndorf
  • Miketromba
  • MiniDigger
  • Mmis1000
  • Niklas
  • Pooya Parsa
  • Rajendra
  • Randy
  • Reinier Kaper
  • Sébastien Chopin
  • Tech Genius
  • Tobias Diez
  • Toni
  • Tuğberk Kılıç
  • Won-hyeok Jung
  • Xezard
  • Yaël Guilloux
  • Yu Yamazaki
  • 菜狗

Version v3.0.0-rc.11

Released on January 19, 2023

Originally published at https://github.com/nuxt/framework/releases/tag/v3.0.0-rc.11

💬 Join the release discussion

🚀 How to Upgrade

Note Make sure to recreate the lock file in the project in case of any issues after the upgrade.

⭐ What is New?

Full Static Enhancements

We have introduced Full-Static mode payload extraction in RC.10. Many of the issues from the initial implementation are resolved with this release thanks to your amazing feedback! Notably for SPA routes and state that is now in the initial state.

🧪 We understand that there might be still issues with the new implementation. Please report if spotted any. You can use new experimental.payloadExtraction: false flag in nuxt.config to opt-out as well.

IPv6 and HTTPS support for nuxi dev and vite

Nuxi CLI and unjs/listhen are improved and now support --https flag and ipv6 hosts out of the box with an auto-generated certificate. You can use --ssl-cert and --ssl-key to provide own generated SSL certificates with mkcert for example as well.

Issues with vite HMR and vite-node should be resolved as well. If you were previously using NODE_TLS_REJECT_UNAUTHORIZED or custom vite.server.hmr options for a workaround, you can try to remove them.

Note: If you see something like http://[::]:3000/ when running nuxi preview, it is all normal! The New IPv6 URL works in all modern browsers and is also backward compatible with IPv4 interfaces. If for some reason encountered any issues, try setting HOST to 0.0.0.0 to disable IPv6 listener.

Nitro Improvements

Nitro is the server engine for Nuxt 3. We had landed several fixes in 0.5.2 and 0.5.3 versions improving stability and bug fixes.

Full Changelog

compare changes

🚀 Enhancements

  • kit: useNitro() utility (#7557 )
  • Allow disabling payload extraction (#7588 )

🩹 Fixes

  • nuxt: Disable payload extraction for spa generated pages (#7535 )
  • nuxt: Do not pass prefetched class to custom link (#7522 )
  • cli: Improved self-signed certificate for nuxi dev --https (#7545 )
  • vite: nuxi dev --https working out of the box (#7547 )
  • schema: Update resolver for cssSourceMap with new sourcemap format bridge (#7541 )
  • nuxt: Pass fully resolved path to nitro dist files (#7494 )
  • nuxt: Remove modulepreload for spa fallback routes with ssr:true (#7553 )
  • schema: Only disallow vite server port and host (#7554 )
  • nuxi, vite: Ipv6 support for nuxi dev (#7560 )
  • cli: Print resolved public directory after generate (#7577 )
  • nuxt: Load payload after middleware and once final route is resolved (#7574 )
  • nuxt: Keep state in the initial state instead of extracting it (#7567 )
  • vite: Normalize vite-node error data from server (#7589 )
  • vite: Include id and stack in vite-node fallback error handler (#7575 )
  • vite: Respect ctx.nuxt.options.modulesDir for resolving externals with vite-node (#7612 )
  • nuxt: Add missing process.client for early redirect in navigateTo(#7625 )
  • vite-node: Include importer in error stack (#7607 )
  • vite, webpack: Avoid generating keys where a key is already provided (#7622 )
  • vite, webpack: Handle auto keys for composables without args (#7651 )
  • nuxt: Don't tree shake client-only fallback templates (#7659 )
  • nuxt: Strip non-.vue extensions from component types (#7673 )
  • nuxt: Only observe tag elements for <NuxtLink> prefetching (#7679 )
  • nuxi, vite: Support HTTPS with custom domain and HMR (#7680 )

📖 Documentation

  • Update auto-imports link (#7530 )
  • Add note about link prefetching (#7540 )
  • Improve NuxtLink prefetch explanation (#7540 )
  • Add testing and addComponent to modules and update addImports (#7543 )
  • Fix typo on directory-structure/pages (#7601 )
  • Fix typo in custom router example (8621c860 )
  • Fix typo in nitro options in wasm example (#7639 )
  • Add addImportsSources to list of kit utils (#7636 )
  • api: Add defineNuxtComponent page (#7618 )
  • testing: Move modules testing section to module authors guide (#7643 )
  • getting-started: Add views page (#7556 )

❤️ Contributors

  • Alexander Lichter
  • Alper Doğan
  • Chenying
  • Clément Ollivier
  • Damian Głowala
  • Daniel Roe
  • Julien Huang
  • Krutie Patel
  • Lexpeartha
  • Pooya Parsa
  • YIngChenIt

Version v3.0.0-rc.10

Released on January 19, 2023

Originally published at https://github.com/nuxt/framework/releases/tag/v3.0.0-rc.10

💬 Join the release discussion

🚀 How to Upgrade

Note Make sure to recreate the lock file in the project in case of any issues after the upgrade.

⭐ What is new?

Critical Styles are Inlined

#6755 , #7160

Global styles and used component styles are now automatically inlined when server-side rendering a page. This feature helps to improve the First Contentful Paint (FCP) metric.

🧪 You can disable the feature from nuxt.config using experimental: { inlineSSRStyles: false } in case of any issues.

Full Static Generation with Payload Rendering

#6411 , #6455

In Nuxt 2, we introduced an amazing feature called Full Static Generation . When using nuxt generate, the payload of each page containing asyncData and state is extracted to a .js chunk and we can deploy output to any static hosting without requiring a hosted API server. This feature also introduced performance benefits to reduce page size and allow smartly prefetching payload of next pages ahead of time when using nuxt generate but kept limited to it.

This feature is now back in Nuxt 3 but much better! Payload is not only extracted during prerendering phase (nuxt generate) but also can be rendered on demand by simply appending /_payload.js to the end of any URL. This made implementation much simpler and also unlocks future development to enable payload rendering for hybrid static server and incremental generated pages. Followup #6411 for the roadmap.

#4329

Another goodie ported from Nuxt 2, is automatically prefetching the next pages when a <NuxtLink> is in the viewport.

This feature is integrated with vue-router to prefetch components of the next route and also payload extraction to prefetch the payload of the next pages ahead of time! You can also hook into link:prefetch to do more prefetches.

Better Workspace Support

unjs/pkg-types#34 , #7439

Nuxt has several configurations for directories including rootDir where nuxt.config, package.json, etc is, and srcDir which is the same as rootDir by default but can be customized to move project code such as pages/ to the src/ directory. With Monorepo becoming more popular, it became clear we need another new option to act smarter in a monorepo.

We have introduced a new workspaceDir configuration. It is automatically detected from rootDir using different heuristics (how? ). This option is used to extend the search path for node_modules via #7439 but we will keep spreading its use in other places.

🧪 You can manually set workspaceDir from nuxt.config in case of any issues.

defineNuxtConfig is Auto Imported

#7267 , #7485 , #7497

Nuxt uses unjs/jiti in order to support typescript and ESM syntax for nuxt.config. When importing { defineNuxtConfig } from 'nuxt' in Nuxt 3, it causes the whole nuxt package to be loaded. It was making startup time slower.

We have introduced a new nuxt/config subpath export that only exports defineNuxtConfig for type support but you don't even need this anymore! Just remove import and enjoy shorter syntax!

-- import { defineNuxtConfig } from 'nuxt'
export default defineNuxtConfig({
})

More Powerful nuxt init

We have switched to unjs/giget for a much more powerful template init engine.

Normally nuxi init command should work as it was before. If you were using nuxt init org/repo to clone the 3rd party GitHub repository, you should use nuxi init gh:org/repo now.

Experimental Zero-Client-JS Mode

#7156 , #7248

This new experimental flag allows turning off all Nuxt client js code when server-side rendering a page.

Using this feature is advisable for the very small minority of sites that would not benefit from client-side JS.

You can try this feature by setting experimental: { noScripts: true } and let us know what you think!

Changelog

(see all commits )

🚀 Enhancements

  • nuxt, vite: Inline global and component styles in server response (#7160 )
  • nuxt: Custom history and routes for app/router.options.ts (#7129 )
  • nuxt: Router with hash mode (#6980 )
  • nuxt: Allow extending routes with custom alias (#7074 )
  • test-utils: Add mockFn and mockLogger utils (#6235 )
  • nuxt: Support experimental flag to render no client-side js (#7248 )
  • kit: Add addImportsSources utility (#7270 )
  • nuxt: Add immediate option for useAsyncData and useFetch (#5500 )
  • nuxt: Add clearNuxtData (#5227 )
  • Allow client-side sourcemaps in production (#7313 )
  • nuxt: Filter support for clearNuxtData (#7323 )
  • cli: Switch to unjs/giget for nuxi init (#7361 )
  • cli: ⚠️ Use giget 0.1x with template registry for nuxi init (#7404 )
  • nuxt: Payload rendering support (#6455 )
  • nuxt: Allow exposing type augmentations from extends layers (#7442 )
  • nuxt: Add workspaceDir option and add it to modulesDir (#7439 )
  • nuxt: Support prefetching <nuxt-link> (#4329 )
  • nuxt: Allow passing transition & keepalive props to <NuxtPage> (#7492 )
  • nuxt, kit: Auto import defineNuxtConfig (#7497 )
  • nuxt: Generate spa fallback for nuxt generate (#7507 )

🔥 Performance

  • nuxt: Cache createClientOnly wrapper using weakmap (#7297 )
  • vite: Remove duplicate css links from rendered page when inlined (#7264 )
  • nuxt: Only inject preload helper when webpack is used (#7460 )
  • nuxt: Import defineNuxtConfig from nuxt/config (#7485 )
  • Enable treeshakeClientOnly flag by default (#7484 )

🩹 Fixes

  • nuxt: Update default redirect code of navigateTo to 302 Found (#7189 )
  • head: Case http-equiv correctly (#7190 )
  • kit, nuxi: Semver regexp to support nuxt-edge current releases (bridge) (#7193 )
  • vite: Use baseURL + assetsDir as base in dev mode (#7234 )
  • vite: Pass ssr condition to getModuleByUrl (#7260 )
  • nuxt: Import and wrap client-only components once (#7245 )
  • cli: Pass value of https through to vite-node (#7271 )
  • nuxt: Don't override payload error if it is present (#7290 )
  • nuxt: Don't try to set cookie after redirect (#7288 )
  • webpack: Promisify webpack dev/hot handlers using h3.promisifyHandler (#7275 )
  • schema: Disallow setting vite server properties (#7317 )
  • schema: Mark vite server as optional (#7327 )
  • nuxt: Allow abortMiddleware to receive a nuxt error or error options (#7335 )
  • webpack: Don't parse styles for composable keys (#7333 )
  • vite: Allow overriding vite sourcemap (#7342 )
  • schema: Resolve ssr (#7359 )
  • kit: Add default config layer without nuxt.config file (#7358 )
  • vite: Update render if it is invalidated (#7347 )
  • vite: Warmup improvements (#7377 )
  • cli: Don't include an array of paths within an array (#7378 )
  • vite: Write dev manifest before spa build (#7380 )
  • nuxt: De-default layout/component imports (#7389 )
  • nuxt: Always inline entry styles (#7386 )
  • nuxt: Do not apply import protection to top-level resolution (#7344 )
  • nuxt: Use more specific FetchError for useFetch errors (#7435 )
  • vite: Use same asset filenames between server and client (#7436 )
  • nuxt: Augment GlobalComponents from @vue/runtime-core (#7448 )
  • vite: Don't fail builds for virtual modules that don't support inlining (#7440 )
  • nuxt: Only delete assets when building (#7486 )
  • vite: Show formatted vite-node errors (#7509 )
  • vite: Disable server warmup with vite-node (#7512 )

💅 Refactors

  • vite: Reuse resolved server entry from context (#7268 )
  • schema: Upgrade to untyped 0.5 (#7452 )
  • nuxt: Use relative imports into composables (#7487 )

📖 Documentation

  • Add note about useFetch auto generated key (#7044 )
  • api: Enhance useHead composable (#7072 )
  • Add note about fetching data on initial load (#7120 )
  • Document external option of navigateTo (#7188 )
  • guide: Add .client and .server components (#7084 )
  • Fix markdown file name (#7231 )
  • api: Navigate to first item in list (#7232 )
  • Extend description of server handlers (#7187 )
  • api: Add example for fetch interceptors (#7180 )
  • deploy: Add node cluster mode (#7089 )
  • api: Fix useAsyncData signature (#7242 )
  • Add app-config example (#7247 )
  • Fix typo (#7262 )
  • Fix typo in url (#7272 )
  • Rename AppConfig to AppConfigInput (#7293 )
  • api: Fix typo in use-fetch (#7310 )
  • api: Add nuxi prepare command (#7349 )
  • head: Enhance usehead and fix broken links (#7364 )
  • Remove duplicate word (#7387 )
  • api: Add useRuntimeConfig page (#7406 )
  • Fix typo (#7437 )
  • Update structure (#7047 )
  • Update name of the generated imports.d.ts file (#7474 )
  • getting-started: Add routing page (#7495 )
  • Update codesandbox link (#7499 )
  • schema: Change srcDir example to src/ (#7503 )

🏡 Chore

  • Update CodeSandbox links (#7318 )

📦 Build

  • cli: Add node to export conditions (0cc49e2a )

✅ Tests

  • Use semantic runIf and skipIf helpers (#7312 )
  • nuxt: Add tests for import protection plugin (#7416 )

🤖 CI

  • Crawl docs site for new deployments to track broken links (#7473 )

❤️ Contributors

  • Adewale Abati
  • Alex Kozack
  • Alex Liu
  • Alexander Lichter
  • AndreyYolkin
  • Anthony Fu
  • Clément Ollivier
  • Corey Richardson
  • Damian Głowala
  • Daniel Roe
  • Harlan Wilton
  • HomWang
  • Julien Huang
  • Krutie Patel
  • Kévin Schnekenburger
  • Leon Si
  • Mahdi Boomeri
  • Mastercuber
  • Pooya Parsa
  • Ricardo Gobbo De Souza
  • Sébastien Chopin
  • Tobias Diez
  • Tobias SN
  • Vasily Stepanov
  • Victorkwok97
  • Vl4dimyr

Version v3.0.0-rc.9

Released on January 19, 2023

Originally published at https://github.com/nuxt/framework/releases/tag/v3.0.0-rc.9

💬 Join the release discussion

Highlights

  • ✅ app.config.ts with HMR and Reactivity support (see documentation and example )
  • ✅ Vite-Node enabled by default (#6217 )
  • ✅ Updated to [email protected]
  • ⚠️ autoImports option and hooks is deprecated and renamed to imports (#6864 ) (#7158 )
  • ⚠️ Vue dependency is now externalized (#6868 )
  • ⚠️ Handle prerelease constraint (#7116 )
    • 👉 If you see an error like Nuxt version ^3.0.0 is required but currently using 3.0.0-rc.9, please contact the module author.

Changelog

(all commits )

🚀 Enhancements

  • webpack, vite: Default to .js extension for client (#6505 )
  • schema, vite: ⚠️ Enable vite-node by default (#6217 )
  • vite: Allow disabling entry warmup (#6647 )
  • nuxt: Exclude page chunks from being prefetched (#6662 )
  • cli: Auto cleanup with project manifest changes (#6672 )
  • nuxt: app.config with HMR and reactivity support (#6333 )
  • nuxt: Allow getRouteFromPath to use objects (#5900 )
  • nuxt: Add warning in dev mode if layouts/pages do not have a single root node (#5469 )
  • nuxt: Config options for default keepalive, page & layout transitions (#5859 )
  • nuxt: Allow programmatically prefetching global components (#6661 )
  • cli: Support mode flags for add command (#3921 )
  • nuxt: imports.autoImport option to disable auto-imports (#6768 )
  • nuxt: navigateTo supports external redirects (#5022 )
  • nuxt: app.config improvements (#6905 )
  • nuxt: Add setPageLayout utility (#6826 , #7075 )
  • cli: Display nuxt and nitro versions for dev and build commands (#7118 )
  • kit, schema: Allow extending with theme config (#7131 )
  • nuxt: ⚠️ Rename autoImports to imports (#6864 )
  • kit, nuxt: Improve autoImports deprecation dx (#7158 )
  • nuxt: Pass and format vite-node build errors (#6683 )

🔥 Performance

  • nuxt: Tree-shake asyncData client logic from server (#7056 )
  • nuxt: Don't prefetch all global components (#7069 )

🩹 Fixes

  • nuxt: Remove stray commas in component templates (#6580 )
  • cli: Update server.port and server.host with listener info (#6595 )
  • nuxt: Add #components alias to tsconfig (#6634 )
  • vite: Pass relative url as default base (#6637 )
  • nuxt: Don't set asyncData to existing payload on CSR if initialCache is disabled (#6640 )
  • vite: Warmup server entries with ssr condition (#6649 )
  • nuxt: Include tag attrs for non self-closing tags in tree-shake regex (#6675 )
  • nuxt: Fallback to static error page on server error (#6697 )
  • cli: Ensure nuxi upgrade runs in rootDir (#6707 )
  • cli: Properly detect hash and tag for upgrade changelog (#6708 )
  • nuxt: Use vue-devtools-stub to mock @vue/devtools-api for both cjs + esm (#6713 )
  • nuxt: Pass params to client-only slot (#6584 )
  • vite: Improve vite-node module invalidation (#6736 )
  • vite: Dedupe vue in client bundle (#6735 )
  • nuxt: Ensure component helper methods do not create side-effects (#6789 )
  • nuxt: Use deep assignment for app.config hmr (#6788 )
  • nuxt: Throw hard error on initial spa load if aborted (#6857 )
  • nuxt: Pass analyze options through to nitro (#6871 )
  • cli: Build all types on typecheck command (#5437 )
  • nuxt: Lazy composables shouldn't block setup in ssr: false (#6901 )
  • vite: Remove client manifest.json from public dir (#7021 )
  • kit: Sort aliases before resolving (#7018 )
  • nuxt: Use shared state for asyncData (#7055 )
  • vite: Sanitize client asset chunk names (#7067 )
  • schema: Sync types of vite v3.x (#7104 )
  • kit: ⚠️ Handle prerelease constraint (#7116 )

💅 Refactors

  • nuxt: Enable strict type checking (#6368 )
  • vite: Enable strict type checking (#6616 )
  • nuxt, kit: Improve type strictness (#6685 )
  • Enable strict type checking everywhere (#6943 )
  • Apply lints from @nuxtjs/eslint-config-typescript v11 (#7114 )
  • nuxt: Remove unused meta:register hook (#7130 )

📖 Documentation

  • Ensure consistent casing of section headers (#6578 )
  • components: Use fallbackTag in ClientOnly examples (#6587 )
  • Global style imports example (#6490 )
  • composables: Add more examples for autoImports (#6615 )
  • server: Add nitro config and storage examples (#6507 )
  • data-fetching: Fix and simplify cookie proxy example (#5770 )
  • Tweaks for data fetching, server routes and composables (#6653 )
  • Update links to nitro.unjs.io (#6684 )
  • Make wording slightly clearer (#6740 )
  • Fix typo in defineEventHandler example (#6741 )
  • api: Add <NuxtWelcome /> component docs (#6745 )
  • Use updated h3 utils (#6818 )
  • api: Add missing kit utilities (#6841 )
  • plugins: Add note about composable usage (#6744 )
  • api: Add useNuxtApp composable (#6786 )
  • composables: Add nested and plugin injection examples (#6743 )
  • examples: Add jsx example (#6870 )
  • api: Add addRouteMiddleware util (#6894 )
  • Update stormkit link (3ee812939 )
  • Update link to pinia nuxt module (#6952 )
  • deploy: Update command for csr prerendering (#6966 )
  • api: Enhance abortNavigation util (#6936 )
  • api: Add defineNuxtRouteMiddleware util (#6933 )
  • api: Add definePageMeta util (#6931 )
  • Replace backtick with apostrophe (#7015 )
  • api: Fix the layout file extension in cli example (#7024 )
  • schema: Update prefix for runtime config env variables (#6999 )
  • Add information on how to use options api asyncData (#7019 )
  • Increment directory structure numbers (#7102 )
  • Add explanatory comment before universal router stubs (#7124 )

🏡 Chore

  • ci: Set timeout for each step (#6923 )
  • nuxt: Fix typo (#6971 )
  • Add dev:preview script for playground preview (#6961 )
  • repo: Remove backtick-type in bug issue-template (#7083 )
  • Bump rc version for edge versions (#7117 )
  • nuxt: Prevent error page rendering a null error (#7119 )
  • nuxt: Use latest nitropack-edge on release (#7036 )

❤️ Contributors

  • 4Kazelot
  • Alex Kozack
  • Alexander Lichter
  • Angelo Schuler Piletti
  • Anthony Fu
  • Conrawl Rogers
  • Damian Głowala
  • Daniel Roe
  • Harlan Wilton
  • HomWang
  • Ilya Artamonov
  • Julien Huang
  • Krutie Patel
  • Lay
  • Lexpeartha
  • Louis Haftmann
  • Mourad EL CADI
  • Nils
  • Ohb00
  • Oumar Barry
  • Pooya Parsa
  • Qin Guan
  • Richard Schloss
  • Sébastien Chopin
  • TheColaber
  • Umut Aktaş
  • Yaël Guilloux
  • __Catalina

Version v3.0.0-rc.8

Released on January 19, 2023

Originally published at https://github.com/nuxt/framework/releases/tag/v3.0.0-rc.8

Note This version includes hotfixes from rc.7. Check v3.0.0-rc.7 release notes for all changes between rc.6...rc.8

Warning There are slight API changes with this release candidate.

💬 Join the release discussion

🚀 How to upgrade

🩹 Fixes

  • cli: Fix issues with nuxi upgrade (#6514 )
  • nuxt: ⚠️ Allow app:rendered to modify ssr context and add render:html (#6521 )
  • vite: Remove /@fs from external ids (#6529 )
  • nuxt: Tree-shake devtools from production bundle (#6538 )
  • vite, nuxt: Resolve relative to srcDir rather than rootDir (#6546 )

📦 Build

  • nuxt: Publish missing types (#6516 )

📖 Documentation

  • Change info to danger for the pages root element (#6528 )
  • quick-start: Add the file path for disabling generating shim (#6519 )
  • schema: Grammar, punctuation and typo fixes (#6469 )

❤️ Contributors

  • Damian Głowala
  • Daniel Roe
  • Eugen Istoc
  • Jiang Menghao
  • Pooya Parsa
  • Timur Bolotov

Version v3.0.0-rc.7

Released on January 19, 2023

Originally published at https://github.com/nuxt/framework/releases/tag/v3.0.0-rc.7

Warning There are slight API changes with this release candidate. Please check the linked issues marked with ⚠️

Warning This release contains some regressions. Please upgrade to the latest v3.0.0-rc.8

🚀 Enhancements

  • vite: Check types with vue-tsc (#6012 )
  • vite: ⚠️ Upgrade to vite v3 (#5398 )
  • nuxt: ⚠️ Only scan top level composables/ with glob support (#6025 )
  • nuxt: Improve error DX (#4539 )
  • cli: nuxi cleanup command (#6125 )
  • nuxt, schema: Add <NoScript> component and noscript typings (#6139 )
  • nuxt: app:rendered and render:response hooks (#6042 )
  • nuxt: ⚠️ Add support for components/global dir (#6070 )
  • nuxt: Extends support for app.vue (#6228 )
  • nuxt: Add fetchpriority attribute and literal typings for meta components (#6251 )
  • kit: Support followSymbolicLinks option for resolveFiles (#6240 )
  • nuxt: Remove wrapper from client only components (#6165 )
  • nuxt: Add setResponseStatus utility (#6306 )
  • vite: Log vite-node hmr updates (#6351 )
  • nuxt: Update to [email protected] (#6210 )
  • nuxt: Update nitropack to latest (#6442 )

🔥 Performance

  • nuxt: Transform #imports to improve tree-shaking (#5763 )
  • vite-node: Only invalidate cache for user code (#6156 )

🩹 Fixes

  • webpack: Do not resolve #internal/nitro alias internally (#5987 )
  • nuxt: ⚠️ Change statusCode type to number for error page template (#6010 )
  • kit, nuxt: Always sort globby results (#6029 )
  • pages: Ignore expression delimiters within quotes (#6033 )
  • nuxt: Always write nitro types when building (#6035 )
  • kit: Resolve aliases in plugin src (#6037 )
  • vite: Invalidate virtual files when changed (#6038 )
  • nuxt: Use relative path to generate plugin variables (#6030 )
  • types: Generate relative path in imports.d.ts (#6054 )
  • nuxt: Auto import for components with the external template (#6053 )
  • vite: Ignore baseurl when pruning manifest (#6063 )
  • nuxt: Don't ignore components dirs with the same prefix (#6116 )
  • vite: Resolve tsconfig.json for vue-tsc type checker (#6069 )
  • cli: Load .env file before starting dev server (#6119 )
  • nuxt: Normalize manifest css file entries (#6112 )
  • vite: Allow overriding client HMR options (#6082 )
  • nuxt: Clear vite-node runner cache after each render (#6154 )
  • nuxt: Add error event declaration to the <NuxtErrorBoundary> component (#6141 )
  • schema: Add empty noscript array (#6155 )
  • vite: Use unjs/externality to handle vite-node externals (#6153 )
  • nuxt: Allow useHead to accept computed values (#6174 )
  • schema: Exclude functions from DeepPartial (#6176 )
  • nuxt: Don't call renderMeta if it is not defined (#6201 )
  • vite, webpack: Generate composable keys based on order (#6191 )
  • schema: Add typings for vite.vue options (#6220 )
  • vite: Fix dist dir resolution (#6215 )
  • webpack: Output .mjs to use crossorigin preloads (#6232 )
  • kit: Try extensions with resolvePath with absolute input (#6233 )
  • nuxt: Do not allow catchalls to have child routes (#6257 )
  • nuxt: Narrow nuxt.config import protection (#6279 )
  • nuxt: Separate routes for different suspense forks (#6275 )
  • nuxt: Avoid duplicate titleTemplate (#6296 )
  • nuxt: Render head scripts that use body: true (#6293 )
  • nuxt: Generate 200.html and 404.html spa fallback files (#6308 )
  • nuxt: Extract component to provide route (#6325 )
  • nuxt: Remove literal <script setup> from comment (#6331 )
  • vite: Improve vite-node hmr (#6343 )
  • nuxt: Better equality check for json cookies (#6352 )
  • nuxt: Make the route provided to page children reactive (#6349 )
  • nuxi, kit: Enable esmResolve flag for jiti (#6356 )
  • nuxt: Resolve plugins and middleware to their full path (#6350 )
  • vite: Use URL for entry on windows (#6355 )
  • nuxt: Remove side-effect imports from page metadata (#6376 )
  • nuxt: Type useRoute return (#6395 )
  • schema: Cleanup meta tags and deduplicate charset and viewport (#6378 )
  • kit: Move relative path handling back into nuxt templates (#6430 )
  • cli: Upgrade listhen (#6434 )
  • nuxt: Do not log 404 and showError as fatal by default (#6437 )
  • nuxt: Add viteServerDynamicImports as experimental flag (#6433 )
  • nuxt: Use payload error state as the source of truth (#6389 )
  • vite: Add module type to vite node entry (#6448 )
  • nuxt: Handle immediate errors when calling useAsyncData (#6441 )
  • nuxt: Ensure component dirs in node_modules have lower scanning priority (#6382 )
  • nuxt: InteropDefault for page component imports (#6468 )
  • nuxt: Immediately call asyncData handler (#6472 )
  • nuxt: Log fatal errors as well as unhandled (#6488 )

💅 Refactors

  • nuxt: Enhance useFetch and useLazyFetch request type (#4825 )
  • vite: Reuse logic and improve code splitting (#6164 )
  • test-utils: Remove unused codes (#6369 )
  • nuxt: ⚠️ Remove null handling for titleTemplate (#6487 )

📖 Documentation

  • Fix typo in the roadmap (#5979 )
  • Update bridge migration with info about generating .nuxt/tsconfig.json for tests (#5967 )
  • Warn that useState should only contain JSON-serializable content (#5994 )
  • runtime-config: Clarify how environment variables are loaded (#5916 )
  • Add explicit createError import (#6050 )
  • Expand contribution guide for ecosystem (#5922 )
  • Grammar fix (#6106 )
  • Update the link to the configuration (#6137 )
  • Grammar fix (#6166 )
  • api: Add <NuxtLayout> component docs (#6264 )
  • Add theme-color meta (#6250 )
  • Fix external link display text (#6323 )
  • api: Add missing hooks and environment column (#6329 )
  • Add missing periods (2cbdc5c )
  • useFetch: Minor punctuation fixes (#6409 )
  • Update vue-router links (#6421 )
  • Update full static status (#6460 )

📦 Build

  • Upgrade to unbuild 0.8.x (#6483 )

✅ Tests

  • Wrap components with <div> (#6192 )
  • Add key matching test for keyed composables (#6372 )

❤️ Contributors

  • Alwin Lohrie
  • Anthony Fu
  • Brendan Mulholland
  • CSY54
  • Conrawl Rogers
  • Cédric Exbrayat
  • Damian Głowala
  • Daniel Roe
  • David Tai
  • Ennio Visconti
  • Gregor Becker
  • Harlan Wilton
  • Hecateball
  • Julien Huang
  • Kazuya Kawaguchi
  • Kevin Marrec
  • Krutie Patel
  • Lakshya Singh
  • Mitsuki Fukunaga
  • Mohammad Hosein Feizi
  • Nathan Chase
  • Nur Muhammad
  • OptimusePrime
  • Pooya Parsa
  • Rio Weber
  • Sanjaiyan Parthipan
  • Sébastien Chopin
  • Thomas
  • Timur Bolotov
  • Victor Saa
  • YuTin Liu

Version v3.0.0-rc.6

Released on January 19, 2023

Originally published at https://github.com/nuxt/framework/releases/tag/v3.0.0-rc.6

✅ RC.6 is a hotfix release fixing known issues with previous releases

🚀 Enhancements

  • schema: Sync types of vite v2.9.x (#5896 )

🔥 Performance

  • nuxt: Tree-shake client-only components from ssr bundle (#5750 ). Enabled by experimental treeshakeClientOnly flag (#5934 )

🩹 Fixes

  • vite: Set transform mode for vite-node (#5854 )
  • kit: Only call viteExtendConfig callback once (#5929 )
  • nuxt: Lazy load and tree-shake error templates (#5930 )
  • pkg: Use fixed version range for monorepo packages (#5933 )
  • vite: Avoid creating vite server for production build (#5941 )
  • vite: Unset build.watch options for production build (#5958 )
  • vite: Use more strict app entry check in dev-bundler (#5959 )
  • cli: Add missing types field (#5962 )

📖 Documentation

  • Fix typo (#5881 )
  • Improve runtimeConfig example (#5785 )
  • Add readmore link (#5893 )
  • Add way to pass .env variables to nuxt app in production (#5879 )
  • Add missing initialCache to UseFetchOptions types (#5908 )
  • Update roadmap (#5935 )
  • testing: Add missing import (#5956 )

❤️ Contributors

  • Anthony Fu
  • Benicio Cardozo
  • Bot08
  • Damian
  • Daniel Roe
  • Kevin Marrec
  • Lay
  • Lm
  • OptimusePrime
  • Pooya Parsa
  • Yoho
  • 码农小余

See all changes: https://github.com/nuxt/framework/compare/v3.0.0-rc.5...v3.0.0-rc.6

Version v3.0.0-rc.5

Released on January 19, 2023

Originally published at https://github.com/nuxt/framework/releases/tag/v3.0.0-rc.5

This release is featuring 25+ bug fixes, keyless composables, component, and upgraded deployment presets. Stay tuned for RC.6 with Vite 3 support and more enhancements ✨

Feedback about the release: Join the discussion

See all changes: https://github.com/nuxt/framework/compare/v3.0.0-rc.4...v3.0.0-rc.5

⚠️ Breaking Changes

This release contains slight breaking changes. Please check the linked pull requests for notes.

  • auto-import: Unwrap auto imports in SFC templates (#5573 )
  • nuxt: Support universal global middleware (#5038 )
  • nuxt: Remove legacy app context (#5630 )

🚀 Enhancements

  • kit: Allow addServerHandler to use method suffix of the file path (#5465 )
  • kit: Support client and server flags for addVitePlugin (#5560 )
  • auto-import: ⚠️ Unwrap auto imports in SFC templates (#5573 )
  • kit: Add addLayout utility (#5537 )
  • nuxt: ⚠️ Support global middleware without router (#5038 )
  • nuxt: Allow passing custom fetch options to useFetch (#5660 )
  • nuxt: Prerender all pages by default (#5709 )
  • nuxt: Tree-shake client and server-only composables (#5749 )
  • nuxt: Automatically generate unique keys for keyed composables (#4955 )
  • nuxt: Support custom prop for <nuxt-link> (#4249 )
  • nuxt: Add <NuxtLoadingIndicator> component WIP (#5121 )

🔥 Performance

  • nuxt: ⚠️ Remove legacy app context (#5630 )

🩹 Fixes

  • schema: Add types for vite: hooks (#5472 )
  • nuxt: Normalize string transpile paths for windows (#5461 )
  • nuxt: Prefer unctx context over getCurrentInstance for useNuxtApp (#5456 )
  • vite: Add typecheck to vite plugins (#5464 )
  • vite: Disable HMR in build (#5505 )
  • schema, postcss: cssnano is enabled if not dev (#5583 )
  • vite: Do not watch ignored pathes (#5632 )
  • vite-node: On-demand manifest (#5017 )
  • nuxt: Pass attrs and props to client-only components (#5668 )
  • kit: Allow adding server-only and client-only components separately (#5686 )
  • webpack: Transpile vue-demi (#5721 )
  • nuxt: useRequestHeaders type should allow for undefined values (#5748 )
  • nuxt: Update useFetch key warning to include any function or blob (#5710 )
  • vite: Do not inline dynamic imports in server (#5506 )
  • nuxt: Handle undefined when applying defaults for useAsyncData (8d2f805 )
  • vite: Fix vite-node circular reference (#5764 )
  • nuxt: Use virtual server stub for ssr: false (#5773 )
  • nuxt: Don't return stub function from tree-shaken composables (#5786 )
  • test-utils: Update vitest import path with .mjs (#5817 )
  • nuxt: Only tree-shake composables on their own lines (#5850 )
  • nuxt: Extend nitro routes instead of overriding (#5828 )
  • cli: Show base url in terminal (#5337 )
  • nuxt: Add import protection to nitro config (#5847 )
  • nuxt: Replace process.dev in nitro bundle (#5852 )
  • nuxt: Warn about legacy and invalid plugins (#5857 )
  • nuxt: Fix issues with vue-router and @vue/devtools-api bundling (#5874 )
  • vite: Close vite watcher before building (#5875 )

📖 Documentation

  • Update roadmap (#5443 )
  • Rewrite note wording (#5462 )
  • Align value for defaulting the page's title with type declaration (#5447 )
  • Fix link to nuxt/image issue (#5490 )
  • Add notes about reporting security issues (#4895 )
  • testing: Fix async/await (#5539 )
  • api: Add watch parameter in useFetch options (#5562 )
  • examples: Rename hello.ts to [...hello].ts (#5261 )
  • Update usage about runtime config and environment variables (#5569 )
  • Update pnpm usage (#5597 )
  • Minor wording improvements (#5622 )
  • Replace invalid link to composables (#5611 )
  • Rework the layout section (#5118 )
  • api: Add docs for <NuxtPage> component (#5591 )
  • Clarify that definePageMeta only works in the pages directory (#5663 )
  • Update vuejs-development (#5679 )
  • Add full stop (#5680 )
  • api: Update commands with new NODE_ENV behavior (#5739 )
  • plugins: Add directive example (#5667 )
  • Fix Vite check for Nuxt 3 (#5768 )
  • useFetch uses isomorphic $fetch (#5769 )
  • Add content directory to directory-structure (#5755 )
  • api: Add anavigateTo docs (#5701 )
  • Fix link to NuxtLoadingIndicator component src (#5776 )
  • Use defineLazyHandler in wasm example (#5797 )
  • Use toUTCString in useAsyncData example (#5798 )
  • Add missing dot (#5815 )
  • Update nuxt-link (#5819 )
  • Lint whitespaces (#5633 )
  • Fix typo (#5865 )
  • Fix typo (#5863 )

❤️ Contributors

  • Ahad Birang
  • Alexander Lichter
  • AnPineau
  • Anders Søgaard
  • Anthony Fu
  • Bob Olde Hampsink
  • Bot08
  • Clément Ollivier
  • Cupid Valentine
  • Damian
  • Daniel Roe
  • Donatelloraphael
  • Francisco Buceta
  • Haruaki OTAKE
  • Ibrahim Abdullahi Aliyu
  • Julien Huang
  • Krutie Patel
  • Mourad EL CADI
  • Mrauhu
  • Nestor Vera
  • Paranoid
  • Pooya Parsa
  • Qin Guan
  • Sumiren
  • Sébastien Chopin
  • Thibault Vlacich
  • Thomas Jowsey
  • Vasiliy
  • Xanlantos
  • Yuki Inoue
  • 井上裕貴

Version v2.16.3

Released on March 17, 2023

2.16.3 is a patch release with bug fixes.

👉 Changelog

compare changes

🩹 Fixes

  • types: Add return type for error() (#19044 )
  • types: Bring types from less into namespace (#19738 )
  • types: Sync vue type augmentations with Vue 2.7 (#19526 )
  • config: Move preset to inner postcssOptions (#19518 )
  • webpack: Add node-fetch-native to externals list (#19755 )

🏡 Chore

  • Release all packages with latest tag except nuxt (4e9dcddcb )
  • examples: Use 2.x version of nuxt instead of latest (#19737 )
  • Lint package files (6ca842e36 )

❤️ Contributors

Version v2.16.2

Released on March 1, 2023

2.16.2 is a patch release with bug fixes.

✨ Highlights

The main change in this patch release is that we now patch the crypto node built-in during build to allow Nuxt 2 to be used on Node versions greater than Node 16, which should ease the pressure users feel after Node 16 reaches its own EOL this year.

Warning This should not be taken for an endorsement of continuing to run with Webpack 4, which is out of date and has a number of dependencies with issues. I expect that number to continue to grow, and we will not be able to resolve all of them. I would strongly urge migrating to Nuxt 3 if possible and the team will do our best to make this possible over the course of the year ❤️

👉 Changelog

compare changes

🚀 Enhancements

  • types: Add basic types for Nuxt interface (#9772 )

🩹 Fixes

  • vue-renderer: Insert charset before title (#18998 )
  • types: Remove non-existent properties from context (#19021 )
  • Add minimum node 14.18 version constraint (#19112 )
  • config: Upgrade md4 -> md5 on node > 16 (#19108 )
  • vue-app: Handle promise rejection from asyncData (#18585 )

🏡 Chore

❤️ Contributors

Version v2.16.1

Released on February 13, 2023

Nuxt 2.16.1 is a patch release with a couple of small bugfixes to last week's 2.16.0 release.

v2.16.0...v2.16.1

🩹 Fixes

  • deps: Downgrade @types packages depending on webpack 5 (#18827 )
  • config: Let webpack merge postcss plugins (#18839 )
  • types: Import Location from vue-router (#18908 )

🏡 Chore

❤️ Contributors

Version v2.16.0

Released on February 3, 2023

Nuxt 2.16.0 is the first minor release since Feb 15, 2021. The focus is mostly on releasing the latest fixes and enhancements that have been present in nuxt-edge for some time.

✨ Highlights

⚠️ Breaking changes

  • In this PR we only support Node 14+. This is mostly an issue for dependencies, which we need to keep updated for security reasons. Going forward until its own EOL , Nuxt 2 will only officially support Node versions that have not reached their EOL .
  • New postcss options format. See #9671 for full details.
  • Dependency upgrades. A number of dependencies have dropped support for earlier node versions. dotenv has changed how it parses .env files in a number of edge cases. glob now requires / instead of \ on windows machines. There may also be other changes that affect your usage, so please do upgrade with care.
  • Vue 2.7 upgrade. Although you can use Vue 2.7 with any release of Nuxt 2, 2.16.0 for the first time includes it as a dependency, which means that you may well encounter some issues associated with upgrading Vue 2.6 -> Vue 2.7.
    This may be a good time to consider using the composition API utilities provided by https://github.com/nuxt/bridge instead, which mirror Nuxt 3's more precisely than @nuxtjs/composition-api. (You can opt-in to just these utilities by disabling the other bridge modules individually.)

Changelog

compare changes

🚀 Enhancements

  • config: Support nuxtrc in dist directory (#9280 )
  • generator: Add ignoreEnv generate option during ensureBuild(cmd) (#8955 )
  • server: Allow disabling serve-static middleware (#9365 )
  • types: Add asyncData return types to component instance type (#9239 )
  • vue-app: context.beforeSerialize method (#9332 )
  • vue-app: Pass store to createRouter (#9629 )
  • Default to core-js version 3 (#9987 )
  • webpack: ⚠️ Update postcss to v8 (#9671 )

🩹 Fixes

  • vue-app: Respect scroll-margin-top when navigating with hash (#9187 )
  • webpack: Use javascript/auto for js rule (#9180 )
  • server: Unregister error event listener (#9245 )
  • babel-preset-app: Respect explicit options.targets for modern preset (#9337 )
  • types: Add nuxt.config alias type (#9424 )
  • vue-app: Check whether route exists within nuxt app before replacing (#9431 )
  • vue-renderer: Decode route path for payload.js (#9494 )
  • vue-app: Don't normalise route path if it's valid (#9460 )
  • vue-app: Redirect to external url replaces current history entry (#9500 )
  • utils: trailingSlash causes error with dynamic nuxt-child routes (#9505 )
  • types: Add onNuxtLoaded and onNuxtReady types (#9510 )
  • vue-app: Re-register components construtor in HMR (#9539 )
  • types: Add typing for build.stats options (#9555 )
  • babel: Loose option for babel private-property-in-object (#9631 )
  • vue-app: Serialize route meta to allow functions (#9634 )
  • vue-app: null check for $root access (#9150 )
  • generator: Allow passing builder to getGenerator (#9574 )
  • generator: Throw an error when Builder is missing (#9663 )
  • vue-app: Use correct $config for finding basePath (#9706 )
  • vue-renderer: Ensure custom build indicator preserves some whitespace (#9705 )
  • 'npm run test' fails because the last command lacks 'yarn' (#9761 )
  • generator: Decode path with ufo (#9739 )
  • cli: Ensure nuxt instance is closed when skipping build (3e9d7e3 )
  • Nuxt-child-key in web-types.json (#9792 )
  • types: Return type of $fetch (#9854 )
  • deps: Update ua-parser-js to 1.x (#9979 )
  • deps: Update ya-parser-js to latest 0.7.x (#9979 )
  • vue-app: Call ssrContext.unsetMutationObserver only if it exists (#10132 )
  • webpack: Allow files with .cjs extension to be transpiled (#10340 )
  • vue-app: Preview mode fetch (#10489 )
  • webpack: Resolve .wasm extension with lower priority (#10676 )
  • vue-app: Clear hide timeout when calling clear() (#10086 )

📦 Build

🌊 Types

  • Add prefetchPayloads to router options (#9715 )

🏡 Chore

  • release: V2.15.6 (a53fd32 )
  • pkg: Build for es2019 target (#9328 )
  • types: Add types for new false option for render.static (#9372 )
  • Update error tests (d4e5998 )
  • test: Revert jest and babel-jest to 26 (#9377 )
  • Ignore audit 1754,1755 (39f7859 )
  • Fix vetur extension syntax for GitPod (#9572 )
  • Ignore globby > 12 upgrade as needs native esm (e0968a3 )
  • Update rollup plugins (5614399 )
  • Fix code formatting (17bbb21 )
  • utils: Improve stripWhitespace utility (#9668 )
  • Update license year to present (#9682 )
  • Add separate file with security disclosure info (#9738 )
  • Update logo (#9796 )
  • doc: Fix link to contribution guide (#9815 )
  • test: Fix external redirect link (#9816 )
  • Update funding.yml (1f85137 )
  • Update lockfile (7614360 )
  • Update audit list (6f73c36 )
  • Update lockfile and audit (1878b26 )
  • Update issue template with nuxt 3 (#9948 )
  • Enable blank issues (54542c1 )
  • radme: Fix browserstack and saucelabs icons (#10068 )
  • Update dependencies (#10510 )
  • Update repo (773d292 )
  • Ignore vue and vuex major updates (bafc814 )
  • Update README.md (#10831 )
  • Update pull request template (0db7e7b )
  • Update issue templates (f36fb9c )
  • Rename 2.x bug template (ba966cf )
  • Move nuxt 2 report to bottom (ce7b1a9 )
  • Bump ua-parser-js version (1cedad5 )
  • Bump test/dev dependencies (#18672 )
  • Upgrade unjs dependencies (#18670 )
  • Use named export from defu (#18679 )

✅ Tests

🤖 CI

⚠️ Breaking Changes

  • webpack: ⚠️ Update postcss to v8 (#9671 )

❤️ Contributors