gil
5f664546cf
- CLAUDE.md 운영 규칙 - wiki/ 정리된 지식 페이지 (Nuxt + Claude Code) - raw/ 원본 자료 - reference/ Nuxt 4.x 공식 문서 Co-authored-by: Cursor <cursoragent@cursor.com>
117 lines
3.8 KiB
Markdown
117 lines
3.8 KiB
Markdown
---
|
|
title: 'Installation'
|
|
description: 'Get started with Nuxt quickly with our online starters or start locally with your terminal.'
|
|
navigation.icon: i-lucide-play
|
|
---
|
|
|
|
## Play Online
|
|
|
|
If you just want to play around with Nuxt in your browser without setting up a project, you can use one of our online sandboxes:
|
|
|
|
::card-group
|
|
:card{title="Open on StackBlitz" icon="i-simple-icons-stackblitz" to="https://nuxt.new/s/v4" target="_blank"}
|
|
:card{title="Open on CodeSandbox" icon="i-simple-icons-codesandbox" to="https://nuxt.new/c/v4" target="_blank"}
|
|
::
|
|
|
|
Or follow the steps below to set up a new Nuxt project on your computer.
|
|
|
|
## New Project
|
|
|
|
### Prerequisites
|
|
|
|
- **Node.js** - [`20.x`](https://nodejs.org/en) or newer (but we recommend the [active LTS release](https://github.com/nodejs/release#release-schedule))
|
|
- **Text editor** - There is no IDE requirement, but we recommend [Visual Studio Code](https://code.visualstudio.com/) with the [official Vue extension](https://marketplace.visualstudio.com/items?itemName=Vue.volar) (previously known as Volar) or [WebStorm](https://www.jetbrains.com/webstorm/), which, along with [other JetBrains IDEs](https://www.jetbrains.com/ides/), offers great Nuxt support right out-of-the-box. If you use another editor, such as Neovim, you can configure [Vue Language Server](https://github.com/vuejs/language-tools) support by following the [Vue Language Tools setup guides](https://github.com/vuejs/language-tools/wiki).
|
|
- **Terminal** - In order to run Nuxt commands
|
|
|
|
::note
|
|
::details
|
|
:summary[Additional notes for an optimal setup:]
|
|
- **Node.js**: Make sure to use an even numbered version (20, 22, etc.)
|
|
- **Neovim**: When configuring the Vue TypeScript plugin, make sure `location` points to the `@vue/language-server` package directory, not its binary. See the [Neovim setup guide](https://github.com/vuejs/language-tools/wiki/Neovim) for a working configuration.
|
|
- **WSL**: If you are using Windows and experience slow HMR, you may want to try using [WSL (Windows Subsystem for Linux)](https://learn.microsoft.com/en-us/windows/wsl/install) which may solve some performance issues.
|
|
- **Windows slow DNS resolution**: Instead of using `localhost:3000` for local dev server on Windows, use `127.0.0.1` for much faster loading experience on browsers.
|
|
::
|
|
::
|
|
|
|
Open a terminal (if you're using [Visual Studio Code](https://code.visualstudio.com), you can open an [integrated terminal](https://code.visualstudio.com/docs/terminal/basics)) and use the following command to create a new starter project:
|
|
|
|
::code-group{sync="pm"}
|
|
|
|
```bash [npm]
|
|
npm create nuxt@latest <project-name>
|
|
```
|
|
|
|
```bash [yarn]
|
|
yarn create nuxt <project-name>
|
|
```
|
|
|
|
```bash [pnpm]
|
|
pnpm create nuxt@latest <project-name>
|
|
```
|
|
|
|
```bash [bun]
|
|
bun create nuxt@latest <project-name>
|
|
```
|
|
|
|
```bash [deno]
|
|
deno -A npm:create-nuxt@latest <project-name>
|
|
```
|
|
|
|
::
|
|
|
|
::tip
|
|
Alternatively, you can find other starters or themes by opening [nuxt.new](https://nuxt.new) and following the instructions there.
|
|
::
|
|
|
|
Open your project folder in Visual Studio Code:
|
|
|
|
```bash [Terminal]
|
|
code <project-name>
|
|
```
|
|
|
|
Or change directory into your new project from your terminal:
|
|
|
|
```bash
|
|
cd <project-name>
|
|
```
|
|
|
|
## Development Server
|
|
|
|
Now you'll be able to start your Nuxt app in development mode:
|
|
|
|
::code-group{sync="pm"}
|
|
|
|
```bash [npm]
|
|
npm run dev -- -o
|
|
```
|
|
|
|
```bash [yarn]
|
|
yarn dev --open
|
|
```
|
|
|
|
```bash [pnpm]
|
|
pnpm dev -o
|
|
```
|
|
|
|
```bash [bun]
|
|
bun run dev -o
|
|
|
|
# To use the Bun runtime during development
|
|
# bun --bun run dev -o
|
|
```
|
|
|
|
```bash [deno]
|
|
deno run dev -o
|
|
```
|
|
::
|
|
|
|
::tip{icon="i-lucide-circle-check"}
|
|
Well done! A browser window should automatically open for <http://localhost:3000>.
|
|
::
|
|
|
|
## Next Steps
|
|
|
|
Now that you've created your Nuxt project, you are ready to start building your application.
|
|
|
|
:read-more{title="Nuxt Concepts" to="/docs/4.x/guide/concepts"}
|