RC

Releases

Discover the latest Nuxt updates.

💬 Join the release discussion

🚀 How to Upgrade

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

  • Automated: npx nuxi@latest upgrade --force
  • Manual: Bump nuxt dependency to 3.0.0-rc.11 and then use npx nuxi@latest cleanup to cleanup any local caches

⭐ What is New?

Full Static Enhancements

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

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

IPv6 and HTTPS support for nuxi dev and vite

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

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

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

Nitro Improvements

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

Full Changelog

compare changes

🚀 Enhancements

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

🩹 Fixes

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

📖 Documentation

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

❤️ Contributors

  • Alexander Lichter
  • Alper Doğan
  • Chenying
  • Clément Ollivier
  • Damian Głowala
  • Daniel Roe
  • Julien Huang
  • Krutie Patel
  • Lexpeartha
  • Pooya Parsa
  • YIngChenIt
👍 83🎉 45❤️ 53🚀 46👀 1

v3.0.0-rc.11

@pi0

September 20, 2022

💬 Join the release discussion

🚀 How to Upgrade

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

  • Automated: npx nuxi@latest upgrade --force
  • Manual: Bump nuxt dependency to 3.0.0-rc.10 and then use npx nuxi@latest cleanup to cleanup any local caches

⭐ What is new?

Critical Styles are Inlined

#6755, #7160

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

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

Full Static Generation with Payload Rendering

#6411, #6455

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

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

#4329

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

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

Better Workspace Support

unjs/pkg-types#34, #7439

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

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

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

defineNuxtConfig is Auto Imported

#7267, #7485, #7497

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

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

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

More Powerful nuxt init

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

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

Experimental Zero-Client-JS Mode

#7156, #7248

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

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

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

Changelog

(see all commits)

🚀 Enhancements

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

🔥 Performance

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

🩹 Fixes

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

💅 Refactors

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

📖 Documentation

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

🏡 Chore

  • Update CodeSandbox links (#7318)

📦 Build

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

✅ Tests

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

🤖 CI

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

❤️ Contributors

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

v3.0.0-rc.10

@pi0

September 14, 2022

💬 Join the release discussion

Highlights

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

Changelog

(all commits)

🚀 Enhancements

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

🔥 Performance

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

🩹 Fixes

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

💅 Refactors

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

📖 Documentation

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

🏡 Chore

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

❤️ Contributors

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

v3.0.0-rc.9

@pi0

September 3, 2022

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

Warning There are slight API changes with this release candidate.

💬 Join the release discussion

🚀 How to upgrade

  • Automated: npx nuxi-edge@latest upgrade --force
  • Manual: Bump nuxt dependency to 3.0.0-rc.8 and then use npx nuxi-edge@latest cleanup to cleanup any local caches

🩹 Fixes

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

📦 Build

  • nuxt: Publish missing types (#6516)

📖 Documentation

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

❤️ Contributors

  • Damian Głowala
  • Daniel Roe
  • Eugen Istoc
  • Jiang Menghao
  • Pooya Parsa
  • Timur Bolotov
👍 43🎉 31❤️ 8🚀 25👀 11

v3.0.0-rc.8

@pi0

August 12, 2022

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

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

🚀 Enhancements

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

🔥 Performance

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

🩹 Fixes

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

💅 Refactors

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

📖 Documentation

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

📦 Build

  • Upgrade to unbuild 0.8.x (#6483)

✅ Tests

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

❤️ Contributors

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

v3.0.0-rc.7

@pi0

August 11, 2022

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

🚀 Enhancements

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

🔥 Performance

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

🩹 Fixes

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

📖 Documentation

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

❤️ Contributors

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

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

👍 66🎉 42❤️ 40🚀 32👀 13

v3.0.0-rc.6

@pi0

July 18, 2022

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

Feedback about the release: Join the discussion

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

⚠️ Breaking Changes

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

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

🚀 Enhancements

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

🔥 Performance

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

🩹 Fixes

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

📖 Documentation

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

❤️ Contributors

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

v3.0.0-rc.5

@pi0

July 13, 2022

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

This release contains commutative enhancements from RC.3. Thanks to all of the contributors to the code and documentation 💚

🚀 Enhancements

  • vite: Replace global with globalThis (#4958)
  • nuxt: Support auto imports within <template> (#4904)
  • nuxt: Experimental flag to use external vue dependencies (#5083)

🩹 Fixes

  • nuxt: Respect baseurl when redirecting (#4933)
  • nuxt: Check for 404s after user middleware (#4913)
  • cli: Only reload for top level dirs (#4912)
  • vite: Add file:// protocol to vite-node entry file path (#4966)
  • test-utils: Hardcode ipv4 ip for localhost (#4998)
  • nuxt: Fix router redirection on aliased pages (#4982)
  • nuxt: Allow passing extraneous attrs to meta components (#5071)
  • nuxt: Add default empty title to trigger titleTemplate (#5064)
  • nuxt: Default statusCode of navigateTo from 301 to 302 (#5173)
  • schema: Add missed types for title, bodyAttrs and htmlAttrs (#5184)
  • nuxt: Respect navigateTo options using server middleware in server-side (#5145)
  • nuxt: Support RouterView props in NuxtPage (#5272)
  • schema, vite: Resolve mode config correctly (#5255)
  • nuxt: Add ssrContext types on NuxtApp (#5333)
  • types: Tidy types for useAsyncData (#5340)
  • nuxt: Relax server import protections (#5355)
  • nuxt: Keep route param optionality when sibling is an index (#5300)
  • kit: Pass resolved path to isIgnored (#5375)
  • vite, kit, nuxt: Generate safe variable names using knitwork (#4906)
  • webpack: Respect build.transpile (#5043)
  • nuxt: Transform extends layers within node_modules (#5042)
  • nuxt: Throw an error when using unknown route middleware (#5323)
  • nuxt: Don't debounce watcher and include layers (#5002)
  • vite: Don't terminate with escaped delimiters (#5409)
  • nuxt: Exclude non-cwd auto-imports and don't process all files (#5421)
  • nuxt: Ignore whitespace and commas within resolveComponent (#5428)
  • cli: Always set NODE_ENV value with a warning (#5417)
  • nuxt: Don't add macro query to the end of id (#5413)
  • webpack: Enable extractCSS by default (#4388)

💅 Refactors

  • vite, webpack, test-utils: Use caret range for vue peer dependency (#5190)
  • cli: Provide better advice on failing clone (#5155)
  • Fix typo and code improvements (#5344)
  • cli: Improve env update message (#5430)

📖 Documentation

  • Add missing parentheses in the alias example (#4995)
  • Fix typo in environment variable (#4990)
  • data-fetching: Add note about difference between useFetch and useAsyncData (#4974)
  • api: Improve useFetch docs for body type and additional ohmyfetch options (#4985)
  • Minor improvements for the quick start section (#5036)
  • middleware: Add navigateTo options (#5044)
  • Update wording of client-side rendering explanation (#5049)
  • Demonstrate the multiple useState with same key (#5059)
  • config: Correct naming of NUXT_APP_CDN_URL environment variable (#5032)
  • Update logo to better support light and dark mode. (#5094)
  • Fix nuxt app guide linking to a 404 page (#5122)
  • api: Add experimental --prerender flag to nuxi build command (#5112)
  • api: Add key option for useFetch (#5089)
  • roadmap: Nuxt content v2 release (#5129)
  • Add --no-clear flag in the documentation of development server (#5197)
  • deploy: Update default host for node preset (#5228)
  • guide: Add use of NuxtLayout in app.vue with pages (#5225)
  • Small typo in the "catch-all route" description (#5273)
  • pages: Add information for typing page metadata (#5270)
  • Add documentation for titleTemplate (#5093)
  • Fix typo in component migration guide (#5284)
  • Fix typo in programmatic navigation (#5298)
  • Add warning against layout as root element (#5345)
  • Update keepalive key name (#5366)
  • api: Add useRequestEvent (#5326)
  • api: Add docs for useRouter composable (#4949)
  • Update cookie example with defineEventHandler (#5405)
  • Update plugin provide example (#5386)
  • Fix mdn links for 301 and 302 http status (#5416)

🏡 Chore

  • Clean up jsdocs (#5397)
  • Force single version of vite (#5400)

❤️ New Contributors

👍 21🎉 70❤️ 42🚀 45👀 7

v3.0.0-rc.4

@pi0

June 13, 2022

🚀 Enhancements

Nuxt, Kit

  • #4850 Support serverHandlers/devServerHandlers shortcuts to register custom handlers

Nuxt

  • ⚠️ #4837 Upgrade nitropack to 0.4.x
  • #4834 Custom include option

🩹 Fixes

Nuxt

  • #4770 Use router.resolve to resolve initial url
  • #4781 Ensure url is not empty string
  • #4839 Clear errors after navigation
  • #4842 Check if default slot is provided before calling it
  • #4841 Normalize window location for universal router
  • #4791 Await asyncData if ssr: false
  • #4851 Add missing import to client only wrapper
  • #4857 Avoid redirect with different encoding and trailing slash

Schema

  • #4772 Exclude vite from DeepPartial
  • #4849 Add back PublicRuntimeConfig interface for augmentation

Vite

  • #4844 Use buildAssetsURL for dynamic imports
  • #4822 Ignore virtual imports that aren't in vfs

💅 Refactors

Nuxt

  • #4853 Cleanup renderer entry

📖 Documentation

Data-fetching

  • #4824 Fix and improve data-fetching example

API

  • #4776 Document useRoute composable
  • #4870 Fix api examples

General

  • #4831 Fix example syntax for runtime hook plugin

❤️ New Contributors

👍 18🎉 66❤️ 35🚀 24👀 3

v3.0.0-rc.3

@pi0

May 10, 2022

🩹 Fixes

Nuxt

  • #4491 Await for router.push on ssr
  • #4626 Cleanup auto imports on regenerate
  • #4590 Warn to provide a key for useFetch with transform option
  • #4677 Use suspense for child pages on client-side navigation
  • #4666 Mark config head as non-reactive
  • #4210 Improve error types for useAsyncData and useFetch
  • #4645 Process middleware after plugins
  • #4755 Preserve error.data in response

CLI

  • #4595 Don't strip file extensions from dirs in tsconfig
  • #4685 Typo in init message
  • #4612 Improve nuxi init output

Schema

  • #4695 Decrease recursion on DeepPartial

Vite

  • #4512 Transform virtual templates
  • #4442 Use single regex to reduce risk of collisions
  • #4596 Don't match across newlines

✨ Features

Nitro

  • #4304 Add nitro:build:before hook

Pages

  • ⚠️ #4537 Explicitly allow optional params with [[

General

  • #4509 Allow disabling sourcemap generation

📖 Documentation

General

  • #4502 Update migration guide
  • #4506 Simplify example of Head components
  • #4519 Remove duplicate entry for default option
  • #4510 Update stackblitz links
  • #4485 Fix 'alias' usage
  • #4499 Improve netlify deployment
  • #4401 Improve server routes guide
  • #4573 Update environment variable in example
  • #4593 Add layout to match custom header example
  • #4603 Fix some minor typos
  • #4608 Fix typo
  • #4617 Fix typo
  • #4616 Make titleTemplate function form example clearer
  • #4640 Add note and banner about edge channel
  • #4653 Fix edge alert syntax
  • #4679 Fix typos
  • #4675 Add notes about auto imports from composables/ directory
  • #4715 Fix incorrect function declaration in composables
  • #4714 Add note that .env is not read in production
  • #4742 Make useFetch example consistent with others

Features

  • #4563 Complete assets page

Typescript

Migration

  • #4642 Update to use new runtimeConfig

Readme

Concepts

API

  • #4549 Fix useAsyncData example

🏡 Chore

General

  • #4453 Setup IssueUp
  • #4664 Enable typecheck ci for packages

Docs

⚠️ Breaking Changes

  • #4537 Explicitly allow optional params with [[

If you are relying on [slug] at the end of a route to generate an optional parameter, you will need to rewrite it as [[slug]].

❤️ New Contributors

👍 45🎉 35❤️ 26🚀 28👀 1

v3.0.0-rc.2

@pi0

May 2, 2022

🐣 3.0.0-rc.1 "Mount Hope"

Release Announcement

🚀 Check out the Announcing Nuxt 3 Release Candidate for more information about this release!

Migrating from nuxt3 edge releases

If you are already a beta tester of nuxt using nuxt3 package, please follow the steps below to use RC.1:

  1. Check out Breaking changes tracker to apply any of the previous possible breaking changes on edge-channel.
  2. Remove .nuxt, package.lock.json, yarn.lock and node_modules
  3. Update nuxt.config to import defineNuxtConfig from nuxt instead of nuxt3:
- import { defineNuxtConfig } from 'nuxt3'+ import { defineNuxtConfig } from 'nuxt'export default defineNuxtConfig({ ... })
  1. Update package.json
{  "devDependencies": {-    "nuxt3": "latest"+    "nuxt": "^3.0.0-rc.1"  }}

Alternatively, you can use "nuxt": "npm:nuxt3@latest" to keep using the latest edge releases of Nuxt 3.

Migration for module authors

For Nuxt 3 modules created by new module-builder toolchain, also update @nuxt/kit dependency to use RC.1 in package.json:

{  "dependencies": {-    "@nuxt/kit": "npm:@nuxt/kit-edge@latest"+    "@nuxt/kit": "^3.0.0-rc.1"  }}
👍 50🎉 102❤️ 66🚀 56👀 3

v3.0.0-rc.1

@pi0

April 20, 2022

Community

Roadmap

Bridge

Overview