bengal.site.build

Build all versions in parallel (git mode only)

Enable/disable Node-based assets pipeline (overrides config)

Build only a specific version (git mode only, e.g., 0.1.6)

Delete the output directory before building (useful for CI cache-busting).

Path to config file (default: bengal.toml)

Launch interactive Textual dashboard (experimental)

Show debug output and full tracebacks (maps to dev profile)

Preview build without writing files (shows what WOULD happen)

Environment name (auto-detects if not specified)

Show detailed incremental build decision breakdown (why pages are rebuilt/skipped)

Output --explain results as JSON (for tooling integration)

Fast mode: quiet output, guaranteed parallel, max speed (overrides config)

Show full traditional output instead of live progress (useful for debugging)

Incremental mode: auto when omitted (uses cache if present).

Write detailed logs to file (default: .bengal/logs/build.log)

Use streaming build for memory efficiency (best for 5K+ pages)

Force sequential processing (bypasses auto-detection). Use for debugging or benchmarking.

Enable performance profiling and save to file (default: .bengal/profiles/profile.stats)

Build profile: writer (fast/clean), theme-dev (templates), dev (full debug)

Profile template rendering times (shows which templates and functions are slow)

Minimal output - only show errors and summary

Fail on template errors (recommended for CI/CD)

Traceback verbosity: full | compact | minimal | off

Use developer profile with full observability (shorthand for --profile dev)

Use theme developer profile (shorthand for --profile theme-dev)

Validate templates before building (catch errors early)

Show detailed build output (phase timing, build stats). Does NOT change profile.