Skip to content

Update dependency nuxt to v3

GitLab Dependency Bot requested to merge gitlab-renovate-forks/gitlab-svgs:renovate/nuxt-3.x into main

This MR contains the following updates:

Package Type Update Change
nuxt devDependencies major ^2.2.0 -> ^3.6.5

MR created with the help of gitlab-org/frontend/renovate-gitlab-bot

Release Notes

nuxt/nuxt

v3.6.5

Compare Source

3.6.5 is a hotfix patch release addressing the regression with nuxt/content introduced in v3.6.4.

v3.6.4 release notes

✅ 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: Remove dist from the default ignore list (#​22227)
❤️ Contributors
  • Anthony Fu <anthonyfu117@​hotmail.com>

v3.6.4

Compare Source

3.6.4 is a patch release, brought forward to allow releasing some important bug fixes before work begins on 3.7.

Warning We're currently investigating a regression with nuxt/content and will be releasing 3.6.5 later today.

✅ 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,schema: Do not watch buildDir and node_modules (#​22214)
🩹 Fixes
  • nuxt: Correctly use toLowerCase for possible moduleResolution (#​22160)
  • nuxt: Don't redirect if initial path has trailing slash (#​22192)
  • nuxt: Work around payload extraction issue (#​22162)
  • nuxt: Add baseURL to island fetch requests (#​22009)
  • nuxt: Resolve race condition regenerating auto imports (#​22201)
  • nuxt: Ensure we only increment hydrating count once (#​22200)
  • nuxt: Avoid premature hydration when using async layouts (#​22198)
  • cli: Support --inspect in dev mode (#​22205)
  • test-utils: Pass along error if server can't start (#​22216)
📖 Documentation
  • Add runtime storage configuration examples (#​22189)
  • Add instruction on how to use other modules in a module (#​22081)
  • Standardize indentation and tag positioning (#​22157)
❤️ Contributors

v3.6.3

Compare Source

3.6.3 is the next patch release, including a number of fixes. It's anticipated this will be the last patch release before 3.7.

✅ 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: Prepopulate island payloads from rendered html (#​22049)
🩹 Fixes
  • kit: Module compatibility not working with module names (6cabe69ce)
  • schema: Correct type of unctx options (4e32e70bb)
  • vite: Pass modulesDir to isExternal (#​21966)
  • nuxt: Add pages in correct hook when generating (#​22088)
  • test-utils: Export from core playwright package (#​22122)
  • nuxt: Skip view transitions where there is no route change (#​22140)
  • nuxt: Skip scanning components that do not produce a name (#​22074)
  • cli: Add aliases to monorepo paths to tsconfig includes (#​21997)
  • cli: Allow non-existent experimental option (0643d4315)
💅 Refactors
  • cli,schema: Add bundler module resolution flag (#​22142)
📖 Documentation
🏡 Chore
❤️ Contributors

v3.6.2

Compare Source

3.6.2 is the next patch release, with a raft of fixes including preparations for use without --shamefully-hoist and some fixes for data fetching within nested layouts/pages.

✅ 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: Don't run island transform plugin if disabled (#​21844)
  • nuxt: Allow hmr for server components in dev mode (#​21916)
  • nuxt: Use getters when constructing reactive routes (#​21957)
🩹 Fixes
  • nuxt: Only redirect if path is not the same as initial url (#​21815)
  • cli: Resolve @nuxt/ui-templates from modulesDir (#​21836)
  • nuxt, vite: Do not use cjs utils to resolve/alias vue (#​21837)
  • nuxt: Improve default prerender behaviour (#​21817)
  • vite: Greater type-safety within runtime vite-node (#​21849)
  • nuxt: Ensure static presets equivalent to nuxi generate (#​21860)
  • nuxt: Handle injecting multiple entry ids for styles (#​21864)
  • nuxt: Stop loading indicator on navigation failure (#​21751)
  • cli: Respect nitro ssl cert/key variables (#​21912)
  • nuxt: Include external layers in tsconfig.json scope (#​21917)
  • nuxt: Support custom route name meta with typedPages (#​21659)
  • vite: Remove @​vue/ scoped libraries from resolutions (#​21922)
  • nuxt: Add layers in node_modules to tsconfig include (#​21929)
  • nuxt: Regenerate imports after template (#​21934)
  • vite: Fix issue detecting shadowed keyed composables (#​21891)
  • nuxt: Use $fetch.raw in dev client mode for islands (#​21904)
  • schema: Warn if user provides vite.publicDir (#​21847)
  • nuxt: Preserve old vnode when leaving nested route (#​21823)
  • kit: Ignore telemetry startup time (as it has prompt) (#​21959)
📖 Documentation
  • Add warning about dynamic import of css (#​21805)
  • Update example links (#​21811)
  • Fix broken spaLoadingTemplate link (#​21845)
  • Update useFetch return values (#​21852)
  • Describe environment override feature (#​21879)
  • Add Daniel example for hybrid rendering and Vercel (20d59d1cf)
  • Improve hybrid rendering (3fb329cc8)
  • rendering: Add end of sentence (565787183)
  • Add closing bracket (#​21887)
  • Added a note about server dynamic routes limitation (#​21919)
  • Update docs for <NuxtLoadingIndicator> (#​21952)
  • Update more links to examples repo (13a892361)
  • Add JetBrains IDEs debug configuration (#​21965)
🏡 Chore
  • Prune internal unused code and exports (#​21809)
  • Add codeflow overrides configuration (d7267663f)
✅ Tests
  • Add nuxt-vitest and composable unit tests (#​21884)
❤️ Contributors

v3.6.1

Compare Source

3.6.1 is a bugfix/patch release with some significant patches merged since 3.6.0

✅ 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: Use esbuild/acorn instead of typescript dep (#​21729)
  • nuxt: Proxy headers to islands + returned prerender hints (#​21740)
  • nuxt: Respect false to disable spa loading template (#​21739)
  • nuxt: Remove path from SPA payload (#​21732)
  • nuxt: Only remove one item from middleware (#​21730)
  • nuxt: Escape colons in page paths (#​21731)
  • nuxt: Augment nitro config within server context as well (#​21724)
  • nuxt: Inline global css with ssr: false route rule (#​21763)
  • vite: Resolve css files without importer id first (#​21770)
  • vite: Emit assets referenced in inline css (#​21790)
  • nuxt: Support importing types from #imports (#​21796)
  • nuxt: Use starting index when transforming islands (#​21795)
📖 Documentation
  • Add defineNuxtRouteMiddleware migration (#​21718)
  • Add a link to Docus layer nuxt config file (#​21742)
  • Remove outdated reference to stable version (#​21785)
  • Centre example loading spinner (#​21792)
✅ Tests
❤️ Contributors

v3.6.0

Compare Source

3.6.0 is the next minor release, packed with improvements and bug fixes.

📣 Upcoming news

In the coming week you can expect two announcements:

  1. The open-sourcing of nuxt/cli by @​pi0 - a new, drop-in replacement for nuxi featuring more extensibility and better DX. We are aiming to release this alongside Nuxt 3.7, but you would be very welcome to test and contribute to nuxi-ng before then!
  2. Three significant RFCs: Nuxt Font, Nuxt Assets and Nuxt Scripts. We're expecting an initial POC to take shape in the next month, and would very much appreciate community feedback on this.

👀 Highlights

This minor release contains quite a lot, and we have big plans

 SPA loading indicator

If your site is served with ssr: false or you have disabled server-rendering on some of your pages, you might be particularly interested in the new built-in SPA loading indicator.

You can now place an HTML file in ~/app/spa-loading-template.html with some HTML you would like to use to render a loading screen that will be rendered until your app is hydrated on these pages.

👉 By default an animated Nuxt icon is rendered. You can completely disable this indicator by setting spaLoadingTemplate: false in your nuxt configuration file.

⚡️ Performance improvements

The first thing that happens when your app is hydrated is that your plugins run, and so we now perform build-time optimisations on your plugins, meaning they do not need to be normalised or reordered at runtime.

We also include your error component JS in your main entrypoint, meaning that if an error occurs when a user has no connectivity, you can still handle it with your ~/error.vue. (This also should decrease your total bundle size.)

👉 Compared to Nuxt 3.5.3, the minimal client bundle has decreased by ~0.7kB. Let's keep this up!

🔥 Fully static server components

It has been possible to use server components on static pages, but until now they would increase the payload size of your application. That is no longer true. We now store rendered server components as separate files, which are preloaded before navigation.

👉 This does rely on the new, richer JSON payload format, so make sure you have not disabled this by setting experimental.renderJsonPayloads to false.

🎨 Better style inlining

If you're monitoring your metrics closely and have not turned off experimental.inlineSSRStyles, you should see more CSS inlined in your page, and a significantly external CSS file. We're now better at deduplicating global CSS, particularly added by libraries like tailwind or unocss.

🎬 Animation controls

To give you more fine-grained control over your page/layout components, for example to create custom transitions with GSAP or other libraries, we now allow you to set pageRef on <NuxtPage> and layoutRef on <NuxtLayout. These will get passed through to the underlying DOM elements.

✨ Automatic 'static' preset detection

Up to now, running nuxt generate produced the same output on every deployment provider, but with Nuxt 3.6 we now enable static provider presets automatically. That means if you are deploying a static build (produced with nuxt generate) to a supported provider (currently vercel and netlify with cloudflare and github pages coming soon) we'll prerender your pages with special support for that provider.

This means we can configure any route rules (redirects/headers/etc) that do not require a server function. So you should get the best of both worlds when deploying a site that doesn't require runtime SSR. It also unblocks use of Nuxt Image on Vercel (with more potential for automatic provider integration coming soon).

💪 Increased type safety

We now have better support for server-specific #imports and augmentations if you are using the new ~/server/tsconfig.json we shipped in Nuxt 3.5. So when importing from #imports in your server directory, you'll get IDE auto-completion for the right import locations in Nitro, and won't see Vue auto-imports like useFetch that are unavailable within your server routes.

You should now also have type support for runtime Nitro hooks.

Finally, we have removed more locations where objects had a default any type. This should improve type safety within Nuxt in a number of locations where unspecified types fell back to any:

  • RuntimeConfig
  • PageMeta
  • NuxtApp['payload'] (accessible now from NuxtPayload interface)
  • ModuleMeta

You can find out more about how to update your code if this affects you in the original MR.

⚗️ Nitro 2.5 built-in

This release ships with new Nitro 2.5, which has a whole list of exciting improvements that are worth checking out.

Of particular note is experimental support for streaming, which is also enabled by a couple of changes in Nuxt itself.

🛠️ New tools for module authors

This release brings a number of utilities for modules authors to easily add type templates and assert compatibility with a given version of another module.

In addition, this release will finally unlock a new nuxt/module-builder mode that should improve type support for module authors. If you're a module author, you might consider following these migration steps to try it out in the coming days.

✅ 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
  • nuxt: Sync useCookie state between tabs (#​20970)
  • kit: Module compatibility utils (#​21246)
  • nuxt: Add renderResult to app:rendered (#​18610)
  • webpack: Allow configuring esbuild-loader options (#​21436)
  • nuxt: Add open option in navigateTo helper (#​21333)
  • webpack, schema: Add webpack experiments configuration (#​21446)
  • nuxt: Provide clearNuxtState composable (#​21409)
  • kit: addTypeTemplate helper with auto-registration (#​21331)
  • nuxt: Return status from useAsyncData (#​21045)
  • nuxt: Allow accessing NuxtPage ref via pageRef (#​19403)
  • nuxt: Allow accessing NuxtLayout ref via layoutRef (#​19465)
  • nuxt: Emit error in ssr-error event (#​21547)
  • nuxt: Start loading indicator state with middleware (#​21003)
  • kit: Allow direct function in defineNuxtModule (#​20763)
  • nuxt: Expose useNuxtApp to window for convenience (#​21636)
  • nuxt: Allow configuring spa loading indicator (#​21640)
  • nuxt: Add types for nuxt-defined nitro runtime hooks (#​21666)
  • nuxt: Update devdependency nitropack to v2.5.1 (#​21696)
🔥 Performance
  • nuxt: Mark define functions as side-effect free at source (#​21434)
  • nuxt: Import error component synchronously (#​21406)
  • nuxt: Use prerendered islands to serialise/revive payload (#​21461)
  • nuxt: Extract and apply plugin order at build time (#​21611)
🩹 Fixes
  • nuxt: Handle page rendering on different path (#​21408)
  • nuxt: Replace BigInt literal with BigInt constructor (#​21427)
  • vite: Remove resolveId workaround and update vite-node (#​21423)
  • schema: Remove obsolete terser option from webpack config (#​21407)
  • nuxt: Skip vue render when redirecting (#​21412)
  • nuxt: Avoid early returning renderer with empty response (#​21439)
  • nuxt: Add missing vue types (#​21445)
  • nuxt: Prefix server component ids to avoid collisions (#​21472)
  • schema: Add more explicit types for config schema (#​21475)
  • nuxt: Fix typo on nitro.autoImport option (#​21485)
  • nuxi,nuxt: Remove baseUrl + use relative paths in tsconfig (#​21081)
  • vite: Invalidate templates by dst not src (#​21501)
  • nuxt: Don't disable vue endpoint in dev mode (#​21524)
  • nuxt: Respect query/hash for external routes in navigateTo (#​21500)
  • nuxt: Abort navigation when updating window.location (#​21521)
  • vite: Ignore and warn if vite config file exists (#​21588)
  • nuxt: Ensure prerendered components are treated as islands (#​21583)
  • nuxt: Improve warning for invalid children of <Title> (#​21613)
  • nuxt: Replace : in rendered server components (for win) (#​21645)
  • cli: Add back default baseUrl in tsconfig.json (#​21632)
  • nuxt: Post non-proxied cookie value via BroadcastChannel (#​21653)
  • nuxt: Stop indicator when not changing page component (#​21656)
  • nuxt: Scroll to top in nested routes (#​21657)
  • nuxt: Inline css directly in root component (#​21573)
  • nuxt: Move to @typescript-eslint/typescript-estree (#​21664)
  • nuxt: Guard res.end() calls with check if event is handled (#​21665)
  • nuxt: Do not embed error path in payload (#​21671)
  • nuxt: Use static nitro build if possible (#​21655)
  • nuxt: Add aliases and augmentations for nitro context (#​21680)
  • nuxt,schema: Prefer unknown rather than any for signatures (#​21700)
  • schema: Change redirect type for NuxtPage type (#​21713)
  • nuxt: Fix error on layout switching (#​21450)
📖 Documentation
  • Add info about vue configuration (#​21303)
  • Include example for server utilities (#​21337)
  • Improved recommended gitignore list (#​21451)
  • Add info about merging strategy in app config (#​21462)
  • Avoid using render when defining rendering (#​21490)
  • Remove example of deprecated reactivity transform (#​21396)
  • Fix addTypeTemplate typos (#​21520)
  • Add warning about redirect check (#​20680)
  • Remove link to closed RFC (#​21564)
  • Info icon fix on "Standalone server" section (#​21589)
  • Add note to use nuxt with bridge if nitro is false (#​21586)
  • Add styling section (#​21525)
  • Add full stop (#​21614)
  • Reorder sfc blocks and add initial slash in link (#​21618)
  • Add info on extending the HTML template (#​21615)
  • Document parallel option on plugins (#​21622)
  • Americanize spelling + fix typos (#​21627)
  • Remove examples/ from repository (#​21538)
  • examples: Add bullet points (9df892a17)
  • Add experimental features page (#​21617)
  • Fix typo in experimental features (#​21663)
  • Update specified Nuxt 2 version in migration guide (#​21699)
  • Added @latest to install commands (#​21702)
🏡 Chore
  • Add vitest renovate group (7695aca93)
  • Add full version for octokit/request-action (dd5955caf)
  • Widen peer deps in renovate updates (b0ba4b864)
  • Bump bundle size 🤔 (ce4f46385)
  • Ignore webpack-dev-middleware updates on 2.x branch (7f7ae96d1)
  • Ignore vercel/netlify build directories (5d4b71426)
✅ Tests
  • Update bundle size (08df73801)
  • Skip instance error test in vite ecosystem CI (f97052cba)
🤖 CI
  • Move bundle skipping logic to workflow (#​21448)
  • Build project before calculating bundle size (ce096da96)
❤️ Contributors

v3.5.3

Compare Source

3.5.3 is expected to be the last patch release before our next raft of features lands in v3.6.

✅ 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: Avoid watching nested paths (#​21256)
🩹 Fixes
  • nuxt: Handle serialising empty bigint (#​21257)
  • cli: Pass --no-clear config through to vite (#​21262)
  • cli: Always use the latest devtools wizard (#​21291)
  • schema: Update vue-loader options type (#​21363)
  • schema: Add types for vue experimental features (#​21364)
  • nuxt: Display errors in client overlay with typeCheck (#​21064)
  • nuxt: Support usage of std-env in runtime code (#​21372)
  • nuxt: Key distinct pages differently for legacy asyncData (#​21263)
  • vite: Skip generating keys for locally scoped functions (#​20955)
  • kit: Temporarily inline lodash.template from lodash-es (#​20892)
📖 Documentation
  • Add index.vue to page routing example (#​21240)
  • Distinguish between $fetch and fetch composables (#​21228)
  • Adjust env property to match runtimeConfig (#​21265)
  • Fix Cloudflare capitalization (#​21267)
  • Migrate transition class names and style prop (#​21281)
  • Remove irregular spaces (#​21380)
🏡 Chore
  • Pin dev dependencies (9fb83b744)
  • Avoid inlining deps in vitest (#​21316)
  • Rewrite crawler to remove old dependencies (#​21326)
  • Support vitest 0.30.0 peer dependency (d58d1ea1e)
✅ Tests
🤖 CI
  • Apply security best practices to workflows (#​21328)
  • Pin more action dependencies to hash (#​21330)
❤️ Contributors

v3.5.2

Compare Source

3.5.2 is a patch release focusing on 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: Use .test and hoist regexps where possible (#​21011)
🩹 Fixes
  • nuxt: Fix useLazyFetch types (#​20989)
  • nuxt: Scan component dirs case-sensitively (#​20995)
  • schema: Remove duplicate @default jsdoc tag (#​21010)
  • nuxt: Add type support for router composables without pages/ integration (397c54c9d)
  • nuxt: Use simple incrementing id on client (#​20992)
  • nuxt: Treeshake <DevOnly> with webpack (#​21013)
  • nuxt: Await nuxt ready state before refreshNuxtData (#​21008)
  • nuxt: Show error page after fatal abortNavigation (#​21047)
  • nuxt: Normalize windows paths in granular watcher (#​21066)
  • nuxt: Omit Set-Cookie header if value is null (#​21072)
  • nuxt: Resolve modules relative to modulesDir (#​21082)
  • vite: Narrow vite-node inline pattern (#​21224)
📖 Documentation
🏡 Chore
✅ Tests
  • Refactor type tests into a separate fixture (#​21007)
  • Close out some missing browser contexts (3bc3aeaf6)
❤️ Contributors

v3.5.1

Compare Source

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

v3.5.0

Compare Source

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 (https://github.com/nuxt/nuxt/pull/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 (https://github.com/nuxt/nuxt/pull/19205, https://github.com/nuxt/nuxt/pull/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:

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 (https://github.com/nuxt/nuxt/pull/20284).

You can follow the server component roadmap at https://github.com/nuxt/nuxt/issues/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: https://github.com/nuxt/nuxt/pull/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 (https://github.com/nuxt/nuxt/pull/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
  • Run autofix on renovate branches (af75f18cf)
  • Run 2.x nightly release on node 16 (a81f9e4c8)
  • Add conditional for node 16 test (aee1218e6)
  • Set max memory for nuxt2 release script globally (d1a5719cb)
  • Add workflow to release branches (bc28d536c)
  • Update pr condition (f8c7b34bd)
  • Update repo 🤣 (f88c1e645)
  • Allow specifying tag for edge releases (5fdb6a6d6)
  • Comment with link to tag of released version (f945cb197)
  • Pass tag as argument (1aec0e503)
  • Release edge versions of labelled prs (cdc42d044)
❤️ Contributors

v3.4.3

Compare Source

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

v3.4.2

Compare Source

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
  • Don't run ci for release branches (f550976f7)
  • Give write access to changelogensets (0518cdbff)
❤️ Contributors

v3.4.1

Compare Source

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
❤️ Contributors

v3.4.0

Compare Source

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

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.

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:

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.

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.

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 ~/~~/@/@@&#8203; 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 https://github.com/nuxt/nuxt/pull/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 ~/~~/@/@@&#8203; 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
📖 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

v3.3.3

Compare Source

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
  • Run docs linting step on node 18 (1ae5b2c58)
❤️ Contributors

v3.3.2

Compare Source

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
🏡 Chore
✅ Tests
🤖 CI
❤️ Contributors

v3.3.1

Compare Source

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 (https://github.com/nuxt/nuxt/pull/19394). When these files are changed, we'll automatically restart the nuxt server.

  export default defineNuxtConfig({
    modules: [
      '@&#8203;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 (https://github.com/nuxt/nuxt/pull/19422).

♻️ Restarting Nuxt

You can add files to the watch array to automatically restart the server (https://github.com/nuxt/nuxt/pull/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 (https://github.com/nuxt/nuxt/pull/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 (https://github.com/nuxt/nuxt/pull/19335), and support tree-shaking more of your build (https://github.com/nuxt/nuxt/pull/19508). We also now support preloading <NuxtLink>s with a route in object-syntax (https://github.com/nuxt/nuxt/pull/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 (https://github.com/nuxt/nuxt/pull/19383), or to have magic keys automatically injected (https://github.com/nuxt/nuxt/pull/19490) - primarily useful for module authors.

🐛 Error handling

We now handle chunk errors by default (https://github.com/nuxt/nuxt/pull/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> (https://github.com/nuxt/framework/pull/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 (https://github.com/nuxt/nuxt/pull/19519) - and automatically tree-shake server-only head composables like useServerHead from your client build (https://github.com/nuxt/nuxt/pull/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 (https://github.com/nuxt/nuxt/pull/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 (https://github.com/nuxt/nuxt/pull/19243). We also landed a couple of improvements with stacktraces involving Nuxt hooks (https://github.com/unjs/hookable/pull/69 and https://github.com/unjs/hookable/pull/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 (https://github.com/unjs/nitro/pull/1002).

We also now type more of NuxtApp and correctly type unknown injections for greater type-safety (https://github.com/nuxt/nuxt/pull/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 (https://github.com/nuxt/nuxt/pull/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 (https://github.com/nuxt/nuxt/pull/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 (https://github.com/nuxt/nuxt/pull/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 (https://github.com/nuxt/nuxt/pull/19537, https://github.com/nuxt/nuxt/pull/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 (https://github.com/nuxt/nuxt/issues/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 (https://github.com/nuxt/nuxt/issues/15592), and we've now enabled this by default (https://github.com/nuxt/nuxt/pull/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

v3.3.0

Compare Source

v3.2.3

Compare Source

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
🏡 Chore
🤖 CI
❤️ Contributors

v3.2.2

Compare Source

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 https://github.com/nuxt/nuxt/pull/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 https://github.com/nuxt/nuxt/pull/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
📦 Build
🏡 Chore
✅ Tests
  • Skip vnode warning on windows dev mode (71bcd9550)
🤖 CI
  • Run webpack/vite and dev/prod as matrices (#​18905)
❤️ Contributors

v3.2.1

Compare Source

v3.2.0

Compare Source

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 nuxi@latest 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
  • Decrease vite logging during tests (5426e5609)
❤️ Contributors

v3.1.2

Compare Source

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
  • Publish nightly nuxt-edge for nuxt v2 (dd0e2643c)
  • Fix ref for 2.x branch (21badd9f2)
  • Allow manually dispatching nightly nuxt2 build (09114125c)
❤️ Contributors

v3.1.1

Compare Source

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

v3.1.0

Compare Source

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

💬 Release Discussion

👀 Highlights

  • 📖 Lots of improvements to the documentation and website (you can already see them in nuxt.com)
  • 🏝️ Experimental component Islands and server only components
  • ✨ New onNuxtReady, useNuxtData and useSeoMeta composables
  • ﹛ experimental config schema (for module or theme authors)
  • 💪 Upgraded to Nitropack v2
  • ⚡️ Migrated to Vite 4 and Rollup 3.

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

v3.0.0

Compare Source

✨ 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
❤️ Contributors

v2.17.1

Compare Source

2.17.1 is the next patch release for Nuxt 2.

👉 Changelog

compare changes

🩹 Fixes
  • webpack: Downgrade dev-middleware to fix peer dep issue (#​21626)
  • webpack: Pin webpack-dev-middleware to 5.0.0 (#​21804)
❤️ Contributors

v2.17.0

Compare Source

2.17.0 is the next minor release for Nuxt 2.

✨ Highlights

Nuxt 2.17 comes with a few new features, including better support for new Vue 2.7 types, and supporting passing postcss config as a function.

It also includes support for Node 20+ and a fix for a dependency issue with the Babel preset that affected new installs.

👉 Changelog

compare changes

🚀 Enhancements
  • types: Support nuxt types for defineComponent (#​19789)
  • csp: Support generating nonce for scripts and links in ssr (#​9621)
  • webpack: Support passing function as postcssOptions (#​19495)
🔥 Performance
  • config: Avoid recursive md4 patching (7fab95252)
🩹 Fixes
  • Relax node engines upper constraint (010b539ed)
  • utils: Respect patterns within paths when sorting routes (#​20669)
  • vue-app: Skip page render early on error or navigation (#​20719)
  • babel-preset-app: Add explicit dep on used babel plugin (#​21488)
🏡 Chore
  • Reenable publishing 🙈 (4ce8b118e)
  • Exclude yaml exception vulnerability (build-time dep) (c8ed87a26)
  • Bump jest dependencies (#​20506)
  • Remove resolved advisories (98cd35665)
  • Skip publishing node_modules folder (8799cfacc)
  • Remove obsolete useWorkspaces option (27e450119)
✅ Tests
  • Add catchall path to route generation test (71c359516)
  • Update windows snapshot (4ec274ae2)
  • Update jest snapshots to remove escaped quotes (f93411c7c)
🤖 CI
❤️ Contributors

v2.16.3

Compare Source

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

v2.16.2

Compare Source

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

v2.16.1

Compare Source

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
  • Tag 2.x releases appropriately (aba93e9)
  • Revert node types to v16 (3d034a3)
  • Remove stub type definitions (daed62a)
❤️ Contributors

v2.16.0

Compare Source

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 MR 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 https://github.com/nuxt/nuxt/pull/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

v2.15.8

Compare Source

🐛 Bug Fixes
  • vue-app
    • #​9460 Don't normalise route path if it's valid
  • babel
    • #​9631 Loose option for babel private-property-in-object

v2.15.7

Compare Source

🔰 Security advisory

Please upgrade to nuxt@^2.15.7 if using nuxt@2.15.5 or nuxt@2.15.6

🐛 Bug Fixes
  • vue-app
    • #​9431 Check whether a route exists within the nuxt app before replacing

v2.15.6

Compare Source

🐛 Bug Fixes

v2.15.5

Compare Source

🐛 Bug Fixes
  • babel
    • #​9232 Loose option for babel class-properties and private-methods (resolves #​9224)
  • vue-app
    • #​9201 Use route.replace instead of router.push to trigger navigation guards (resolves #​9111)
  • builder
  • cli
💖 Thanks to

v2.15.4

Compare Source

🐛 Bug Fixes
👕 Types
💖 Thanks to

v2.15.3

Compare Source

🐛 Bug Fixes
  • types
    • #​8953 Export interface for NuxtConfig instead of type
  • webpack
    • #​8951 Update hmr option for extract-css-chunks-webpack-plugin
  • general
    • #​8936 Allow force overriding resolve paths
    • #​8935 Allow relative public paths
    • #​8887 Update @babel/preset-env to 2.13.x
  • vue-renderer
    • #​8912 Respect injectScripts for static target
💖 Thanks to

v2.15.2

Compare Source

🐛 Bug Fixes
💖 Thanks to

v2.15.1

Compare Source

🐛 Bug Fixes
  • renderer
    • Deep merge runtime config for server (resolves #​8820)
  • webpack
  • cli
    • #​8841 Don't early return when a dependency isn't installed
  • types
    • #​8835 build.html.minify can be false
  • builder
    • #​8832 Use path.resolve for pages dir
💖 Thanks to

v2.15.0

Compare Source

💡 Highlights

⚠️This release introduces behavior changes. Update with caution ⚠️

or

npm i --save-dev css-loader@^5.0.0 postcss@^8.1.10 postcss-import@^13.0.0 postcss-loader@^4.1.0 postcss-url@^10.1.1
```
  • Several encoding issues resolved by consistently using ufo
  • Components updated to v2 (please read migration guide)
  • [Modules] When matching a webpack loader by name or query, should use includes instead of exact match (example)
🐛 Bug Fixes
  • general
    • #​8794 Ignore trailing slash in static payloads manifest
    • #​8738 Encoding issues with payload paths
    • #​8423 trailingSlash and child routes not working
  • config
    • #​8778 Prevent invalid css filenames in webpack output
  • utils
    • #​8780 serializeFunction fails with certain functions
  • vue-app
    • #​8759 Enable dynamic publicPath on server-side
    • #​8701 Static payload fetching bugfixes
    • #​8612 Check for Page.options before looking within
    • #​8611 Don't remove req, res and query from context unless in full static mode
    • #​8608 Ensure link.__prefetch exists before calling it
    • #​8596 Add missing id attribute to noopApp
    • #​8557 Scroll-to-top on route changes only
    • #​8523 Set push on router instance rather than prototype
    • #​8486 Do not preserve state when registering client-side dynamic module
    • #​8802 Add leading slash for payload hydration
  • server, vue-app
    • #​8748 Address encoding issues with query params
  • dev
    • #​8697 Clearnup vue installed plugins from server in dev mode
    • #​8556 Resolve module required by create-require in jiti
  • cli
    • #​8683 Disable parallel build behaviour when generating
  • webpack
    • #​8555 Can't resolve absolute url in css
  • server
    • #​8593 Fix HMR issue with serverMiddleware when router.base is set
  • babel
    • #​8545 Enable polyfilling of proposal core-js features
  • vue-app, vue-renderer, utils
    • #​8489 Respect trailingSlash setting for payloads
  • generator
    • #​8474 Ensure static manifest dir exists
    • #​8803 Normalize trailing slashes before extendRoutes
🚀 Features
  • cli
    • #​8792 Warn if incompatible node and package versions detected
  • postcss
    • #​8546 Support postcss v8 with explict postcss installation
  • config, vue-app, vue-renderer
    • #​8520 Support dynamic base and publicPath
  • general
    • #​8389 Support plug-and-play, typescript runtime and native modules
    • #​8346 Update all dependencies that require node 10.x
  • vue-app
    • #​8466 Support custom fetchKey for full static generation
  • vue-renderer
    • #​8347 Allow adding async attribute to <script> tags
💅 Refactors
  • utils, vue-app
    • #​8765 Use ufo to parse queries and join urls
  • vue-app
    • #​8621 Simplify scrollToTop checking
  • general
    • Consistent behavior for resolveModule
🏡 Chore
🇹 Types
  • #​8784 Add missing ssr option to config types
  • #​8767 vue.config types should be optional
  • #​8530 Add missing redirect overload to Context interface
  • #​8638 Add enablePreview to context
  • #​8648 Add missing loadingScreen type definition
💖 Thanks to

And all nuxters helping everyday with valuable feedbacks 💚

v2.14.12

Compare Source

🐛 Hot Fixes

How to upgrade?

Use yarn upgrade nuxt or npm up nuxt

v2.14.11

Compare Source

🐛 Hot Fixes

v2.14.10

Compare Source

🐛 Hot Fixes

v2.14.9

Compare Source

🐛 Hot Fixes
  • #​8421 Only encode non dynamic path params

v2.14.8

Compare Source

🐛 Bug Fixes
  • webpack
    • #​8205 Allow transpiling packages in nested node_modules
  • general
    • #​8325 Handle route encodings and update vue-router
  • vue-router
    • #​8394 Force chidren to be required if default child is present (resolves #​7823)
  • cli
    • #​8398 Respect router.trailingSlash when serving static files (resolves #​8350)
    • #​8337 Handle generate.cache.ignore as a function in ensureBuild
  • generator
  • csp
  • vue-app
    • #​8314 Handle missing payloads on full static (resolves #​7717)
    • #​8348 Warn if promises and functions are in fetch state (resolves #​8338)
    • #​8225 TriggerScroll when transitions is disabled
    • #​8289 Use nuxt globalName correctly in nuxt-link and fetch mixin (resolves #​8118)
    • #​8280 Prevent redirection loop with URI-encoded path (resolves #​8116)
  • types
    • #​8362 Correct vue.config types
    • #​8349 Add missing isFetching and nbFetching to NuxtApp interface
    • #​8319 NuxtOptionsHead can be a function
    • #​8302 Add missing ssrContext and next typings to Context (resolves #​8296)
  • server
    • #​8313 Redirect if router.base specified in development
💅 Refactors
👓 Tests
💖 Thanks to

v2.14.7

Compare Source

🐛 Bug Fixes
  • babel-preset-app
    • #​8203 Always transpile optional chaining and nullish-coalescing for server
  • cli
    • #​8200 Rebuild if process.env changes in nuxt.config
    • #​8194 Avoid error about nuxt-edge if installed in parent node_modules
    • #​8134 Mode deprecation with explicit spa or universal flag
  • vue-app
    • #​8170 Use getter to provide this.$nuxt
    • #​8055 ScrollRestoration hasn't set
  • types
    • #​8182 Add type for serverMiddleware object format
    • #​8169 Make NuxtConfig an interface
  • generator
    • #​8166 Handle when no routes.json defined
  • general
    • #​8206 Add better logs for DX with target option
💖 Thanks to

v2.14.6

Compare Source

🐛 Bug Fixes
💖 Thanks to

v2.14.5

Compare Source

🐛 Bug Fixes
💅 Refactors
🇹 Types
💖 Thanks to

v2.14.4

Compare Source

🐛 Bug Fixes
  • vue-renderer
  • cjs
    • #​7938 Fix HMR issue with mongoose (resolves #​7917)
    • #​7966 Protect clearRequireCache against infinite recursion
  • cli
    • #​7948 Handle nuxt generate with --fail-on-error for static target (resolves #​7947)
  • vue-app
  • webpack
🏡 Chore
💖 Thanks to

v2.14.3

Compare Source

🐛 Bug Fixes
  • vue-renderer
    • #​7928 Apply nomodule to legacy chunks
💖 Thanks to

v2.14.2

Compare Source

🐛 Bug Fixes
  • webpack
  • modern
  • vue-app
    • #​7877 Use anchor to / if route is undefined in error page (resolves #​7841)
    • #​7920 Fix vue-router@2.14 regression with scrollToTop
    • #​7916 Prevent router.registerModule reallocation (resolves #​7915)
  • router
    • #​7912 Use updated error codes to fix redirect errors
  • cli
    • #​7860 Improve project dir detection for external commands
👕 Types
  • general
    • #​7902 Improve definitions for component transition property
💖 Thanks to

v2.14.1

Compare Source

🐛 Bug Fixes
📝 Examples
  • tailwindcss-purgecss
    • #​7800 Update tailwindcss from 0.6 to 1.6 using purgecss
🏡 Chore
💖 Thanks to

v2.14.0

Compare Source

⭐ Highlights
🚀 Features
  • webpack
  • builder
  • general
  • vue-renderer
    • #​7633 Add vue-renderer:spa:prepareContext hook
  • vue-app
    • #​7611 Add web-types.json for better code insight in WebStorm
🐛 Bug Fixes
  • webpack
    • #​7787 ensure loaders are first searched from @nuxt/webpack
    • #​7763 font-family hex issue
    • #​7667 Fallback for empty chunk name
  • vue-app
    • #​7766 nuxt-link prefetch error on fallback page
    • #​7718 Handle fallback on generated page
    • #​7723 Don't fetch payload for store mutation for preview and spa fallback
  • generator
    • #​7776 Avoid duplicate slashes for routes ending with hash
  • cli
    • #​7775 Don't use absolute path of .cache/nuxt as transpilation pattern
  • utils
    • #​7761 Include routes with children for generation
  • vue-renderer
    • #​7752 Read target from class instead of serverContext
  • router
    • #​6594 Show default child if trailingSlash is false
🖤 Refactors
  • server
    • 5272a4 Rename externalsWhitelist to externalsAllowlist
📝 Examples
  • vuetify
👕 Types
  • general
    • #​7670 Fix module options type
    • #​7709 Add cross-origin property to NuxtOptionsRender
    • #​7670 Fix module options type
💖 Thanks to

v2.13.3

Compare Source

🐛 Bug Fixes
💅 Refactors
  • csp
    • #​7659 Remove unsafe-eval in dev mode
📝 Examples
  • with-sockets
    • #​7650 Deprecated callback and use cjs
  • with-vuetify
    • #​7638 Use v-main instead of v-content
👕 Types
  • general
    • #​7626 Import types for @nuxt/telemetry and @nuxt/components
💖 Thanks to

v2.13.2

Compare Source

🐛 Bug Fixes
  • webpack
  • core
  • cli
  • vue-app
  • utils
    • #​7604 Flat routes if child routes have absolute paths
Dependencies
💖 Thanks to

v2.13.1

Compare Source

🐛 Bug Fixes
👕 Types

v2.13.0

Compare Source

What's new?
  • New target: static and full static using nuxt export
  • Built-in .env support and runtimeConfig
  • Auto components discovery with nuxt/components
  • Nuxt Telemetry

Also don't miss nuxt/content and nuxt-composition-api ;)

🚀 Features
🐛 Bug Fixes
  • core
    • #​7267 Improve module not found error
    • #​7131 Join with os native sep in resolver
  • general
  • webpack
    • #​7462, #​7464 Reduce false negatives in nodeExternals
    • #​7318 Allow HMR client path to be set
    • #​7305 Use non-eval sourcemap with csp and unsafe-eval script policy
  • vue-app
    • #​5703, #​7442 Prevent double layout execution
    • redirect no longer strips trailing slash from URL (#​7475, #​7533)
    • #​7162 Allow background customization for default loading template
    • #​7271 sanitizeComponent import regression with features disabled
    • #​7139 Sanitize layouts after resolve for splitChunks.layout
  • generator
    • #​7335 Improve error handling when build does not exists
  • modern
    • #​7498 Modulepreload not work in generate
    • #​7382 Wrong assets mapping in ssr client modern mode
  • vue-renderer
    • #​7439 Fix meta injection when ssr renderer generates a spa page
    • #​7376 Base tag should be before any link or script tag
  • generator, builder
    • #​7361 Empty build and dist directories instead of remove
  • babel
    • #​7297 Not override presets if babelrc is true
  • server
    • #​7146 HMR for sub-app serverMiddleware without path
💅 Refactors
  • general
  • config
    • #​7187 Move build.crossorigin to render.crossorigin
📝 Examples
  • with-buefy
🏡 Chore
  • cli
  • general
  • renovate
    • Ignore @types/terser-webpack-plugin
  • pkg
    • #​7373 Update rollup and dependencies
  • dep
    • #​7119 Upgrade html-webpack-plugin to v4
  • test
  • benchmark
  • example
👓 Tests
💙 Types

  • general

    • #​7432 Move @nuxt/types to nuxt mono-repo
💖 Thanks to

v2.12.2

Compare Source

🐛 Bug Fixes
  • server
    • #​7146 HMR for sub-app serverMiddleware without path
  • vue-app
    • #​7139 Sanitize layouts after resolve for splitChunks.layout
  • core
    • #​7131 Join with os native sep in the resolver

v2.12.1

Compare Source

🐛 Bug Fixes
  • vue-app
    • #​7129 Avoid multiple $fetch calls
    • #​7103 Use globals.nuxt for fetch client mixin
    • #​7128 Set default name to layout to avoid multi mounted calls
  • builder
    • #​7097 Ensure entry is in the graph for HMR
🏡 Chore
  • readme
    • #​7092 Simplify readme and add gitpod in contributing section
  • examples
    • #​7098 Avoid warning with legacy postcss.config.js
💖 Thanks to

v2.12.0

Compare Source

🚀 Features
  • general
    • #​6950 Support crossorigin attribute in SSR script and preload tags
    • #​6868 Improve programmatic usage (see docs)
    • #​7029 Expose webpack config
    • #​6272 Allow disabling loading-screen
  • webpack
    • #​6987 Support @import using ~assets in css files
    • #​6272 Allow disabling loading-screen
  • vue-app
    • #​6880 New fetch syntax (see docs)
    • #​6939 Pass error as param to nuxt-loading fail method
    • #​6244 Trigger watchParam when param is changed in same route
  • cli
    • #​6855 Pass context when nuxt.config exports a function
👌 DX
  • builder
    • #​6924 Analyze mode warning rewording
  • general
  • generator
    • #​6882 Log message or full error for unhandled error without stack trace
  • cli
    • #​6904 Display listening URLs after build
  • vue-app
    • #​7032 Improve missing inject value error message
    • #​6775 Middleware not executing on double browser back navigation
  • core
    • #​7079 Better module not found handling
🔥 Performance
  • vue-renderer
    • #​6973 Early return render when redirect happens
    • #​6846 Don't serialize session when injectScripts is false
🐛 Bug Fixes
  • core
    • #​7002 Deprecated render:context and render:routeContext hooks was not being called
  • babel-preset-app
    • #​7070 TypeError when import cjs in webpack building
  • vue-app
    • #​6946 Use child transition name when navigating to parent
    • #​6854 Add fallback context for errors
    • #​6803 Resolve leave transition on child routes
    • #​6807 Move head to the index to avoid global state
  • webpack
    • #​6864 Provide global URL and URLSearchParams
💅 Refactors
  • general
    • #​6954 Use scope variable memo for modern utils
  • utils
    • #​6953 Eliminate side effect from modern utils
📝 Examples
  • cached-components
🏡 Chore
  • general
    • #​6816 Simplifies Code Contributions & Reviews
  • ci
👓 Tests
  • general
    • Fix socket-hang-up test
    • Separate dev and unit test
    • Avoid unexpected outside stderr assertion count
    • Fix uncompressed resource size
    • Wrap error test with consola to make output clear
💖 Thanks to

v2.11.0

Compare Source

🐛 Bug Fixes
  • utils
    • #​6777 Add catch statement to non function block in serializeFunction
    • #​6791 Fix flatRoutes regex for nested routes with trailing slash enabled
  • vue-app
    • #​6658 Pass router mode to getLocation
    • #​6683 Apply path-to-regexp options to tokensToFunction
    • #​6650 Layout in error.vue not work for Vue.extend component
    • #​6623 Add prefetched class to <nuxt-link> after chunk loaded
  • general
    • #​6685 context.route issue in plugins and splitChunks.pages === false
    • #​6590 Collapsed SSR log
  • webpack
    • #​6495 Enable devtool for dev mode
    • #​6566 Normalize devtool for terser compatibility
  • config
    • #​6583 Typo in unsafeInlineCompatibility name
🚀 Features
  • vue-app
  • general
    • #​6149 Optionally strip non-client or non-server code
  • vue-renderer
    • #​6505 Support evaluation in templates
  • config
    • #​6597 Add ignoreOptions for node-ignore
💅 Refactors
  • server
    • #​6771 Only append not empty allowed sources to csp
🔥 Performance
  • webpack
📝 Examples
  • with-sockets
    • #​6586 Fix cannot read property 'app' of undefined on nuxt build
🏡 Chore
  • general
    • #​6732 Update @nuxtjs/eslint-config to v2 and fix lint errors
    • #​6686 Fix typo in middleware readme
    • #​6649 Limit stale bot to only issues
    • #​6637 Remove unused dependencies
    • #​6630 Use .github/config.yml for issue template
  • docs
  • ci
    • #​6739 Remove coverage collection in fixtures
    • #​6747 Use LTS Node.js instead of latest
    • #​6737 Separate dev test and unit test
  • github
    • #​6657 Add chinese translation for issue template
👓 Tests
💖 Thanks to

v2.10.2

Compare Source

🐛 Bug Fixes
  • webpack
    • #​6495 Enable devtool for dev mode
    • #​6566 Normalize devtool for terser compatibility
  • config
    • #​6583 Typo in unsafeInlineCompatibility name
  • vue-app
📝 Examples
  • with-sockets
    • #​6586 Fix cannot read property 'app' of undefined on nuxt build
💖 Thanks to

v2.10.1

Compare Source

🐞 Fixes
  • vue-app, webpack
  • utils
    • #​6515 Fix error when router.trailingSlash is false
  • generator
    • #​6362 Remove trailing slash when no subFolders are used
  • webpack
    • #​6520 chunkhash and contenthash not work with extractCSS
  • cli
    • #​6525 Enable server for nuxt build when pages should be generated
🏡 Chore
  • readme
    • #​6511 Remove deprecated starter template
⚓ Dependency Upgrades
  • vue-meta: Upgraded to v2.3 which fixes duplicated tags in SPA mode
💖 Thanks to

v2.10.0

Compare Source

🌟Highlights
  • Support for improved typescript runtime
  • Experimental support for feature toggling for SUPER slim builds!
  • Mitigate problems with nuxt server stocking during development
  • Fix issues with internet-explorer in development mode
  • Upgrade to terser webpack plugin v2
  • Improved stability of loading-screen. No more endless loops (nuxt/loading-screen#​44) and show fatal errors (nuxt/loading-screen#​45) for the initial build
🐛 Bug Fixes
  • core
    • #​6490 Clear resolver cache for project files dev mode
  • vue-app
    • #​6479 Error page layout not correctly applied in client-side rendering
    • #​6473 Pass vm as arg to support data() with arrow function
    • #​6433 Fix asyncData hydration when features.transition is false
    • #​6430 Clear idle callback
    • #​6217 Prevent looping on error during render of error page
  • webpack
    • #​6298 Fix consola IE compatibility
    • Revert pause/resume
    • #​6460 Correct sass options for sass-loader@8
    • #​6448 Don't push to compilersWatching in callback
  • cli
    • #​6441 Server should not be initialized in nuxt build
  • babel-preset-app
    • #​6435 Use loose mode for babel class plugin
  • vue-renderer
  • config
    • #​6371 Enable total timing by default when server.timing is enabled
  • config, vue-app
    • #​6379 Add module declaration for config and vue-app
🚀 Features
  • cli, config
  • config
    • #​6414 serverMiddleware as a simple key/value object
  • builder
    • #​6368 followSymlinks option to allow for symlinks
    • #​6285 extendPlugins option and builder:extendPlugins hook
    • #​6329 Add builder:prepared hook
    • #​6342 Support adding custom middleware
  • cli
    • #​6475 Catch build errors with cli:buildError hook
  • webpack
    • #​6477 Use vue-meta browser build for client bundle
    • #​6398 Upgrade terser-webpack-plugin to v2
    • #​6350 Add webpack:config hook
  • server
    • #​6438 Add config option to define etag hash function
  • vue-app
  • general
    • #​6432 Support setting (non-essential) vue-meta options by user
  • utils
  • builder, router
    • #​6331 Enforce uniform trailing slash handling
💅 Refactors
  • cli
    • #​6353 Call setup hook in run command with more args
  • builder
    • #​6352 Await build.createRoutes to allow async functions inside it
  • babel-preset-app
📝 Examples
  • with-sockets
    • #​6396 Create server inside the export function
🏡 Chore
  • general
    • Fix example in babel-preset-app readme
    • #​6390 Lint vue-app templates
    • #​6363 Rename setup hook to run:before
💖 Thanks to

v2.9.2

Compare Source

🐛 Bug Fixes
  • general
    • #​6257 Improve watching experience for generated files
  • builder
    • #​6283 fix(builder): apply overrides from app dir only
  • server
    • #​6265 Treat https: null as https: undefined
  • nuxt-start
    • #​6267 Add missing vue-client-only dependency
  • vue-app
    • #​6264 Only overwrite leave listener when none provided or without done arg
    • #​6255 Enforce default css when used with frameworks
  • config
    • #​6258 Provide typescript backward compatibility
💅 Refactors

v2.9.1

Compare Source

🐛 Bug Fixes
📝 Examples
  • CoffeeScript
    • #​6248 Update module for using additionalExtensions
💖 Thanks to

v2.9.0

Compare Source

⚠️ Important Notes
  • 👉 Minimum required node version is 8.9.0
  • 👉 Typescript support is now externalized. Refer to official docs and migration guide.
  • 👉 vue-meta upgraded to 2.0.0. Please refer to the changelog to review notable changes.
  • 👉 scrollBehavior option is deprecated in favor of app/router.scrollBehavior.js (#​6055)
  • 👉 devModules option is deprecated in favor of buildModules (#​6203)
🐛 Bug Fixes
  • general
    • #​6118 Fix modulepreload warnings
    • #​6075 Throw error when building failed in quiet mode
    • #​6070 Support babel corejs config for modern mode
    • #​6021 Babel polyfill can not be disabled
  • renderer
    • #​6033 Correctly load nomodule scripts in safari 10
  • cli
    • #​6020 Prevent both nuxt & nuxt-edge being installed
  • vue-app
    • #​6012 Emit triggerScroll to support hash navigation
    • #​5920 Fix font-size and make width bigger
    • #​5891 Always finish transition.leave asynchronously
    • #​5890 Fix position of the build indicator when page scrolled
  • vue-renderer
    • #​6223 Call render:resourcesLoaded hook before createRenderer
    • #​5964 Clone SPA meta to prevent cache modification
  • webpack
    • #​5906 Extract css breaks hmr and source-maps
🚀 Features
  • cli
  • server
    • #​6178 Allow passing loadingTimeout and other arguments to renderAndGetWindow
  • webpack
    • #​6120 Allow function entries for build.transpile
  • vue-app
    • #​6194 Add $nuxt.refresh
    • #​6186 Use EventSource instead of WebSocket for build indicator
    • #​6055 Support app/router.scrollBehavior.js and deprecate scrollBehavior
    • #​5941 Add <client-only> alias for <no-ssr>
    • #​5844 Allow customizing loading indicator
    • #​6194 Add $nuxt.refresh() method or refresh the actual page asyncData and fetch
    • #​6231 Export router options
    • #​6222 Support functional watchQuery
  • vue-renderer
    • #​5975 Add csp option for csp v1 compatibility
    • #​6134 Support prepend/append body tags during ssr for all allowed tag types
  • typescript
    • #​5858 Externalize typescript support
💅 Refactors
🏡 Chore
⚓ Dependency Upgrades
  • file-loader@4
  • url-loader@2
  • cache-loader@4
  • css-loader@3
  • vue-meta@2
  • fs-extra@8
💖 Thanks to

v2.8.1

Compare Source

🐛 Bug Fixes
  • vue-renderer
    • #​5867 Fix exception on property access of undefined object
    • #​5863 Prevent "can't set headers after they are sent" error in modern server mode
  • vue-app
    • #​5864 Reduce consola direct access and don't override browser console.log
  • cli
    • #​5865 Don't mutate options export to prevent ESM regression with nuxt.config in mixed (cjs + esm) mode (TIP: never mix them as is non-standard and may be unsupported in any future version)
💅 Refactors
  • typescript
    • #​5854 Prepare for external typescript support
💖 Thanks to

v2.8.0

Compare Source

😎 Developer Experience
  • #​5770 Add a group for SSR logs to avoid polluting the browser console
  • #​5810 Fancier browser logs with consola

nuxt-ssr-logs-2

nuxt-hmr-indicator

  • #​5753 Watch for pages/ creation when default page displayed
  • #​5812 Only listen for file changes for supported extensions
  • #​5753 Re-use the same port when randomly assigned when restarting in dev mode
🐛 Bug Fixes
  • vue-renderer
    • #​5807 Add User-Agent‍ to Vary header in modern server mode
    • #​5764 Safe format SSR logs
  • server
    • #​5793 Preserve random port when restarting
    • Return listener when calling listen
  • builder
    • #​5753 Watch for pages/ creation when default page displayed
    • #​2812 Only listen for file changes for supported extensions
  • generator
  • types
    • #​5785 Add type definition for functional babel.presets
  • vue-app
    • #​5757 Reuse page component with watchQuery
    • #​5746 Remove trailing slash in vue-router non-strict mode
    • #​5752 Don't attach catch handler to already loaded component
    • #​5824 fixPrepatch in-out transition fix (issue #​5797)
  • utils
    • #​5754 Handle serializeFunction edge case
🚀 Features
  • vue-renderer
    • #​5745 Add render.injectScripts option
    • #​5784 Support render.ssrLog for controlling SSR logs
💅 Refactors
  • core
    • #​5796 Use require.resolve instead of Module internals
  • builder
    • #​5792 Pass nuxt options to template as nuxtOptions
  • vue-app
  • general
    • #​5748 Small readability improvements
📝 Examples
  • auth-jwt
    • #​5775 Use named store export to prevent warning
  • typescript
    • #​5742 Add missing ts-node dependency
🏡 Chore
  • ci
    • #​5802 Upload test report to CircleCI and Azure
    • Add flags for codecov
    • Enable audit
  • general
    • Remove unused dependency cross-env
    • Add FUNDING.md
    • Improve links in readme
♻️ Tests
  • general
    • #​5790 Add unit tests for core/resolver.js
    • #​5782 Remove duplicate unit tests in packages/core/test/resolver
⚓ Dependency upgrades
💖 Thanks to

v2.7.1

Compare Source

Fixes

  • builder: use warn only for mismatched dependencies (#​5723)
  • webpack: correctly resolve consola for the client bundle (#​5729)

Dependency Upgrades

Thanks to

v2.7.0

Compare Source

DX Improvements 💅

SSR logs in your browser 🖥️

We all know the console.log debugging method, but when working with universal applications, you have to remember that sometimes, your logs are in your terminal and not in your browser console.

This can be really annoying when developing a Nuxt.js application, starting with this version and running nuxt dev, the ssr logs are now reported to your browser console:

nuxt-logs-ssr

Detecting store/ creation 👀

Nuxt.js now detects when you created a store/ directory and will reload himself auto-magically so you don't have to restart it anymore.

nuxt-store-watch

PS: We also improved the serverMiddleware watch to restart Nuxt.js and clean their cache

Fixes ✔️

  • builder: corretly detect mode of hashed plugins (#​5695)
  • builder: call watch:restart after watch:fileChanged hook (#​5620)
  • utils: node v8 not support dotAll in regex (#​5608)
  • vue-app: properly catch component loading error (#​5687) (#​5688) (#​5690)
  • vue-app: consider watchQuery option in routerViewKey (#​5516)
  • vue-renderer: await on spa:templateParams hook (#​5619)
  • webpack: set log level to warn for HardSourcePlugin (#​5653)
  • vue-app: properly catch loading error in component prefetching (#​5688) (#​5690)
  • vue-app: avoid using aliases in templates (#​5656)
  • builder: watch store dir and serverMiddleware paths (#​5681)

Features 🚀

  • vue-app: rename transition to pageTransition and deprecate it (#​5558)
  • vue-renderer/vue-app: report SSR console logs to the browser with consola (#​5673)
  • webpack: suppress not found typescript warnings (#​5635)
  • webpack: extendable babel.presets and babel envName (#​5637)
  • configurable aliases (#​5655)

Refactors 🧹

  • server: exclude dist files request from browser detection (#​5571)
  • vue-renderer: remove chalk in renderer (#​5609)
  • vue-renderer: split renderer into ssr, spa and modern (#​5559)
  • move modern detection from server to utils (#​5584)

Examples 📚

  • auth-routes: fix typo (#​5651)
  • babel-preset-app: add core-js@3 example in the readme (#​5633)
  • docker: fix Dockerfile casing (#​5705)

Typescript 👷

Only for typescript users, Nuxt.js v2.7 dropped support for node < 8.6 relate to ts-loader v6

Thanks to 🙏

v2.6.3

Compare Source

Fixes

  • cli: Watch and reload nuxt.config (#​5574)
  • utils: serialize inline functions (#​5051) (#​5580)
  • vue-app: Fix context req and res types (#​5560)
  • webpack: Fix production font preloading (#​5436)
  • Don't customize esm options (91c3642)

Dependency Upgrades

  • Update webpackbar to ^3.2.0
  • Update vue-router to ^3.0.6
  • Update @nuxt/loading-screen to ^0.5.0

v2.6.2

Compare Source

Fixes

  • cli: Apply nuxt.config.js changes and watch for all imported files (#​5500)
  • cli: Fix problem for users that have tsconfig.json but do not use typescript (#​5478)
  • cli: Show memory usage after build for nuxt dev (#​5514)
  • server Fix bug with SPA mode with CSP enabled (#​5474)
  • vue-renderer: Use modulepreload for modern mode when using spa generate (#​5489)
  • webpack: Suggest using official @nuxtjs/style-resources package (#​5499)
  • Custom router.base support for banner url and loading screen (#​5470) (nuxt/loading-screen#​8)

Security Fixes

Thanks to our awesome contributors to this release

v2.6.1

Compare Source

v2.6.0

Compare Source

Migration Guide

This version is addressing most of the problems of 2.5 and is without any breaking changes. For most of the users, a normal version upgrade would be enough. However, reading this guide can help to have a smooth upgrade.

General Tips

  • Using yarn as the package manager is more preferred as Nuxt is internally being tested against yarn
  • Before upgrade ensure to remove yarn.lock, package-lock.json and node_modules
  • After full install and testing, also consider upgrading other dependencies. The yarn outdated command can be used.
Missing App Dependencies

Because of how package managers (yarn, npm) work, a wrong version of a dependency from one of the other dependencies may be hoisted into node_modules. Nuxt is strict about this and provides instructions for dependency resolution so please follow it.

The well-known problem is with firebase package that requires to manually install node-fetch dependency in your project.

Reverting breaking changes

We accidentially introduced a change that broke the prod build for many people who are using Nuxt programatically. This has been resolved through #​5413. Sorry for the inconveniences!

Core-js

Since core-js@2 and core-js@3 are both supported from babel 7.4.0, Starting from 2.6 Nuxt supports both versions (#​5411). It is highly advised to stick with 2 (default) unless having a special dependency that needs 3. (Instructions for core-js@2 are not required but recommended)

core-js@2
  • yarn: yarn add -D core-js@2 @&#8203;babel/runtime-corejs2
  • npm: npm i -D core-js@2 @&#8203;babel/runtime-corejs2
core-js@3
  • yarn: yarn add -D core-js@3 @&#8203;babel/runtime-corejs3
  • npm: npm i -D core-js@3 @&#8203;babel/runtime-corejs3

Edit nuxt.config.js:

export default {
  build: {
    babel: {
      presets({ isServer }) {
        return [
          [
            require.resolve('@&#8203;nuxt/babel-preset-app'),
            // require.resolve('@&#8203;nuxt/babel-preset-app-edge'), // For nuxt-edge users
            {
              buildTarget: isServer ? 'server' : 'client',
              corejs: { version: 3 }
            }
          ]
        ]
      }
    }
  }
}
Typescript

Nuxt 2.5 users may only require to add ts-node to the dependencies

Beta Testers : Replace nuxt by nuxt-edge, and @nuxt/typescript by @nuxt/typescript-edge in the following instructions.

  1. Remove nuxt-ts dependency (2.4 users only)
    • yarn: yarn remove nuxt-ts
    • npm: npm remove nuxt-ts
  2. Add nuxt and ts-node to dependencies:
    • yarn: yarn add nuxt ts-node
    • npm: npm i nuxt ts-node
  3. Add @nuxt/typescript to devDependencies:
    • yarn: yarn add -D @&#8203;nuxt/typescript
    • npm: npm i -D @&#8203;nuxt/typescript
  4. Create an empty tsconfig.json file. Nuxt will automatically generate it with defaults at first run, then you can edit it to fit your needs

Features

  • feat(babel-preset-app): support specifying core-js version (#​5411) (Xin Du (Clark)) (159123f)
  • feat(cli): add internal _generate and _build options (#​5434) (Pooya Parsa) (516aea3)
  • feat(cli): add --quiet option to nuxt generate command (#​5357) (Franck Abgrall) (91f4eb0)
  • feat(typescript): detect typescript based on tsconfig.json (#​5412) (Pooya Parsa) (6ffc5c5)
  • feat(vue-renderer): add csp meta tags (#​5354) (James George) (b978a37)

Fixes

  • fix: unexpected token export in importing babel runtime helper (#​5401) (ryota yamamoto) (3b85dd9)
  • fix(core): call ready to prevent breaking changes (Pooya Parsa) (#​5413) (001ba77)
  • fix(build): disable loading babel.config.js by default (#​5365) (Xin Du (Clark)) (64fa424)
  • fix(builder): await for renderer to load resources (#​5341) (Pooya Parsa) (caf5198)
  • fix(cli): catch all possible errors thrown from proper-filelock (#​5347) (Pim) (39bbe46)
  • fix(renderer): retry render if renderer is in loading or created state (#​5417) (Pooya Parsa) (8b99695)
  • fix(vue-app): decode uri in getlocation (#​5337) (Johan Roxendal) (77dcfe6)
  • fix(vue-app): prevent mounting page twice on redirect (#​5361) (noe132) (2d73e8a)
  • fix(vue-renderer): add the csp hash if unsafe-inline hasn't been specified (#​5387) (Sam Bowler) (97db6a4)
  • fix(types): add type definition for typescript.typeCheck (#​5326) (Daniel Roe) (2c1444d)

Refactors

  • refactor(typescript): only generate tsconfig.json if missing (#​5356) (#​5367) (Kevin Marrec) (9a3fc8a)
  • refactor(vue-renderer): improve ready status error (#​5339) (Pooya Parsa) (535327c)
  • refactor(webpack): add ability to get webpack config class (#​5378) (Damian Stasik) (abf7db1)

Examples

Chore

Dependency Upgrades

v2.5.1

Compare Source

Bug Fixes

  • fix: revert to corejs@2 (#​5317) (Pooya Parsa) (20836d9)
  • fix: remove consola.debug for hooks (#​5318) (Thomas Reichling) (9ff01f9)
  • fix: apply default lock options before setting lock (#​5320) (Pim) (7c24280)
  • fix(ts): wrong export used in render.d.ts (#​5309) (Romain Lanz) (e67b298)
  • examples: upgrade and fix typescript configuration files (#​5310) (Romain Lanz) (7100a2c)
  • chore: unsupport nuxt-legacy (pooya parsa) (797a4ce)

v2.5.0

Compare Source

15,000 line changes with 230 squashed commits by more than 30 contributors made this version possible! ❤

What's new?

Typescript DX

No longer needed to install nuxt-ts for typescript support. Nuxt.js officially supports TS by installing @nuxt/typescript. Please see #​5079 for reasons behind such migration.

Babel

Babel 7.4, Core-js v3, and Object.assign polyfill for better browser support.

Stability

More than 30 fixes, refactors and performance improvements.

Open in Browser

Use nuxt dev -o to instantly open project in the browser and enjoy a cool loading screen:

nuxt-loading-screen

.nuxtignore

Before v2.5, you were able to ignore files through an ignore prefix. As using the prefix over and over, ignoring files (and implementing custom structures) was a bit tedious on the long run. We came up with something more sophisticated: A .nuxtignore file. Following the same specs as a .eslintignore or a .gitignore file, you can now define what files or folders to ignore through a .nuxtignore file in your project root.

Examples and more info in the .nuxtignore docs

[IMPORTANT] Migration Guide

Lock Files

For a clean upgrade, please remove yarn.lock / package-lock.json file from your project before upgrade.

Programmatic API / Middleware

If not already done, please explicitly call nuxt.ready() after new Nuxt(). nuxt.ready() was always async, but not awaiting the function call has now a severe impact.

   const nuxt = new Nuxt(config)
++ await nuxt.ready()
TypeScript
  1. Please replace nuxt-ts dependency and use nuxt + @nuxt/typescript. (Also nuxt-ts-edge to nuxt-edge + @nuxt/typescript-edge for edge users)
{
--  "nuxt-ts": "^2.4.2"
++  "@&#8203;nuxt/typescript": "^2.5.0"
++  "nuxt": "^2.5.0"
}
  1. Configuration API to customize/disable type checking has been moved from build.useForkTsChecker to build.typescript.typeCheck. Please see #​5079 for more details.
build: {
-- useForkTsChecker: false // or ForkTsChecker options
++ typescript : {
++   typeCheck: false // or ForkTsChecker options
++ }
}

Features

  • feat(babel): include es6.object.assign by default (Clark Du) (52fe145)
  • feat(cli): lock project during build or generate (#​4985) (Pim) (4e51723)
  • feat(cli): option to open the project in the browser (#​4930) (Ricardo Gobbo de Souza) (4c7bd9c)
  • feat(generate): return non-zero code or page error (fixes #​4991) (#​5195) (Jarek Lipski) (c6565c9)
  • feat(module): support src as a function in addModule (#​4956) (Ricardo Gobbo de Souza) (1e9eb4b)
  • feat: support .nuxtignore (#​4647) (Xin Du (Clark)) (59be77a)
  • feat: support devModules option (#​5102) (Jonas Galvez) (e87711c)
  • feat(ts): nuxt configuration typedefs (#​4854) (Kevin Marrec) (92f81e0)
  • feat(vue-app): universal fetch (#​5028) (Pooya Parsa) (2015140)
  • feat(vue-renderer): improvements (#​4722) (Pooya Parsa) (2929716)
  • feat(vue-renderer): use async fs (#​5186) (Pooya Parsa) (d07aefa)
  • feat(ts): better DX for typescript support (#​5079) (Kevin Marrec) (920f444)
  • feat: loading screen (#​5251) (Sébastien Chopin, Pooya Parsa) (ef41e20)
  • feat: support core-js 3 (#​5291) (Xin Du (Clark)) (d094c4a)

Fixes

  • fix(builder, vue-app): order of plugin execution based on order in array (#​5163) (Dmitry Molotkov) (a867dbd)
  • fix: correct public path in generation and start (#​5202) (Xin Du (Clark)) (648062c)
  • fix: default for-exit to false to prevent dev exit (pooya parsa) (a347ef9)
  • fix: disable "analyze" for nuxt generate (#​4975) (Alexander Lichter) (574a2eb)
  • fix: disable parallel build when extractCSS is enabled (Clark Du) (aad46ed)
  • fix: extra properties in templateFiles (#​4925) (Xin Du (Clark)) (ca19124)
  • fix: fix non standard esm modifications (pooya parsa) (fb87a55)
  • fix: generate failure (#​5007) (Andrey Shertsinger) (bcd672f)
  • fix: keep-alive component data should not be updated (#​5188) (Xin Du (Clark)) (1ea8661)
  • fix: not send Server-Timing header if no timing info (Clark Du) (d9a0b5f)
  • fix(postcss): default to preset-env and cssnano last (#​5215) (Alexander Lichter) (adf423a)
  • fix: publicPath is not reactive in dev restarting (#​5227) (Xin Du (Clark)) (1fb7538)
  • fix: refactor file watchers (chokidar/linux workaround) (#​4950) (Pim) (5ec5932)
  • fix: remove cache-loader for external resources (#​4915) (Xin Du (Clark)) (0223e56)
  • fix: respect namespaced in store module (#​5189) (Xin Du (Clark)) (9e1ef88)
  • fix: revert templatFiles name (#​4924) (Xin Du (Clark)) (f70645e)
  • fix: trailing comma in tsconfig (#​5061) (Sergey Vikulov) (1fb44d9)
  • fix(ts): deprecate isClient, isServer, isStatic (#​5211) (Daniel Hritzkiv) (29c3c42)
  • fix(types): reflect chainlable NuxtLoading methods (#​5104) (Matjaž Lipuš) (66273f4)
  • fix: Unexpected token .... Expected a property name in Safari (Clark Du) (eef7f69)
  • fix(vua-app): clone mount error to prevent mutating read-only error object (#​5214) (Alexander Lichter) (37006f6)
  • fix(vue-app): avoid css chunk error (#​5173) (Yutaka Sasaki) (41028a4)
  • fix(webpack): clone config.entry (fixes #​4849) (#​5236) (Julien Dargelos) (8216765)
  • fix: disable extract-css-chunks-webpack-plugin in dev mode (#​4888) (Xin Du (Clark)) (928a230)
  • fix(server): handle decodeURI error (#​5243) (phof) (5b7f6d7)
  • fix: correct socket address in use error message (Clark Du) (2eb1965)
  • fix(utils): relax lock settings (#​5280) (Pim) (65a431d)
  • fix(vue-app): multiple named views cause invalid syntax (#​5262) (Michael Leaney) (d03a61b)
  • fix(webpack): loaders in extend config is broken (#​5292) (Xin Du (Clark)) (0eb5ed9)
  • fix(vue-app): duplicated router.base when using context.redirect(object) (#​5290) (Nianyong) (cf02e82)
  • fix(vue-app): decode router base to support unicode characters (#​5297) (Alexander Lichter) (3ac01df)

Performance Improvements

  • perf: await routeData promises in parallel (#​5027) (Alexander Lichter) (0826d7e)
  • perf(core): skip esm for node_modules and non .js files (#​5220) (Pooya Parsa) (aabb1f6)
  • perf(webpack): use futureEmitAssets (#​5003) (Alexander Lichter) (3997d50)
  • perf(ts): transpileOnly when using nuxt-ts start (#​4906) (Kevin Marrec) (17cc12f)

Examples

  • examples(jest-puppeteer): fix package .json (#​4997) (Andrew Cravenho) (dfc8dd5)
  • examples: improve vuex store example (#​5017) (Alexander Lichter) (a9511e5)
  • examples(pug): fix example by adding plain-pug-loader (#​5223) (Paul Geisler) (320a46f)
  • examples(vuex-store): change to module store (#​4923) (Alexander Lichter) (be41ae1)
  • examples: add pug-stylus-coffee (#​4927) (chiboreache) (6d05969)
  • examples: add tsx example (#​4855) (andoshin11) (5101dc6)
  • examples: fix jest test dependencies (#​5155) (Dmitry Molotkov) (1c3761a)
  • examples: fix links to vue-meta repo (#​5018) (Pim) (06f4762)
  • examples: rebase on latest stable nuxt version (#​4874) (Alexander Lichter) (47898fb)
  • examples: zero-downtime pm2 typescript example (#​4907) (Dmytro) (1fb9af3)
  • examples: fix dynamic components example (#​5294) (Dmitry Molotkov) (d9db45c)

Refactors

  • refactor: generate routes and template files in builder (#​4883) (Xin Du (Clark)) (4c5a59e)
  • refactor: improve modern middleware and spa modern rendering (#​5037) (Xin Du (Clark)) (05299d6)
  • refactor: isModernBrowser return boolean for avoiding duplicate call (Clark Du) (c6d8e8f)
  • refactor: not detect modern browser if modern mode is disabled (Clark Du) (2b4d79c)
  • refactor: remove builder coupling from server (#​5157) (Pooya Parsa) (13cb0f7)
  • refactor: remove unnecessary onEmit in old webpack (Clark Du) (eac6d02)
  • refactor: some small stuff (#​4979) (Alexander Lichter) (69dfd84)
  • refactor: fix typos (#​4922) (Alexander Lichter) (569b6aa)
  • refactor: unify context in webpack module (#​5054) (Xin Du (Clark)) (9860eb6)
  • refactor: use spread syntax for plugin push (#​4976) (Alexander Lichter) (31cb187)
  • refactor: fallback to babel-preset-env defualt targets when buildTarget is not specified (Clark Du) (176641f)
  • refactor(ts): add warning for nuxt-ts deprecation (#​5301) (Kevin Marrec) (a11afd4)

Chore

  • chore(babel-preset): create readme with basic docs (#​5127) (HG) (04cdd60)
  • chore: don`t ignore .nuxtignore (#​5169) (Dmitry Molotkov) (39c9ab5)
  • chore: enable yarn.lock maintenance (#​5063) (Xin Du (Clark)) (17b53eb)
  • chore(vue-app): suppress deprecated warning for classic vuex in prod (#​5137) (Shingo Sato) (f39205a)

Tests

  • test: add await for promisable expect (Clark Du) (fabf1c0)
  • test: add chrome detector (#​4984) (Xin Du (Clark)) (855705b)
  • test: add describe.posix and win (Clark Du) (e9ba2f9)
  • test: fix macos e2e tests (Pooya Parsa) (2c763df)
  • test: improve nuxt-loading component tests (#​5005) (Pim) (75a7454)
  • test: mock enquirer in typescript tests (#​5025) (Pim) (ad6a8cd)
  • test: skip reqest in dev test for now (Clark Du) (3e67879)
  • test: try to fix unhandled request (Clark Du) (2f2baac)
  • test: turn off cli dev test (Clark Du) (5c053f5)
  • test: unit tests for generator (#​4857) (Xin Du (Clark)) (e22a282)
  • test: unit tests for @​nuxt/util (#​4880) (Xin Du (Clark)) (96bab9f)
  • test: unit tests for server module (#​5154) (Xin Du (Clark)) (cc573a4)
  • test: update cli snapshot (Clark Du) (3dd1a28)
  • test: unhandled open handles (Clark Du) (858c9ee)
  • test: change cli.test to be more accurate (#​4957) (Xin Du (Clark)) (68f6880)
  • test: use puppeteer-core (#​4929) (Pooya Parsa) (940a36f)
  • test: fix e2e test by downloading chromium (#​5254) (Pooya Parsa) (2561b68)
  • test: fail tests in case of unhandled errors (#​5255) (Pooya Parsa) (d6b505a)

v2.4.5

Compare Source

v2.4.5 (2019-02-26)

Bug fixes and Improvements

v2.4.3

Compare Source

🐛 Bugfixes

  • webpack: Update dependency terser-webpack-plugin to ^1.2.2.
  • webpack: Update dependency webpack to ^4.29.2
  • utils: Fix serializeFunction for external imports (#​4916)
  • config: Warn when using array for postcss config (#​4936)
  • module: support src as a function in addModule (#​4956)
  • server: await buildDone hook (#​4955)

v2.4.2

Bugfixes

  • Handle async components correctly when using nuxt-ts (MR #​4886)
  • Fix extractCSS in dev mode (MR #​4892)
  • Correctly apply class when using linkPrefetchedClass (MR #​4893)

v2.4.0

Compare Source

Upgrade Note ⚠️

Due to a known problem (webpack/webpack#​8656, #​4869, #​4839) users of npm should either remove package-lock.json and reinstall before upgrade or use npm update acorn --depth 20 && npm dedupe after upgrading to 2.4.0. yarn users should have no problems but removing yarn.lock still recommended before the upgrade process.

Important news 👀

New core team member 🐤

We are really proud to announce Kevin Marrec (@​kevinmarrec) as a new core team member of Nuxt.js. He is French 🇫🇷 and responsible for the TypeScript integration 💚

Official Consulting ⛑

We now offer official support & consulting from the core team. We partnered with Otechie for the process and already did some beta-tests with selected companies.

Are you interested or curious? Learn more on https://otechie.com/nuxt 🙌

RFC Process 📎

We invite you to take a look at our nuxt/rfcs repository where we discuss the future of Nuxt and its vision.

Here are some interesting proposals if you want to learn more about the upcoming changes of Nuxt:

Release Plan 🚢

Starting with this release, Nuxt will adhere to a formalized release plan (as good as possible). Also, an end of life for older major versions is defined within RELEASE_PLAN.md.

Quick summary:

  • Nuxt major releases are planned every 6 months.
  • The release cycle for Nuxt.js minor versions is roughly 4 weeks.
  • Fixes will be released as soon as possible after the actual MR/commit

We strongly invite you to read the RELEASE_PLAN.md for further details.

Thank you ❤️

We want to specially thanks:

  • Our contributors submitting bug reports, feature requests and commenting on issues
  • Our users participating on our Discord server and sharing the love by mentioning our Twitter account
  • All the devs working for companies using Nuxt.js and who helped us building a showcases list
  • Our backers and sponsors supporting us financially through our open Collective

New Features ✨

Speaking of TypeScript...

TypeScript support has landed!

nuxt-ts

In order to run Nuxt with TypeScript, we created a new distribution, called nuxt-ts (we also have nuxt-ts-edge). We want to thank @​hmsk for his donation of the package name on npm ❤️

You can explore Nuxt TypeScript example or play with it directly in our Nuxt TS CodeSandBox.

For a more advanced example, you can look at the HackerNews-TS repo or play with it on CodeSandBox, made by @​husayt & @​kevinmarrec.

This work has been made by @​kevinmarrec with the help of @​pi0 & @​Atinux.

⚠ Experimental: We are waiting for your feedback to keep improving it and breaking changes can occur without a semver major release. However, all changes will be documented properly

Smart prefetching ⚡️

Nuxt.js will automagically prefetch the code-splitted pages linked with <nuxt-link> when visible in the viewport by default. This hugely improves the end user performances, inspired by quicklink.

nuxt-prefetch-comparison

Demos are online and we recommend you to try it out to feel the difference:

Bonus: we added $nuxt.isOnline and $nuxt.isOffline which is reactive, so you can use it directly inside your components (see this example).

You can learn more about this feature in the associated MR #​4574 and in the documentation.

HMR & best practices for store/ 👀

Save more development time with full HMR support for the store (mutations, getters, and actions).

nuxt-vuex-hmr

This feature has been implemented by @​manniL & @​Atinux on MRs #​4589, #​4582 and #​4791

Autocomplete for VS Code (via. Vetur extension) ✅

If you are using VS Code, with this version, you will now have autocomplete for Nuxt.js components:

nuxt-vs-autocomplete

This feature has been implemented by @​octref & @​Atinux on MR #​4524

Port taken? Nuxt got your back! 💪

If Nuxt wants to listen on a port which is already used, it will warn you in development and listen to a free port instead:

49249621-efe2e780-f431-11e8-90fb-ba48e67ba5c9

In production it will throw an error instead to avoid unwanted behavior:

49249634-f8d3b900-f431-11e8-9f51-afbf3ffc68ed

This feature has been implemented by @​ricardogobbosouza on MR #​4428 with the help of @​pi0 and @​manniL.

Suggest installing missing dependencies or mismatches 💯

Nuxt requires all peer like dependencies as a dependency for easier usage. Sometimes this causes unwanted behaviors when users explicitly add a specific version in their package.json which is incompatible with nuxt. This could also help to resolve popular Vue packages version mismatch error (#​198, #​669, #​1084, #​1414, #​1851, #​2079, #​2406, #​3454).

Nuxt is now able to automatically self-verify installed dependencies and warn with a proper message in case of detecting problems.

image

This feature has been implemented by @​pi0 in MR #​4669

Auto-detection of modern bundles 🥇

When running nuxt start, Nuxt will automatically detect if you built your app modern mode enabled. No need to run nuxt start --modernexplicitly anymore 🌟

screenshot 2018-11-30 at 16 55 48

This detection was created by @​clarkdo on MR #​4422

Plugin modes and file extensions 💅

Until now, you used ssr: false in your plugin declarations to disable server-side rendering. We decided to deprecate that option and introduce a mode instead, which can be 'all', 'client' or 'server'. No worries, ssr is still working (until Nuxt 3).

The new feature coming with the mode is that you can define it by using the file suffix:

  • plugins/plugin.server.js
  • plugins/plugin.client.js
  • plugins/plugin.js

By adding the plugins to your nuxt.config.js:

plugins: [
  '~/plugins/plugin.server.js',
  '~/plugins/plugin.client.js',
  '~/plugins/plugin.js'
]

The declaration will be internally transformed to:

plugins: [
  { mode: 'server', src: '~/plugins/plugin.server.js' },
  { mode: 'client', src: '~/plugins/plugin.client.js' },
  { mode: 'all', src: '~/plugins/plugin.js' }
]

(If you specify the mode manually, it will overwrite the suffix detection)

This feature has been implemented by @​clarkdo on MR #​4592

Module commands 🖥

Nuxt modules can now include bin scripts that are recognized by Nuxt's CLI.

Here's an example of my-module/bin/command.js:


#!/usr/bin/env node

const consola = require('consola')
const { NuxtCommand } = require('@&#8203;nuxt/cli')

NuxtCommand.run({
  name: 'command',
  description: 'My Module Command',
  usage: 'command <foobar>',
  options: {
    foobar: {
      alias: 'fb',
      type: 'string',
      description: 'Simple test string'
    }
  },
  run(cmd) {
    consola.info(cmd.argv)
  }
})

The command could be run with:

npx nuxt command arg1 arg2

You can learn more about that in the modules command documentation.

⚠ Experimental: We are waiting for your feedback to keep improving it and breaking changes can occur without a semver major release. However, all changes will be documented properly <3

This feature has been implemented by @​galvez on MR #​4314 with the help of @​pi0.

PostCSS in Vue Components 💃

You can now use lang="postcss" in your Vue components. Postcss has applied to all your styles anyway (e.g. to resolve aliases like ~) but the lang attribute enables autocomplete and syntax highlighting for some IDEs.

nuxt-postcss

This feature has been implemented by @​manniL on MR #​4417.

No more extensions for Stylesheets needed 🦅

stylesheet extensions

We are concerned to improve the Developer Experience ("DX") with each release. This small change allows you to omit the file extension for CSS/SCSS/Postcss/Less/Stylus/... files listed in the css array inside your nuxt.config.js. For the plugins or serverMiddleware key, this is already possible.

This feature has been implemented by @​manniL on MR #​4671.

SSR Bundle improvements 🔹

We made a full rewrite of how SSR bundle is packaged.

This means better performance, less memory overhead, fewer OOM crashes and easier SSR bundle debugging.

_ | Before | After | Diff -------|-----------------------|-----------------------|------------------------- Dist | 8.2M | 7.2M | -1M / 12% Dev | 281 MB (RSS: 439 MB) | 237 MB (RSS: 354 MB) | -44M / 16% (RSS: -85M / 19%) Start | 106 MB (RSS: 169 MB) | 71.7 MB (RSS: 137 MB) | -34M / 32% (RSS: -32M / 19%)

This feature has been implemented by @​pi0 on MR #​4439.

Other changes 🌔

  • process.modern can be used for distinguishing modern environment.
  • Add server.timing to give Server-Timing header, useful for monitoring and performances overview (MR #​4800)
  • ⚠️ Experimental: Enable HardSourceWebpackPlugin by hardSource: true in hardSource of nuxt.config.js
  • You can now set scrollToTop to false in pages (MR #​4564)
  • Aliases for nuxt-link and nuxt-child (n-link and n-child) are available now (MR #​4525)
  • Components can now be used in PascalCase as recommended by the Vue styleguide (MR #​4396)
  • VueMetas headAttrs are now supported for the appTemplate (MR #​4536)
  • More browsers are added to the list of modern browsers (MR #​4516, MR #​4775)
  • Loaded resources can now have a crossorigin attribute (MR #​4472)
  • Modern mode resources are preloaded and will be pushed via HTTP2 server push if set (MR #​4508)
  • Add option to disable the compression middleware (MR #​4381)
  • Add option to disable the FriendlyErrorsWebpackPlugin overlay (MR #​4381)
  • Add exclude option to exclude pages from being generated (in static mode) but still get rendered via fallback/SPA (MR #​4754)
  • Support build.hotMiddleware.client (MR #​4796)
  • New examples have been added:
  • Internal changes:
    • feat: use runInNewContext: true for nuxt dev (#​4508)
    • feat: check modern build file in modern mode (#​4467)
    • refactor: migrate to extract-css-chunks-webpack-plugin (#​4495)

Further Patches (30+) 🔍

v2.3.4

Compare Source

(Please skip v2.3.3 release. It was mistaken.)

🔧 Fixes

  • CLI: nuxt-start command should always start nuxt in production mode (#​4384)
  • Modern Mode: Fix behavior where modern=true or false didn't work as expected (#​4378)
  • Router: Correctly handle Unicode page names (#​4402)
  • Router: Emit triggerScroll event after changing the layout (#​4399)
  • Components: Allow 0 values for progress bar attributes (#​4397)
  • Server/Tests: Correctly print timeout error message for JSDom (#​4412)

⚡️ Dependencies

  • Update dependency vue-router from 3.0.1 to 3.0.2 (#​4394)
  • Update dependency @nuxt/friendly-errors-webpack-plugin from 2.3.0 to 2.3.2
  • Update dependency mini-css-extract-plugin from 0.4.4 to 0.4.5
  • Update dependency webpack from 4.26.0 to 4.26.1
  • Update dependency vue-meta from v1.5.5 to v1.5.6
  • Remove opencollective dependency from nuxt-start (#​4415)
  • Remove lodash dependency from packages to reduce the nuxt-start size (#​4411)

v2.3.3

Compare Source

v2.3.2

Compare Source

Fixes

  • Use exact versions for Nuxt internal packages
  • Fallback to default value when publicPath is falsy (#​4365)
  • Add lodash inside templating (#​4368)

v2.3.1

Compare Source

📝 Release Notes

With v2.3, Nuxt.js is splitted into smaller packages (Aka a mono-repo). This means smaller packages, independent versioning support and ability to replace any part of Nuxt.js without dirty hacks. Before this release, we carefully tested the latest updates using edge release channel against real-world projects and there should be no breaking changes.

Please note that for upgrading Nuxt.js just changing version inside package.json is not enough. Please use yarn upgrade or npm upgrade so that the final directory structure of node_modules will be correct. In case of problems clean up node_modules and yarn.lock/package-lock.json. Still having problems? open an issue in cmty!

🔧 Fixes and Enhancements

  • CLI and DX improvements (#​4259)
  • CLI cleanups and improvements (#​4222)
  • Improve nuxt-loading component (#​3891)
  • Set defaults for port and host values (#​4207)
  • Dynamically read environment variables when loading nuxt.config.js (MR #​4208)
  • Support custom pushAssets function to control http2 push headers (#​4198)
  • Reduce duplicate code in routes.js (#​4121)
  • Print warning when using build.extractCSS.allChunks (#​4097)
  • Throw an error when layout property is not string (#​4142)
  • Use require.resolve to get the path of babel-loader (#​4150)
  • Check style resources for existence (#​4155)
  • Serialize config head fn shorthand correctly (#​4283)
  • Don't accept ranges (#​3870) (#​4295)
  • Correctly resolve layouts with nested custom dir (#​4135)
  • Warn on unknown mode (#​4303)
  • Use postcss.order to change order of postcss plugins(#​4318)
  • Fix for double escaping static class on SSR (#​4312)
  • Fix stable route sorting for Node v11 (#​4331)

🎉 New Features

⚡️ Dependency Upgrades

❄️ Deprecations

  • Deprecate styleResources because of performance issues. Use our new community module instead (it's a drop-in replacement) (#​4302)
  • Deprecate callback-based asyncData, fetch and middleware methods. Use Promises or async/wait instead. (#​4256)

💄 Internal Refactors

  • Migrate nuxt into a mono-repo (#​4051)
  • Refactor core into @nuxt/core, @nuxt/server and @nuxt/vue-renderer (#​4202)
  • Refactor builder into @nuxt/builder and @nuxt/webpack (#​4171)
  • Move @nuxtjs/babel-preset-app into nuxt mono-repo and republish it as @nuxt/babel-preset-app (#​4205)
  • Move common config to @nuxt/config (#​4212)
  • Packaging and development improvements (#​4193)
  • Extract eslint-config into own package (#​4108)
  • Several test utils cleanups (MR #​4180)

v2.3.0

Compare Source

Configuration

📅 Schedule: Branch creation - At any time (no schedule defined), Automerge - At any time (no schedule defined).

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

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

🔕 Ignore: Close this MR and you won't be reminded about this update again.

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

This MR has been generated by Renovate Bot.

Merge request reports