Nuxt/docs/1.getting-started/12.upgrade.md

2.4 KiB

title description navigation.icon
Upgrade Guide Learn how to upgrade to the lastest Nuxt version. i-ph-arrow-circle-up-duotone

Upgrading Nuxt 3

Latest release

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

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.

::read-more{to="/docs/migration/overview"} Check out the guide to migrating from Nuxt 2 to Nuxt 3. ::

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.

::read-more{to="/docs/bridge/overview"} Migrate from Nuxt 2 to Nuxt Bridge ::