# Building

URL: /bengal/docs/building/
Section: building
Description: Build configuration, SEO/discovery, output formats, and deployment

---

> For a complete page index, fetch /bengal/llms.txt.

Configure, build, optimize, improve SEO/discovery, and deploy your Bengal site.

## What Do You Need?

Configuration

Configuring Bengal with bengal.toml

(/bengal/docs/building/configuration/)

Performance

Optimize Bengal build performance

(/bengal/docs/building/performance/)

Deployment

Deploy your Bengal site to production

(/bengal/docs/building/deployment/)

Troubleshooting

Common issues and how to resolve them

(/bengal/docs/building/troubleshooting/)

## 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 (./configuration/)

Improve metadata, sitemap, feeds, and social sharing
SEO & Discovery (./seo/)

Add "Connect to IDE" button for Cursor MCP
Connect to IDE (./connect-to-ide/)

Build OSS vs Enterprise variants
Multi-Variant Builds (./configuration/variants)

Build for production
Commands (../reference/architecture/tooling/cli/#commands)

Speed up builds
Performance (./performance/)

Generate JSON/LLM output
Output Formats (./output-formats/)

Understand DX hints (Docker, WSL, K8s)
DX Hints (./dx-hints/)

Deploy my site
Deployment (./deployment/)

Fix build errors
Troubleshooting (./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 (/docs/building/configuration/)

Configuring Bengal with bengal.toml

4 pages

Performance (/docs/building/performance/)

Optimize Bengal build performance

3 pages

Deployment (/docs/building/deployment/)

Deploy your Bengal site to production

1 page

Troubleshooting (/docs/building/troubleshooting/)

Common issues and how to resolve them

2 pages

AI-Native Output (/bengal/docs/building/ai-native-output/)

How Bengal makes your documentation discoverable, navigable, and policy-compliant for AI agents and RAG pipelines

Connect to IDE (Cursor MCP) (/bengal/docs/building/connect-to-ide/)

Add a one-click "Connect to IDE" button so readers can add your docs as an MCP server in Cursor

DX Hints (/bengal/docs/building/dx-hints/)

Contextual tips for Docker, WSL, Kubernetes, and development environments

Output Formats (/bengal/docs/building/output-formats/)

Generate JSON, LLM-ready text, and other output formats for search and AI discovery

SEO & Discovery (/bengal/docs/building/seo/)

Use Bengal's built-in metadata, sitemap, feeds, social cards, content signals, and output formats to make sites easier to discover