# Performance URL: /bengal/docs/0.5.0/building/performance/ Section: performance -------------------------------------------------------------------------------- Optimize Build Performance Speed up Bengal with incremental builds, parallel processing, and smart caching. Do I Need This? Note 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 optimizes builds automatically — no configuration required: Parallel processing: Auto-enabled based on page count and CPU cores Incremental builds: Auto-enabled when build cache exists Smart caching: Tracks file changes, dependencies, and parsed content Template dependency tracking: Records per-page template chains; template edits rebuild only affected pages Fast mode: Skips HTML formatting for faster builds (--fast or build.fast_mode) Render-time asset tracking: Tracks assets during template rendering (no HTML parsing) Autodoc AST caching: Caches parsed Python modules to skip AST parsing on subsequent builds # bengal.toml — only needed to override defaults [build] max_workers = 8 # Limit parallel workers (default: auto-detect) 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 15-50x Development Parallel Zero 2-8x Large sites, multi-core Template Deps Zero 5-20x Template edits (selective rebuild) Fast Mode Zero 10-15% CI/CD (skips HTML formatting) Asset Tracking Zero 20-25% Sites with many assets Autodoc Caching Zero 30-40% Sites with autodoc (caches AST parsing) Memory Optimized Zero N/A 5K+ pages Note Note Parallel speedup depends on Python version: 2-3x with standard Python, 6-8x with free-threaded Python 3.14+. Common Commands # Fast mode: quiet output, auto-parallel bengal build --fast # Force full rebuild (skip cache) bengal build --no-incremental # Clear build cache bengal clean --cache # Profile build time (saves to .bengal/profiles/) bengal build --perf-profile # Profile template rendering bengal build --profile-templates Tip Tip Development workflow: Keep bengal serve running — it uses all optimizations automatically. Full builds are only needed for production. -------------------------------------------------------------------------------- Metadata: - Author: lbliii - Word Count: 314 - Reading Time: 2 minutes