Configure, build, optimize, improve SEO/discovery, and deploy your Bengal site.
What Do You Need?
Configuration
Configuring Bengal with bengal.toml
Performance
Optimize Bengal build performance
Deployment
Deploy your Bengal site to production
Troubleshooting
Common issues and how to resolve them
Build Pipeline
flowchart LR
subgraph Input
A[Content]
B[Config]
C[Theme]
end
subgraph Build
D[Discovery]
E[Content]
F[Rendering]
G[Post-Process]
end
subgraph Output
H[public/]
end
A --> D
B --> D
D --> E
C --> F
E --> F
F --> G
G --> H
Quick Reference
| I want to... | Go to... |
|---|---|
| Configure my site | Configuration |
| Improve metadata, sitemap, feeds, and social sharing | SEO & Discovery |
| Add "Connect to IDE" button for Cursor MCP | Connect to IDE |
| Build OSS vs Enterprise variants | Multi-Variant Builds |
| Build for production | Commands |
| Speed up builds | Performance |
| Generate JSON/LLM output | Output Formats |
| Understand DX hints (Docker, WSL, K8s) | DX Hints |
| Deploy my site | Deployment |
| Fix build errors | Troubleshooting |
Essential Commands
# Development server with live reload
bengal serve # or: bengal s
# Production build (recommended for deployment)
bengal build --environment production --strict
# Fast CI build (parallel, quiet output)
bengal build --fast --environment production
# Validate content before building
bengal validate # or: bengal v
# Clean cache and rebuild from scratch
bengal clean --cache && bengal build