Migrating to Nuxt v4.0.0-alpha.2
Version v4.0.0-alpha.2 introduces 1 breaking change. This guide details how to update your code.
Released: 6/12/2025
1
Breaking Changes
2
Migration Steps
4
Affected Symbols
⚠️ Check Your Code
If you use any of these symbols, you need to read this guide:
addServerImportscreateClientOnlyuseCookiegenerateBreaking Changes
●Issue #1
The top-level 'generate' option has been removed from the schema. Configuration for static generation should be moved to the appropriate nested configuration blocks.
Migration Steps
- 1Remove 'generate' from the top level of your Nuxt configuration file.
- 2Update project directory structure to align with Nuxt 4 requirements as per the updated documentation.
Release Summary
Nuxt 4.0.0-alpha.2 introduces directory structure updates, removes the top-level generate schema option, and improves scroll behavior alignment with page transitions.
Need More Details?
View the full release notes and all changes for Nuxt v4.0.0-alpha.2.
View Full Changelog