build
🔨 Build the static site.
Generates HTML files from your content, applies templates,
processes assets, and outputs a production-ready site.
Usage
bengal.site.build [OPTIONS]
Options
| Option |
Type |
Default |
Description |
--parallel |
boolean |
True |
Enable parallel processing for faster builds (default: enabled) |
--incremental |
boolean |
— |
Incremental mode: auto when omitted (uses cache if present). |
--memory-optimized |
boolean |
False |
Use streaming build for memory efficiency (best for 5K+ pages) |
--environment, -e |
choice |
— |
Environment name (auto-detects if not specified) |
--profile |
choice |
— |
Build profile: writer (fast/clean), theme-dev (templates), dev (full debug) |
--perf-profile |
path |
— |
Enable performance profiling and save to file (default: .bengal/profiles/profile.stats) |
--profile-templates |
boolean |
False |
Profile template rendering times (shows which templates and functions are slow) |
--clean-output |
boolean |
False |
Delete the output directory before building (useful for CI cache-busting). |
--theme-dev |
boolean |
False |
Use theme developer profile (shorthand for --profile theme-dev) |
--dev |
boolean |
False |
Use developer profile with full observability (shorthand for --profile dev) |
--verbose, -v |
boolean |
False |
Show detailed build output (phase timing, build stats). Does NOT change profile. |
--strict |
boolean |
False |
Fail on template errors (recommended for CI/CD) |
--debug |
boolean |
False |
Show debug output and full tracebacks (maps to dev profile) |
--traceback |
choice |
— |
Traceback verbosity: full | compact | minimal | off |
--validate |
boolean |
False |
Validate templates before building (catch errors early) |
--assets-pipeline |
boolean |
— |
Enable/disable Node-based assets pipeline (overrides config) |
--config |
path |
— |
Path to config file (default: bengal.toml) |
--quiet, -q |
boolean |
False |
Minimal output - only show errors and summary |
--fast |
boolean |
— |
Fast mode: quiet output, guaranteed parallel, max speed (overrides config) |
--full-output |
boolean |
False |
Show full traditional output instead of live progress (useful for debugging) |
--log-file |
path |
— |
Write detailed logs to file (default: .bengal/logs/build.log) |
Arguments
| Argument |
Type |
Required |
Description |
source |
path |
No |
|