Have a Nuxt 2 project to migrate? Use these guides to upgrade your Nuxt applications to Nuxt 3 or take the first step in that direction with Nuxt Bridge.
If you are already using Nuxt 3 and want to upgrade to the latest release or test new features before their release, head over to the Upgrading Nuxt 3 section.
In the table below, there is a quick comparison between 3 versions of Nuxt:
|Feature / Version||Nuxt 2||Nuxt Bridge||Nuxt 3|
|Stability||😊 Stable||😌 Semi-stable||😊 Stable|
|Performance||🏎 Fast||✈️ Faster||🚀 Fastest|
|ESM support||🌙 Partial||👍 Better||✅|
|TypeScript||☑️ Opt-in||🚧 Partial||✅|
|Composition API||❌||🚧 Partial||✅|
|Components Auto Import||✅||✅||✅|
|Vite||⚠️ Partial||🚧 Partial||✅|
|Nuxi CLI||❌ Old||✅ nuxi||✅ nuxi|
The migration guide provides a step-by-step comparison of Nuxt 2 features to Nuxt 3 features and guidance to adapt your current application.
If you prefer to progressively migrate your Nuxt 2 application to Nuxt 3, you can use Nuxt Bridge. Nuxt Bridge is a compatibility layer that allows you to use Nuxt 3 features in Nuxt 2 with an opt-in mechanism.
To upgrade Nuxt 3 to the latest release, use the
nuxi upgrade command.
npx nuxi upgrade
To use the latest Nuxt 3 build and test features before their release, read the edge release channel guide.