# Introduction Getting started with Nuxt 3 is straightforward. ::alert{type=warning icon=π§} Nuxt 3 is currently in beta, keep in mind that **it is not yet production-ready**.<br> 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](/concepts). ## Prerequisites Before getting started, please make sure you have installed the recommended setup. * **Node.js**<sup>*</sup> (latest LTS version) π [[Download](https://nodejs.org/en/download/)] * **Visual Studio Code** π [[Download](https://code.visualstudio.com/)] * **Volar Extension** π [[Download](https://marketplace.visualstudio.com/items?itemName=johnsoncodehk.volar)] * Either enable [**Take Over Mode**](https://github.com/johnsoncodehk/volar/discussions/471) (recommended) * ... or add **TypeScript Vue Plugin (Volar)** π [[Download](https://marketplace.visualstudio.com/items?itemName=johnsoncodehk.vscode-typescript-vue-plugin)] <sup>*</sup> If you already have Node.js installed, check with `node --version` that you are using `v14` or `v16`. ::alert{type=info} If you have enabled **Take Over Mode** or installed the **TypeScript Vue Plugin (Volar)** you can disable generating the shim for `*.vue` files: ```js 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 ::list{type=info} * Enjoy using Vue 3 * All the new composables are available * New templating system and conventions are enabled :: ::alert{icon=π} Checkout the [Installation section](/getting-started/installation). :: ### 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. ::list{type=info} * 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 :: ::alert{icon=π} Checkout the [Bridge installation section](/getting-started/bridge). :: ### β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 | β | β | π§