Upgrade Guide

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.

Feature Comparison

In the table below, there is a quick comparison between 3 versions of Nuxt:

Feature / VersionNuxt 2Nuxt BridgeNuxt 3
Vue223
Stability😊 Stable😌 Semi-stable😊 Stable
Performance🏎 Fast✈️ Faster🚀 Fastest
Nitro Engine❌✅✅
ESM support🌙 Partial👍 Better✅
TypeScript☑️ Opt-in🚧 Partial✅
Composition API❌🚧 Partial✅
Options API✅✅✅
Components Auto Import✅✅✅
<script setup> syntax❌🚧 Partial✅
Auto Imports❌✅✅
webpack445
Vite⚠️ Partial🚧 Partial✅
Nuxi CLI❌ Old✅ nuxi✅ nuxi
Static sites✅✅✅

Nuxt 2 to Nuxt 3

The migration guide provides a step-by-step comparison of Nuxt 2 features to Nuxt 3 features and guidance to adapt your current application.

Nuxt 2 to Nuxt Bridge

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.

Upgrading Nuxt 3

Latest release

To upgrade Nuxt 3 to the latest release, use the nuxi upgrade command.

npx nuxi upgrade

Edge release channel

To use the latest Nuxt 3 build and test features before their release, read the edge release channel guide.