Hosting

The docs are a static MkDocs site. The source files are Markdown under docs/, and the site builds into site/.

Local Development

python3 -m venv .venv
. .venv/bin/activate
pip install -r requirements.txt
mkdocs serve

mkdocs build --strict

Cloudflare Pages can host this site directly from the GitHub repository. Use:

Production branch: master
Build command: pip install -r requirements.txt && mkdocs build --strict
Build output directory: site
Root directory: /

The repo includes runtime.txt to pin Python for Cloudflare Pages builds.

The repository includes:

docs/CNAME

with:

docs.bloom.directory

In Cloudflare Pages, add docs.bloom.directory as the custom domain for the Pages project. Cloudflare will guide the DNS record setup.