Nuxt/docs/content/1.docs/1.getting-started/11.upgrade.md
Sébastien Chopin 90784f79d7
docs: new website design (#9007)
* docs: implement new website theme

* chore: rename dirs

* chore: update build

* lint fix

* chore: update deps

* fix: include node_modules in esbuild step

* chore: update deps

* Update .gitignore

* chore: update theme version

* up

* up

* fix: use svg for illustration

* chore: update to 0.0.12

* chore: force parse5 resolution

* stay with build

* feat: always display first home section

* Update yarn.lock

* chore: update theme

* fix lint

* docs: update home title

* chore: update website theme version

* Update docs/content/0.index.md

Co-authored-by: pooya parsa <pyapar@gmail.com>

* Update docs/content/0.index.md

Co-authored-by: pooya parsa <pyapar@gmail.com>

* up

* chore: bump theme version

* up

* chore: up

* up up and up

* chore: generate

* fix: boolean value

* feat: new images

* update again

* chore: up

* ouep

* chore: up

Co-authored-by: Daniel Roe <daniel@roe.dev>
Co-authored-by: Clément Ollivier <clement.o2p@gmail.com>
Co-authored-by: pooya parsa <pyapar@gmail.com>
2022-11-16 11:04:28 +01:00

2.7 KiB

navigation.icon description
uil:arrow-up Have a Nuxt 2 project to migrate? Use these guides to upgrade your applications to Nuxt 3.

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 / Version Nuxt 2 Nuxt Bridge Nuxt 3
Vue 2 2 3
Stability 😊 Stable 😌 Semi-stable Release candidate
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.

::alert{type=info icon=👉} Migrate from 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.

::alert{type=info icon=👉} Migrate from Nuxt 2 to Nuxt Bridge ::

Upgrading Nuxt 3

Latest release

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

npx nuxi upgrade

Edge release channel

::alert{type=info icon=👉} To use the latest Nuxt 3 build and test features before their release, read the edge release channel guide. ::