Upgrade Guide
Learn how to upgrade to the latest Nuxt version.
Upgrading Nuxt 3
Latest release
To upgrade Nuxt 3 to the latest release, use the nuxi upgrade
command.
Terminal
npx nuxi upgrade
Nightly Release Channel
To use the latest Nuxt 3 build and test features before their release, read about the nightly release channel guide.
Nuxt 2 vs Nuxt 3
In the table below, there is a quick comparison between 3 versions of Nuxt:
Feature / Version | Nuxt 2 | Nuxt Bridge | Nuxt 3 |
---|---|---|---|
Vue | 2 | 2 | 3 |
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 | โ | โ | โ |
webpack | 4 | 4 | 5 |
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.