bengal build

[Versioning] Build all versions in parallel (git mode)

Force Node-based assets pipeline (default: auto-detect based on package.json)

[Versioning] Build only a specific version (git mode)

Delete output directory before building

Path to config file (default: bengal.toml)

Render error placeholders for failed pages and continue; exit 1 if any errors

[Debug] Show debug output and full tracebacks

Deprecated alias for --dev-profile

Shorthand for --profile dev (full observability)

Preview what would be built without writing files to disk

Build environment: 'local' for dev defaults, 'preview' for staging, 'production' for live site

Error output format for editor integrations: 'text' (default) or 'json'

[Debug] Show why each page was rebuilt or skipped during incremental build

[Debug] Output --explain results as machine-readable JSON

[Output] Maximum speed: implies --quiet, disables live progress

[Output] Traditional line-by-line output instead of live progress bar

Force incremental build using cache (default: auto-detect based on cache existence)

[Debug] Write detailed logs to file

Streaming build for memory efficiency (5K+ pages)

Disable Node-based assets pipeline (default: auto-detect)

Force full rebuild ignoring cache (default: auto-detect)

Force sequential processing (bypasses auto-detection)

[Debug] Enable performance profiling, save to file

Build profile: writer, theme-dev, dev

[Debug] Profile template rendering times

[Output] Minimal output — only errors and final summary

Source directory path

Fail on template errors (recommended for CI)

[Output] Output style: dense, ascii, or ci

Use theme developer profile

[Debug] Traceback verbosity: 'full' shows complete stack, 'compact' one-line per frame, 'minimal' exception only, 'off' suppresses

Validate templates before building

[Output] Show per-file build details (incompatible with --quiet, --fast)