This PR contains the following updates:
| Package | Type | Update | Change | Age | Adoption | Passing | Confidence |
|---|---|---|---|---|---|---|---|
| @nuxt/module-builder | devDependencies | pin | ^0.1.7
-> 0.1.7
| | | | |
| @nuxt/test-utils | devDependencies | patch | 3.0.0-rc.11
-> 3.0.0
| | | | |
| nuxt | devDependencies | pin | ^3.0.0-rc.11
-> 3.0.0
| | | | |
Add the preset :preserveSemverRanges
to your config if you don't want to pin your dependencies.
Release Notes
nuxt/framework
v3.0.0
: Nuxt 3.0 stable
Compare Source
✨ Official Release Announcenment
💬 Release Discussion
📝 Changelog
Check out v3.0.0-rc.14 for other recent changes.
🩹 Fixes
- nuxt: Removed auto imports (#9045)
- schema: Initialise
runtimeConfig.public
with empty object (#9050)
- cli: Upgrade with
latest
tag (#9060)
- nuxt: Allow union type arguments for
useAsyncData
(#9061)
📖 Documentation
- New website design (#9007)
- Update website theme version (819deb89)
- Minor style improvements (9ab069b2)
- Update website-theme (780b17b1)
- Add warning about
definePageMeta
issues with transitions and NuxtLoadingIndicator
(#9055)
- Add missing agencies (#9059)
🏡 Chore
- Update readme design (#9048)
- Ignore
parse5
for renovate update (#9046)
❤️ Contributors
Compare Source
Note
This is the last release candidate for Nuxt v3! Are you ready? 👀
👉 Release Discussion
Changelog
compare changes
⚠️ Breaking Changes
- cli: Setup nuxt globally with
nuxt test
(#4578)
- nuxt: Only add
$f
fetch prefix to auto-keys (#8852)
- test-utils: Use
vitest/node
subpath export (#8815)
- nuxt: Remove
initialCache
option (#8885)
- nuxt: Enable payload extraction only for
nuxi generate
(#9018)
- nuxt: Include request url and params in
useFetch
key (#6632)
- nuxt: Fix typo for
NuxtRenderHTMLContext.bodyPrepend
(#8712) (#8704)
- nuxt: Remove support for
404.vue
shorthand (#8809)
- kit: Remove support for module container (#9010)
- nuxt: Move
head
option support into defineNuxtComponent
(#8901)
- Remove deprecated api (#9029)
- Remove
PrivateRuntimeConfig
interface support
- Remove autoImports
option
- Remove autoImports:extend
hook support
- Remove deprecated addAutoImport
and addAutoImport
utilities (use addImports
and addImportsDir
)
- Remove defer
option for useAsyncData
- Remove support for installModule(nuxt, nuxtModule)
- Remove support for module defenition as function
- Remove support for name
in module definition (use meta.name
)
- Remove deprecated throwError
(use showError
)
- Remove deprecated useActiveRoute
(use useRoute
)
- Remove deprecated NuxtConfig
and defineNuxtConfig
imports from nuxt
(import from nuxt/config
)
- Remove deprecated <Script>
component (use useHead
)
- Remove deprecated RouterConfigOptions
interface (use RouterConfigSerializable
)
- Remove deprecated fileName
for template options (use filename
)
- Remove deprecated <NuxtNestedPage>
and <NuxtChild>
components
- Remove deprecated buildModules
config
- Remove deprecated privateRuntimeConfig
and publicRuntimeConfig
options
- Remove deprecated imports.presets[].name
(use presets.imports
instead)
🚀 Enhancements
- nuxt: Add
isExternal
to <NuxtLink>
slot props (#8800)
- nuxt: Auto-import
utils/
directory (#8817)
- cli: Wrap and normalize all console outputs (#8846)
- nuxt: Allow customizing root id and tag (#8883)
- nuxt: Add
onBeforeRouteLeave
and onBeforeRouteUpdate
composables (#8889)
- cli: ⚠️ Setup nuxt globally with
nuxt test
(#4578)
- cli: Auto-generate
.npmrc
and setting for pnpm (#7407)
- nuxt, schema: Migrate to @vueuse/head v1 (#8975)
🩹 Fixes
- nuxt: Check if global transitions are activated for scroll behavior (#8700)
- nuxt: Allow cookies to be set to
null
to unset them (#8769)
- nuxt: Add catchall paths to prerender list (#8782)
- schema: Add declarations to ignore list (#8787)
- ssr: Ensure
useRequestHeaders
are case-insensitive (#8805)
- nuxt: Do not render page if we are throwing error (#8821)
- nuxt: Swallow issues with query selectors (#8843)
- nuxt: ⚠️ Only add
$f
fetch prefix to auto-keys (#8852)
- test-utils: Detect project root using
nuxt.config
with .mjs
and .cjs
extensions (#8855)
- cli: Exclude
dist
from type checking (#8848)
- test-utils: ⚠️ Use
vitest/node
subpath export (#8815)
- nuxt: Detect non-functional imports within page meta (#8881)
- nuxt: Preserve render errors (#8884)
- nuxt: ⚠️ Remove
initialCache
option (#8885)
- nuxt: Use
app.baseURL
when fetching error page on server (#8888)
- nuxt: Avoid passing attrs to default slot for
<ClientOnly>
component (#8921)
- vite: Add extend layers to
fs.allow
(#9006)
- nuxt: Include layers in esbuild transform (#9014)
- kit: Add external module to transpile (#8963)
- nuxt: ⚠️ Enable payload extraction only for
nuxi generate
(#9018)
- nuxt: ⚠️ Include request url and params in
useFetch
key (#6632)
- nuxt: Improve hmr for pages macros (#8940)
💅 Refactors
- nuxt: ⚠️ Fix typo for
NuxtRenderHTMLContext.bodyPrepend
(#8712)
- nuxt: ⚠️ Fix typo for
NuxtRenderHTMLContext.bodyPrepend
(#8704)
- nuxt: ⚠️ Remove support for
404.vue
shorthand (#8809)
- nuxt: Explicitly import app in nuxt-root (#8729)
- kit: ⚠️ Remove support for module container (#9010)
- Update unjs dependencies to stable v1 (#9011)
- nuxt: ⚠️ Move
head
option support into defineNuxtComponent
(#8901)
- ⚠️ Remove deprecated api (#9029)
📖 Documentation
- Update 2.nuxt-page.md (#8761)
- Update roadmap for november (#8766)
- Use update import for
defineLazyEventHandler
(#8767)
- Remove stability-edge (507f444c)
- deployment: Remove usage of custom icons (8e4068b7)
- Improve examples content (1582f8ec)
- api: Add
useRequestHeaders
composable example (#8833)
- Add entry for
extendPages
(#8860)
- api: Add
refreshNuxtData
util examples (#8845)
- Get event before running async function (#8861)
- api: Add
useHydration
composable (#8768)
- Add
query
option with example for useFetch
(#8719)
- Add initial documentation for router composables (#8895)
- Add tls option to redis example (#8900)
- Fix syntax errors in server storage example (#8906)
- Fix typo (#8970)
- api: Add spaces to avoid breaking mobile layout (#8967)
- Typo in
available
(#8966)
- Add a bit more detail in the
definePageMeta
warning to specify it needs to be in a page (#8923)
- Match the open graph protocol markup (#8959)
- Fix typos (#8976)
❤️ Contributors
Compare Source
👉 Release discussion
⭐ What is New?
🔰 Security Fixes
This release contains multiple security related fixes #8675, #8674 and #8673 reported via huntr.dev platform by OhB00.
We recommend you upgrade to the latest version as soon as possible.
If you encounter "The request URL ... is outside of Vite service allow list" issue, try adding path to vite.server.fs.allow
in nuxt.config
. read more.
🚀 Performance Improvements
Using a new method to extract definePageMeta
improves vite performance and makes lazy compilation of pages possible (#8536).
💯 Strict Config Schema and Types
We have cleaned up the configuration schema (#8487) so that you no longer would be confused with Nuxt 2 options and also can quickly notice any typos in nuxt.config
file.
Typescript strict mode is also enabled by default with this release as best practice. (#8667)
🚇 Nitro Development Server Proxy
Using nitro.devProxy
option you can now configure proxies for the development server. (learn more)
Changelog
compare changes
⚠️ Breaking Changes
- nuxt: ⚠️ Use parser to generate page metadata (#8536)
- schema: ⚠️ Use strict typescript mode by default (#8667)
- test-utils: ⚠️ Update vitest args (#8325)
- schema: ⚠️ Disable
app.pageTransition
and app.layoutTransition
by default (#8436)
- nuxt: ⚠️ Cleanup schema and split nuxt 2 types (#8487)
🚀 Enhancements
- nuxt: Default router scroll behavior (#3851)
- nuxt: Make
useFetch
options reactive (#8374)
- kit: Add
updateTemplates
utility (#8413)
- nuxt: Add dev warnings when
setPageLayout
is used incorrectly (#8464)
- Add
<devOnly>
component (#7950)
- nuxt: Allow setting
name
and path
for a route in definePageMeta
(#8633)
- kit: Add
addServerPlugin
utility (#8635)
- kit, nuxt: Support
prerender:routes
and addPrerenderRoutes
(#8670)
🩹 Fixes
- nuxt: Don't use or assignment (#8299)
- nuxt: Pass original request headers to the error page (#7340)
- nuxt: Scroll to top on dynamic routes with different params (#8327)
- nuxt: Router defaults overwrite custom options always (#8334)
- cli: Update analzye main handler (#8339)
- nuxt: RouterBehavior comparison for hash block (#8383)
- nuxt: Don't load payloads for external urls (#8370)
- vite: Invalidate virtual modules with
vite-node
(#8389)
- nuxt: Avoid directly importing
vue-router
inside <NuxtLayout>
(#8421)
- webpack: Print build errors (#8388)
- kit: Use
pathe
to resolve aliases (#8453)
- test-utils: Override
NITRO_PORT
as well (#8458)
- nuxt: Call data refresh hook in parallel (#8470)
- nuxt: Allow responding with custom headers from
error.vue
(#8469)
- schema: Disable early hints by default (#8486)
- kit: Don't require nuxt context when resolving path (#8504)
- nuxt, nuxi: Improve
pages
creation and removal DX (#8502)
- nuxt: Add
vue-router
to optimized deps (#8544)
- vite: Handle all vite middleware routes (#8601)
- nuxt: Pass async-data errors through to client (#8521)
- nuxt: Check before appending comma in composable keys (#8529)
- nuxt: ⚠️ Use parser to generate page metadata (#8536)
- kit: Normalize handler paths (#8626)
- nuxt: Don't force prerender
/
if user doesn't have that route (#8639)
- nuxt: Do not inline global styles in html response (#8666)
- schema: ⚠️ Use strict typescript mode by default (#8667)
- nuxt: Disallow directly rendering error page (#8673)
- Resolve ids to support pnpm (#8671)
- vite: Enable fs strict mode (#8674)
- nuxt: Ensure payload url has no protocol (#8675)
💅 Refactors
- test-utils: ⚠️ Update vitest args (#8325)
- schema: ⚠️ Disable
app.pageTransition
and app.layoutTransition
by default (#8436)
- nuxt: ⚠️ Cleanup schema and split Nuxt 2 types (#8487)
📖 Documentation
- Add route rules to concepts > rendering (#8292)
- Fix broken link (#8319)
- Fix link to documentation guide (#8322)
- Update website-theme to 0.1.7 (dbc2c8ce)
- Add missing opening
<NuxtLayout>
tag in a code sample (#8349)
- Update links for external tools (#8382)
- Update for clarity and fix typos (#8375)
- Add missing
app
key for transitions (#8385)
- api: Add
<ClientOnly>
to API docs (#8400)
- Fix typo (#8427)
- Disable transitions by default as hotfix (#8434)
- Add note about runtime config serialization (#8432)
- Change required node version to be above 16.11 (#8408)
- Use
LinkExample
as block component (#8459)
- Add note about early hints and nginx (#8485)
- Updated bridge migration guide (#8471)
- Mention use case for
<KeepAlive>
in definePageMeta
(#8491)
- Update stability edge banners (#8498)
- Generate docs for unversioned schema (#8535)
- Fix transition wording to include layouts (#8600)
- Add information about type checking to
typescript.typeCheck
config. (#8632)
📦 Build
- pkg: Support Node.js 19 (#8324)
🏡 Chore
- renovate: Ignore monorepo dependency upgrades (f934343b)
- Upgrade vitest to 0.24 (#6764)
- nuxt: Add type for headers (#8326)
- examples: Add missing dependency and script for testing example (#8457)
- Reenable auto-upgrades for vueuse/head (#8506)
- Update nitropack to 0.6.1 (5a43e68e)
✅ Tests
- Add bundle size test (#8133)
- Update type test for strict mode (#8669)
❤️ Contributors
- Adewale Adeyemi
- Anthony Fu
- Christian Burkhart
- Clément Ollivier
- Damian Głowala
- Daniel Roe
- David Stack
- Dawid Stefanko
- Dmitriy
- Farnabaz
- Joel
- Joel Wenzel
- Johann Schopplich
- Johnson Chu
- Josh Deltener
- Julien Huang
- Nils
- Ondřej Misák
- Pascal Sthamer
- Pooya Parsa
- Rajendra
- Sacha STAFYNIAK
- Sébastien Chopin
- Zecka
Compare Source
💬 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.12
and then use npx nuxi@latest cleanup
to cleanup any local caches
⭐ What is New?
📍 Route Rules
RC.12 comes with the first public beta for route rules and hybrid rendering support. Using route rules you can define rules for a group of nuxt routes, change rendering mode or assign a cache strategy based on route! Nuxt server will automatically register corresponding middleware and wrap routes with cache handlers using Nitro caching layer. Whenever possible, route rules will be automatically applied to the deployment platform's native rules (currently Netlify and Vercel are supported).
👉 See docs for examples and more info.
⚗️ Nitropack 0.6
Nitropack upgraded to 0.6 (Release Notes) and h3 upgraded to 0.8 (Release Notes)
⚠️ Breaking changes: Using defineEventHandler()
or eventHandler()
is now required. If you were previously using a Node.js middleware with (req, res, next?)
syntax you need to wrap them with fromNodeMiddleware()
to convert it into an h3 handler.
👦 useHead
updates
This release brings a brand-new version of @vueuse/head
with some significant performance improvements and bug fixes. Check out https://github.com/nuxt/framework/pull/8000 for more details, but in particular:
- Fully-typed usage of
useHead
- No more flickering when transitioning between routes
- Support ordering of head metadata
- Faster head hydration and deduping
⚠️ Breaking changes: The shortcuts viewport
and charset
can only be used within nuxt.config
and not within useHead
directly. For more information on how to update, see https://github.com/nuxt/framework/pull/8000.
⚡ Page Meta
New router options validate
and redirect
are now supported directly in definePageMeta
- so you can perform additional validation for dynamic routes, or implement route redirects directly within pages.
definePageMeta({
// redirect: '/admin',
validate: async (route) => {
const nuxtApp = useNuxtApp()
// Check if the id is made up of digits
return /^\d+$/.test(params.id)
}
})
🌅 Early Hints
Nuxt's node server renderer will now respond with 103 Early Hints before the server renders the app, meaning that you should see a decreased TTFB and earlier resource loading in a supported environment - which at the moment is Chrome with your Nuxt app served over HTTPS with newer than HTTP/1.1.
📖 Nuxt 3 Docs
Nuxt's documentation is now written with Nuxt 3's new theming system and the latest Docus and Content module versions. Check it out at https://v3.nuxtjs.org! Expect more coming soon!
Changelog
compare changes
🚀 Enhancements
- nuxt: Support
redirect
within page metadata (#7746)
- cli: Support
--dotenv
for dev
, build
and preview
commands (#7660)
- nuxt: Allow configuring plugins directory (#7981)
- nuxt: Add default slot to
<NuxtLoadingIndicator>
(#7128)
- pages: Add
validate
hook for definePageMeta
(#7870)
- nuxt: Refresh override for data fetching composables (#7864)
- schema, nuxt: Allow user-configurable
serverDir
(#7868)
- nuxt: Parse html to treeshake client-only components (#7527)
- nuxt: Wrap
#components
client exports with createClientOnly (#7412)
- nuxt: Add
ssr: false
route rule to enable SPA mode (#7938)
- nuxt: Migrate to latest
@vueuse/head
(#8000)
- nuxt: ⚠️ Add
<NuxtPage>
to #components
(#8145)
- nuxt: Add hook debug mode (#7690)
- cli: Add
nuxi build-module
command (#7610)
- schema: Add experimental
routesRules
shortcut (#7954)
- kit: Support plugin array for
addVitePlugin
and addWebpackPlugin
(#8270)
🔥 Performance
- nitro: Respond with early hints in node-based environments (#7893)
- nuxt: ⚠️ Use component loader to add meta components (#8167)
- nuxt: Remove
vue-router
dependency from minimal app (#8188)
- nuxt: Improve link prefetching (#8225)
🩹 Fixes
- nuxt: Export and auto-import
clearNuxtData
(#7710)
- test-utils: Support vitest v0.20.x (#7712)
- cli: Include
workspaceDir
in tsconfig include (#7726)
- cli: Stub
defineNuxtConfig
for nuxi info
(#7728)
- nuxt: Do not warn for non-existent default layout (#7748)
- nuxt: Respect immediate option in
useFetch
(#7720)
- nuxt: Respect
baseURL
when rendering payload path (#7809)
- nuxt: Don't disable scripts in dev mode with experimental
noScripts
(#7745)
- Downgrade Node.js
^16.11.0
requirement to ^16.10.0
(#7865)
- nuxt: Handle schema types for relative module paths (#7946)
- vite: Add type-checker to client build for
ssr: false
(#7930)
- nuxt: Allow auto-import component with same filename (#7713)
- test-utils: Respect
setupTimeout
(#7866)
- nuxt: Fix lazy import of
.client
components (#7422)
- nuxt: Remove fragment from
createClientOnly
(#7774)
- head: Allow using the default slot for script content like noscript (#7858)
- nuxt: Don't prerender
index.html
with a server (#7831)
- docs: Link to api config reference (#8038)
- docs: Link to installation section (#8040)
- nuxt: Page hydration and double load (#7940)
- schema: Declare
untyped
dependency (#8064)
- nuxt: Use correct cache and add baseURL to payload (#7984)
- cli: Replace
lazyHandle
with defineLazyHandler
(#8049)
- schema: Evaluate environment variables when resolving values (#8079)
- vite: Prevent overlap between vite assets and app routes (#7989)
- nuxt: Don't inline styles for per-request
ssr: false
(#8106)
- nuxt: ⚠️
refresh
to override previous requests by default (#8190)
- nuxt: Enable router when
app/router.options.ts
file is present (#8193)
- kit: Log module id to the console when import fails (#8198)
- nuxt: Avoid head dom update on same route click (#8206)
- webpack: Add global to new line (#8226)
- schema: RouteRules config (#8252)
- cli: Don't include
workspaceDir
in tsconfig by default (#8256)
- nuxt: Avoid preloading external routes (#8255)
- nuxt: Allow disabling early hints (#8264)
- nuxt: Lazy-load entry CSS (#8278)
- nuxt: Ignore cache rules for middleware and errors (#8291)
💅 Refactors
- nuxt: Use
unref
in layout.ts
(#7818)
- nuxt: Use
unref
in fetch.ts
(#7813)
- nuxt: Deprecate
<Script>
component tag in template (#8197)
- nuxt: Use
writeEarlyHints
from h3
(#8245)
- nuxt: Use
getRouteRules
from nitropack (#8251)
📖 Documentation
- getting-started: Fix typo in views (#7687)
- getting-started: Configuration page (#7689)
- Recommend to not overwrite some keys in tsconfig (#7717)
- directory-structure: Fix typo in server (#7752)
- navigate-to: Use await instead of return (#7734)
- error-handling: Fix
useError()
type definition (#7749)
- migration: Restructure upgrade guide (#7730)
- Document nitro hooks (#7782)
- roadmap: Update the release times for v2 and v3 (#7808)
- guide: Add nitro plugins to server directory (#7780)
- roadmap: Remove not working link from
nuxt/auth
(#7781)
- Updated nuxt bridge migration guide (#7775)
- Merge deployment pages in getting started (#7765)
- Add newline at end of sass import (#7810)
- examples: Optimize writing of
: ?
(#7928)
- Update
definePageMeta
docs (#7888)
- Use nuxt 3 and website theme (#5479)
- getting-started: Add
transitions
page (#7987)
- Fix path of nuxt config (#8021)
- introduction: Add nuxt key features to the introduction (#8013)
- transitions: Add poster for videos (99907dbf)
- Fix netlify redirects (#8028)
- Use
webp
for 3D gem asset (93c3f30b)
- Upgrade docus (aef32577)
- Upgrade docus to fix docsearch input focus (fc2d74a2)
- Update to
[email protected]
(3218356d)
- Fix indentation in "Views" code blocks (#8039)
- Fix more redirect issues (#8045)
- example: Replace useQuery to getQuery (#8047)
- Fix code highlighting (#8057)
- Add recommendation for controlling plugin registration order. (#8096)
- Add back deleted sections in
definePageMeta
(c804daa0)
- Update line number for
NuxtHooks
source (#8128)
- Fix typo (#8129)
- Update badges color (bc3016f8)
- Add app.config route to pre-render (#8131)
- Clarify access of RuntimeConfig with Options API (#8147)
- Close alert (#8157)
- Fix 404 page (#8136)
- Use
RouterConfig
interface in examples (#8151)
- Add support for WEBSITE_THEMe env variable (6ad0f3f1)
- Update route middleware link (#8196)
- Adds missing quote in example code (#8209)
- Fix
validate
example (#8231)
- Change deprecated
useBody
with readBody
(#8266)
- Add spacing between multiple
button-link
(#8275)
- Add cleavr to supported hosting providers (#8285)
🌊 Types
- Include
nuxt-link
target types (#8172)
🏡 Chore
- Use pnpm for framework monorepo (#7895)
- Add start command for stackblitz codeflow (#8279)
⚠️ Breaking Changes
- nuxt: ⚠️ Add
<NuxtPage>
to #components
(#8145)
- nuxt: ⚠️ Use component loader to add meta components (#8167)
- nuxt: ⚠️
refresh
to override previous requests by default (#8190)
❤️ Contributors
- Alex
- Alex C
- Alexander Lichter
- Andrew Mudrov
- Anish Ghimire
- Anthony Fu
- AuroraTea
- Barbapapazes
- Benicio Cardozo
- Chenying
- Christian Preston
- Cinob
- Clément Ollivier
- Cupid Valentine
- Damian Głowala
- Daniel Kelly
- Daniel Roe
- Daniil Chudo
- Fumihiro-Yano
- Harlan Wilton
- Israel Ortuño
- James Ray
- Josh Deltener
- Julien Huang
- Krutie Patel
- Lov
u
e
- Martin Benndorf
- Miketromba
- MiniDigger
- Mmis1000
- Niklas
- Pooya Parsa
- Rajendra
- Randy
- Reinier Kaper
- Sébastien Chopin
- Tech Genius
- Tobias Diez
- Toni
- Tuğberk Kılıç
- Won-hyeok Jung
- Xezard
- Yaël Guilloux
- Yu Yamazaki
- 菜狗
Configuration
📅 Schedule: Branch creation - At any time (no schedule defined), Automerge - At any time (no schedule defined).
🚦 Automerge: Enabled.
♻ Rebasing: Whenever PR is behind base branch, or you tick the rebase/retry checkbox.
👻 Immortal: This PR will be recreated if closed unmerged. Get config help if that's undesired.
- [ ] If you want to rebase/retry this PR, check this box
This PR has been generated by Mend Renovate. View repository job log here.