Nuxt 3 to 4 Migration

Nuxt 4 introduces several new features and improvements, including performance and API consistency improvements.

Codemod supports a mostly automated Nuxt 4 upgrade experience. This page provides tips and resources you may need for a successful migration.

Getting started

Opt in to Nuxt 4

Set compatibilityVersion to match Nuxt 4 behavior:

nuxt.config.ts
export default defineNuxtConfig({
future: {
    compatibilityVersion: 4,
},
})

For more info, please refer to opting in to Nuxt 4.

Run migration codemods

npx codemod@latest nuxt/4/migration-recipe

The recipe includes the following codemods:

For a list of all available codemods, see Codemod Registry.