Manual / Infrastructure / GitHub / Connect GitHub to Cloudflare Pages
Cloudberrie Business & Operations Manual

Connect GitHub to Cloudflare Pages

Authorize Cloudflare, deploy previews, and promote the correct branch to production.

Document: INF-110Type: Guide / SOPStatus: ApprovedOwner: Engineering OperationsVersion: 4.2.0Updated: 2026-07-17

Prerequisites

  • Cloudflare business account secured with MFA.
  • GitHub organization and repository created.
  • Repository pushed successfully.
  • Build command and output directory known.
  • Google Workspace DNS records documented before any domain migration.

Connect the Repository

  1. Sign in to Cloudflare.
  2. Open Workers & Pages.
  3. Create a Pages project and choose Connect to Git.
  4. Authorize the Cloudflare GitHub application.
  5. Grant access only to the Cloudberrie organization and selected repositories where possible.
  6. Select the target repository.
  7. Set production branch to main.
  8. Configure the framework preset, build command, and output directory.
  9. Save and deploy.

Static HTML Settings

Framework presetNone
Build commandLeave blank
Output directory/ or the folder containing index.html

Verification

  • Production deployment succeeds from main.
  • A feature branch or PR produces a preview deployment when supported.
  • The Pages URL loads without missing assets.
  • Cloudflare GitHub App access is limited to necessary repositories.
  • Custom domain work follows the DNS migration runbook.

Operational Rule

GitHub is the deployment source of truth. Do not make untracked production edits outside the repository. Correct the source, commit it, review it, and redeploy.