Skip to content

Cloudflare Pages

Cloudflare Pages is the recommended public deployment target for the AIERP docs site.

  • application: pos-v2.aabhat.com
  • documentation: docs.aierp.aabhat.com

Keep those separate so the app and docs can evolve independently.

Project Name

Create the Pages project as:

  • aierp-pos-ui-docs

Build Configuration

Build command

pip install -r requirements-docs.txt
mkdocs build

Output directory

site

Custom Domain

Attach:

  • docs.aierp.aabhat.com

Do not reuse pos-v2.aabhat.com for the documentation site.

Notes For This Repo

  • mkdocs.yml is already configured with site_url: https://docs.aierp.aabhat.com
  • .github/workflows/docs-deploy.yml builds and deploys the docs site through Cloudflare Pages
  • if you later need preview or internal variants, keep this as the public default

Cloudflare Pages Checklist

  1. Create API token in Cloudflare:
  2. My Profile -> API Tokens -> Create Token -> Edit Cloudflare Workers
  3. Get your Account ID from the Cloudflare dashboard sidebar.
  4. Add GitHub Actions secrets:
  5. CLOUDFLARE_API_TOKEN
  6. CLOUDFLARE_ACCOUNT_ID
  7. Create the Pages project:
  8. aierp-pos-ui-docs
  9. Add the custom domain:
  10. docs.aierp.aabhat.com
  11. Let the GitHub Actions workflow publish the built site.
  12. Test navigation, search, Mermaid, and animation JS after deploy.