v3.9.0

[github-actions]

3.9.0 is the next minor release.

Timetable: to be announced.

👉 Changelog

compare changes

🚀 Enhancements

• nuxt: Warn when page uses a layout without <NuxtLayout> (#24116)
• kit: Support prepend option for addComponentsDir (#24309)
• kit: Allow customising logger options (#24243)
• nuxt: Allow readonly option for useCookie (#24503)
• nuxt: Add path to error.data when throwing 404 errors (#24674)
• kit: Load /module or /nuxt module subpath if it exists (#24707)
• nuxt: Layers support for spa loading template (#24709)
• nuxt: Expose refresh on islands and server components (#24261)
• nuxt: Add dedupe option for data fetching composables (#24564)
• vite: Replace browser globals with undefined on server (#24711)
• nuxt: Allow plugins to specify dependencies (#24127)
• kit: Add new addServerScanDir composable (#24001)
• nuxt: Transform setup within defineComponent options (#24515)
• nuxt: Allow customising fallback layout (#24777)
• nuxt: useRequestHeader utility (#24781)
• nuxt: Move loading api behind hooks (#24010)
• nuxt: Add callOnce util to allow running code only once (#24787)
• nuxt: Allow client components within NuxtIsland (#22649)
• schema: Default to bundler module resolution (#22821)
• kit,nuxt,vite,webpack: Add toArray util (#24857)

🔥 Performance

• vite: Avoid duplicate resolve operation (#24736)
• nuxt: Avoid duplicate iterations over layers (#24730)
• kit: Avoid duplicate join operation (#24717)
• vite: Simplify manifest property acccess (#24715)
• nuxt: Don't dedupe fewer than two middleware/plugins (#24718)
• schema: Avoid duplicate get operations (#24734)
• schema: Use parallel promises (#24771)
• nuxt: Avoid duplicate useRuntimeConfig call (#24843)
• vite: Avoid duplicate JSON.stringify operation (#24848)

🩹 Fixes

• nuxt: Avoid recursive ssr errors (#24399)
• nuxt: Improve path resolve for import.d.ts (#24413)
• nuxt: Remove experimental reactivityTransform (vue 3.4) (#24477)
• nuxt: Ignore manifest when prerendering (#24504)
• nuxt: Don't strip literals from template in <DevOnly> (#24511)
• vite: Use isBuiltin polyfill for greater node support (#24512)
• nuxt: Island components with number prefix (#24469)
• nuxt: Use consistent annotations for tree-shaking (#24514)
• nuxt: Skip prerendering all pages in hash mode (#24517)
• nuxt: Skip router middleware/redirections for islands (#24421)
• nuxt: Remove trailing slash before checking if prerendered (#24516)
• nuxt: Skip check for <NuxtLayout> usage in islands (#24529)
• vite,webpack: Don't add type checker/analyzer when testing (#24608)
• nuxt: Do not try auto-install outside of a Nuxt context (#24605)
• nuxt: Merge and apply layer hooks (#24639)
• nuxt: Only add/remove trailing slash for http protocols (#23296)
• nuxt: Ensure error in useAsyncData has correct type (#24396)
• nuxt: Add appManifest middleware after modules run (#24786)
• nuxt: Revert async transform of setup within defineComponent (#24784)
• nuxt: Eager load island components map (#24584)
• nuxt: Register override hooks separately (#24833)
• nuxt: Add __VUE_PROD_HYDRATION_MISMATCH_DETAILS__ (#24836)
• kit: Auto-detect mode from filePath for addComponent (#24835)
• schema: Revert bundler module resolution due to lack of support (22ce98d61)
• kit: Don't add local ~/modules dirs to modulesDir (#24457)

💅 Refactors

• nuxt: Use defineComponent to infer prop types for router-link stub (dc0e8347b)
• nuxt: Opt-in to future jiti.import for schema (#24526)
• nuxt: Remove process.* usage in nuxt vue app (#24749)
• schema: Introduce future and features namespace (#24880)

📖 Documentation

• Fix typo (#24395)
• Update code to show how to enable typedPages (#24436)
• Add defineNuxtConfig to deployment example (#24451)
• Update link to more info about key/keepalive (1b1cc4f4e)
• Update Nuxt 2 EOL date in roadmap (#24602)
• Prefer ~ to @ alias in examples (#24574)
• Fix typo (6a1c05401)
• Warn about using differently names env variables (#24612)
• commands: Add tunnel option (50d46f068)
• Add file name to code block (#24620)
• Remove linking to nuxt-themes org (6f44e9470)
• Update yarn -o option to --open (#24644)
• Add alt text for roadmap img tags (1f1049858)
• Add missing props for <NuxtPage> (#24675)
• Add more info about custom serialize/revive (#24680)
• Fix grammar (#24737)
• Add documentation on getCachedData option (#24697)
• Fix addServerScanDir example (7cd02e290)
• Add panda css to styling guide (#24178)
• Highlight the possibility of middleware to return nothing (#24241)
• Setting middleware at build time (#23480)
• Remove deprecated loadNuxt options (#24201)
• Improvements on data-fetching (6d50b4744)
• Add documentation for nuxi module (#24790)
• Update return for useFetch and useAsyncData Explain returns for composables in data fetching guide #24407 (#24775, #24407)
• Add docs for runtime test environment (#24658)
• Update example test snapshots to remove escapes (5de779a7d)
• Add addComponentsDir example to modules author guide (#24876)

🏡 Chore

• Update variable in release scripts (258b8a706)
• Import types from '#app' (#24418)
• Update markdownlintignore (1abb5479c)
• Update vitest dependencies (#24659)
• Pin rollup to v4 (#24814)
• nuxt: Add return type for entry (#24821)
• Use dev:prepare instead of build:stub (802b3e28c)

✅ Tests

• Re-enable accidentally disabled unit tests 🙈 (b443de230)
• Add basic benchmark tests (#24846)
• Update vitest coverage exclusions (a46b0c876)

🤖 CI

• Don't skip releases based on commit body (#24554)
• Label pull requests based on their target branch (#24468)
• Update options for GitHub app token generation (#24565)
• Notify nuxt/bridge when composables change (#24752)
• Don't run benchmark on main commits by default (064615e8c)
• Temporarily disable codspeed (a39d311d3)

❤️ Contributors

• Daniel Roe daniel@roe.dev
• Damian Głowala (@DamianGlowala)
• Isaac Qadri
• Michael Brevard yonshi29@gmail.com
• Bobbie Goede bobbiegoede@gmail.com
• Becem becem.gharbi@live.com
• Julien Huang julien.huang@outlook.fr
• Sébastien Chopin (@Atinux)
• Harlan Wilton (@harlan-zw)
• Victor Akintunde
• Nathanaël Labreuil
• Ryota Watanabe
• Michael Cole github@michaelcole.com
• Kekeocha Justin Chetachukwu
• Ewen Quimerc'h
• Abraham (@anubra266)
• Luke Nelson luke@nelson.zone
• Eugen Guriev (@theguriev)
• Chris Bailey
• Alper Doğan
• Jamie Trip jamietrip@hotmail.nl
• Alexander Lichter (@manniL)
• Idorenyin Udoh (@idorenyinudoh)
• Phojie Rengel (@phojie)
• GJSSSS (@gjssss)
• Xxhls (@xxhls)
• Marco Solazzi marco.solazzi@gmail.com
• Lehoczky Zoltán (@Lehoczky)
• RoiLeo medina.leo42@gmail.com
• Daniel Acuña
• Sadegh Barati (@sadeghbarati)
• Anthony Fu anthonyfu117@hotmail.com
• Kostis Maninakis
• Pooya Parsa pyapar@gmail.com
• MaxMonteil

[stackblitz]

Run & review this pull request in StackBlitz Codeflow.

[productdevbook]

how to install this version ?

[renardsas]

how to install this version ?

When version 3.9 is ready, you can simply run nuxi upgrade (upgrade).
Currently, there is no announced timeline for the release of 3.9. However, when it is ready, it is usually accompanied by a blog post (see version 3.8 - blog - 3.8).

[productdevbook]

how to install this version ?

When version 3.9 is ready, you can simply run nuxi upgrade (upgrade). Currently, there is no announced timeline for the release of 3.9. However, when it is ready, it is usually accompanied by a blog post (see version 3.8 - blog - 3.8).

I need to install and test it before, it might be released as a separate npm package

Nightly Channel

[huang-julien]

note: Breaking change due to #24477 and vue 3.4 for reactivity transform

[madsh93]

how to install this version ?

When version 3.9 is ready, you can simply run nuxi upgrade (upgrade).

Currently, there is no announced timeline for the release of 3.9. However, when it is ready, it is usually accompanied by a blog post (see version 3.8 - blog - 3.8).

Isn't nuxi upgrade --force the recommended way?

[chenyuncai]

it seems inlineSSRStyles config was removed

[manniL]

@chenyuncai it was moved, not removed - see #24880