Hosting Zensical on Cloudflare Pages¶

1. Init your fresh Zensical project locally¶

pip install zensical
zensical new my-docs
cd my-docs
git init
git remote add origin https://github.com/yourusername/my-docs.git
git push -u origin main

2. Connect to Cloudflare Pages (one-time)¶

1. Cloudflare Dashboard → Workers & Pages → Create application → Pages → Connect to Git
2. Authorize GitHub, select your repo
3. Set build settings:
4. Framework preset: None
5. Build command: pip install zensical && zensical build --clean
6. Build output directory: site
7. Click Save and Deploy

3. Add your custom domain¶

Once the first deploy succeeds, go to your Pages project → Custom domains → Set up a custom domain → enter docs.mydomain.me. Since your domain is already on Cloudflare, it adds the DNS record for you automatically.