Introduction

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 .

Prerequisites

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.

If you have enabled Take Over Mode or installed the TypeScript Vue Plugin (Volar) you can disable generating the shim for *.vue files:
export default defineNuxtConfig({
  typescript: {
    shim: false
  }
})

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
πŸ‘‰

‍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 😬 Unstable
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 🚧 Experimental
Nuxi CLI ❌ Old βœ… nuxi βœ… nuxi
Static sites βœ… βœ… 🚧
Edit this page on GitHub Updated at Fri, Jan 21, 2022