Getting started with Nuxt 3 is straightforward.

Nuxt 3 is currently in beta, keep in mind that it is not yet production ready.
Thank you in advance for your understanding πŸ’›

What is Nuxt?

If this is the first time you're learning about Nuxt or you want to get more familiar with Nuxt 3, we recommend you begin by reading the Concepts section .


Before getting started, please make sure you have installed the recommended setup.

* If you already have Node.js installed, check with node --version that you are using v14 or v16.

Nuxt 3 or Bridge?

Next, decide whether to start from scratch or upgrade an existing Nuxt 2 project.

Starting a fresh Nuxt project

Enjoy using Vue 3
All the new composables are available
New templating system and conventions are enabled
Checkout the Installation section .

Migrating a Nuxt 2 project

If you have an existing Nuxt 2 project, we strongly recommend you begin by using Nuxt Bridge. This way you can try most new features while keeping breaking changes to a minimum.

It's risk free! You can always remove the module from your config
Makes your project (almost) ready for Nuxt 3
Enjoy new DX improvements without major rewrites for Vue 3
Use Nitro engine for platform-agnostic and optimized deployments
Help us stabilize Nuxt 3 and discover flaws
Nuxt Bridge is more stable than Nuxt 3 at the moment


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 😬 Unstable
Performance 🏎 Fast ✈️ Faster πŸš€ Fastest
Nitro Engine ❌ βœ… βœ…
ESM support πŸŒ™ Partial πŸ‘ Better βœ…
TypeScript β˜‘οΈ Opt-in 🚧 Faster βœ…
Composition API ⚠️ Deprecated βœ… βœ…
Options API βœ… βœ… βœ… (not recommended)
Components Auto Import βœ… βœ… βœ…
<script setup> syntax ❌ 🚧 Partial βœ…
Auto Imports ❌ βœ… βœ…
Webpack 4 4 5
Vite ⚠️ Partial 🚧 Partial 🚧 Experimental
Nuxi CLI ❌ Old βœ… nuxi βœ… nuxi
Static sites βœ… βœ… 🚧
Edit this page on GitHub Updated at Fri, Oct 15, 2021