mirror of
https://github.com/nuxt/nuxt.git
synced 2025-01-31 15:50:32 +00:00
18cf0ba865
Co-authored-by: Sylvain Marroufin <marroufin.sylvain@gmail.com> Co-authored-by: Pooya Parsa <pyapar@gmail.com>
60 lines
2.8 KiB
Markdown
60 lines
2.8 KiB
Markdown
# Introduction
|
|
|
|
## ❓ What is Nuxt?
|
|
|
|
Is it the first time Learning about Nuxt or want to get familiar to the new Concepts or Nuxt 3, then we recommand to read the [Concepts section](/concepts)
|
|
|
|
## 🛠️ Prerequisites
|
|
|
|
Before getting started, please make sure you have installed recommended development software.
|
|
|
|
* **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)]
|
|
|
|
<sup>*</sup> If you already have Node.js installed, check with `node --version` to ensure using `v14` or `v16`.
|
|
|
|
## 🌉 Bridge or Nuxt 3
|
|
|
|
You must decide if you are starting from scratch or upgrading an existing Nuxt 2 project.
|
|
|
|
### 🌱 I am starting a fresh Nuxt project
|
|
|
|
- Enjoy using latest Vue 3
|
|
- All of new composables are available
|
|
- New templating system and conventions are enabled
|
|
|
|
👉 You can go to the [Installation section](/getting-started/installation).
|
|
|
|
### ⬆️ I have an existing Nuxt 2 project
|
|
|
|
If you have an existing Nuxt 2 project, we **strongly recommend** to start migrating your Nuxt 2 project with Bridge module. This way you can try most of new features without opting-in to more breaking changes.
|
|
|
|
- It is risk-free! You can roll back by just commenting out one line in config
|
|
- Makes your project almost ready for nuxt3 migration
|
|
- Enjoy new DX improvements without major rewrites for vue3
|
|
- Use nitro engine for platform agnostic and optimized deployments
|
|
- Help us stabilize nuxt3 and discover flows
|
|
- Bridge is more stable than nuxt3 at the moment for migration
|
|
|
|
👉 You can go to the [Bridge installation section](/getting-started/installation).
|
|
|
|
### ⚖️ Comparation
|
|
|
|
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 | 👎 Slower | 👍 Enhanced | 🔥 Fastest
|
|
Nitro Engine | ❌ | ✅ | ✅
|
|
ESM support | 🌙 Partial | 👍 Better | ✅
|
|
TypeScript | ☑️ Opt-in | 🚧 Faster | ✅
|
|
Composition API | ⚠️ Deprecated | ✅ | ✅
|
|
Components Auto Import | ✅ | ✅ | ✅
|
|
`<script setup>` syntax | ❌ | 🚧 Partial | ✅
|
|
Auto Imports | ❌ | ✅ | ✅
|
|
Webpack | 4 | 4 | 5
|
|
Vite | ⚠️ Partial | 🚧 Partial | 🚧 Experimental
|
|
Nuxi CLI | ❌ Old | ✅ | ✅
|