Performance

Speed up Bengal with incremental builds, parallel processing, and smart caching.

Do I Need This?

Note

Skip this if: Your site builds in under 10 seconds.
Read this if: You have 500+ pages or builds feel slow.

Quick Wins

# bengal.toml
[build]
parallel = true
incremental = true
cache = true

These three settings handle most performance needs automatically.

How Builds Get Faster

flowchart LR A[Change file.md] --> B{Changed?} B -->|Yes| C[Rebuild page] B -->|No| D[Skip] C --> E[Cache result] D --> F[Use cached] E --> G[Output] F --> G

Performance Strategies

Strategy	Effort	Speedup	Best For
Incremental	Zero	10-50x	Development
Parallel	Zero	2-8x	Large sites
Caching	Zero	5-20x	Repeated builds
Content splitting	Medium	Variable	Very large sites

Common Commands

# Force full rebuild
bengal build --no-incremental

# Clear all caches
bengal clean --cache

# Profile build time
bengal build --profile

Tip

Development workflow: Keepbengal serverunning — it uses all optimizations automatically. Full builds are only needed for production.