gil
5f664546cf
- CLAUDE.md 운영 규칙 - wiki/ 정리된 지식 페이지 (Nuxt + Claude Code) - raw/ 원본 자료 - reference/ Nuxt 4.x 공식 문서 Co-authored-by: Cursor <cursoragent@cursor.com>
45 lines
3.1 KiB
Markdown
45 lines
3.1 KiB
Markdown
---
|
|
title: "nuxt preview"
|
|
description: The preview command starts a server to preview your application after the build command.
|
|
links:
|
|
- label: Source
|
|
icon: i-simple-icons-github
|
|
to: https://github.com/nuxt/cli/blob/main/packages/nuxi/src/commands/preview.ts
|
|
size: xs
|
|
---
|
|
|
|
<!--preview-cmd-->
|
|
```bash [Terminal]
|
|
npx nuxt preview [ROOTDIR] [--cwd=<directory>] [--logLevel=<silent|info|verbose>] [--envName] [-e, --extends=<layer-name>] [-p, --port] [--dotenv]
|
|
```
|
|
<!--/preview-cmd-->
|
|
|
|
The `preview` command starts a server to preview your Nuxt application after running the `build` command. The `start` command is an alias for `preview`. When running your application in production refer to the [Deployment section](/docs/4.x/getting-started/deployment).
|
|
|
|
## Arguments
|
|
|
|
<!--preview-args-->
|
|
| Argument | Description |
|
|
|---------------|------------------------------------------------|
|
|
| `ROOTDIR="."` | Specifies the working directory (default: `.`) |
|
|
<!--/preview-args-->
|
|
|
|
## Options
|
|
|
|
<!--preview-opts-->
|
|
| Option | Default | Description |
|
|
|--------------------------------------|---------|------------------------------------------------------------------------------------------------------------------------------------------------------|
|
|
| `--cwd=<directory>` | | Specify the working directory, this takes precedence over ROOTDIR (default: `.`) |
|
|
| `--logLevel=<silent\|info\|verbose>` | | Specify build-time log level |
|
|
| `--envName` | | The environment to use when resolving configuration overrides (default is `production` when building, and `development` when running the dev server) |
|
|
| `-e, --extends=<layer-name>` | | Extend from a Nuxt layer |
|
|
| `-p, --port` | | Port to listen on (use `PORT` environment variable to override) |
|
|
| `--dotenv` | | Path to `.env` file to load, relative to the root directory |
|
|
<!--/preview-opts-->
|
|
|
|
This command sets `process.env.NODE_ENV` to `production`. To override, define `NODE_ENV` in a `.env` file or as command-line argument.
|
|
|
|
::note
|
|
For convenience, in preview mode, your [`.env`](/docs/4.x/directory-structure/env) file will be loaded into `process.env`. (However, in production you will need to ensure your environment variables are set yourself. For example, with Node.js 20+ you could do this by running `NODE_ENV=production node --env-file .env .output/server/index.mjs` to start your server.)
|
|
::
|