# preview

URL: /bengal/cli/preview/
Section: cli
Description: Build and serve completed output

---

> For a complete page index, fetch /bengal/llms.txt.

Open LLM text
(/bengal/cli/preview/index.txt)

Share with AI

Ask Claude
(https://claude.ai/new?q=Please%20help%20me%20understand%20this%20documentation%3A%20%2Fbengal%2Fcli%2Fpreview%2Findex.txt)

Ask ChatGPT
(https://chatgpt.com/?q=Please%20help%20me%20understand%20this%20documentation%3A%20%2Fbengal%2Fcli%2Fpreview%2Findex.txt)

Ask Gemini
(https://gemini.google.com/app?q=Please%20help%20me%20understand%20this%20documentation%3A%20%2Fbengal%2Fcli%2Fpreview%2Findex.txt)

Ask Copilot
(https://copilot.microsoft.com/?q=Please%20help%20me%20understand%20this%20documentation%3A%20%2Fbengal%2Fcli%2Fpreview%2Findex.txt)

Command

#
`bengal preview`

Build and serve completed output

15Options

## Usage

BASH

```
bengal preview [OPTIONS]
```

## Options

Option
Type
Description

`--auto-port`

flag

`BOOLEAN`

Find available port if specified port is taken

`--config`

`STRING`

Path to config file (default: bengal.toml)

`--debug`

flag

`BOOLEAN`

Show debug output and full tracebacks

`--environment`

`STRING`

Environment: local, preview, production

Default:`preview`

`--host`

`STRING`

Server host address

Default:`localhost`

`--incremental`

flag

`BOOLEAN`

Use incremental build cache before previewing

`--open-browser`

flag

`BOOLEAN`

Open browser after server starts

`--port`

`INTEGER`

Server port number

Default:`5173`

`--profile`

`STRING`

Config profile: writer, theme-dev, dev

`--source`

`STRING`

Source directory path

`--strict`

flag

`BOOLEAN`

Fail preview build on validation errors

`--style`

`STRING`

Output style: dense, ascii, or ci

Default:`dense`

`--traceback`

`STRING`

Traceback verbosity: full | compact | minimal | off

`--verbose`

flag

`BOOLEAN`

Show detailed build and server activity

`--yes`

flag

`BOOLEAN`

Skip free-threading confirmation (for CI/automation)