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
In This Section
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
AI-Native Output
How Bengal makes your documentation discoverable, navigable, and policy-compliant for AI agents and RAG pipelines
Connect to IDE (Cursor MCP)
Add a one-click "Connect to IDE" button so readers can add your docs as an MCP server in Cursor
DX Hints
Contextual tips for Docker, WSL, Kubernetes, and development environments
Output Formats
Generate JSON, LLM-ready text, and other output formats for search and AI discovery
SEO & Discovery
Use Bengal's built-in metadata, sitemap, feeds, social cards, content signals, and output formats to make sites easier to discover