Cloudflare Pages Deployment Runbook

Goal

Deploy this Astro knowledge base as a static Cloudflare Pages site. Use notes.bianrui.net or learn.bianrui.net as a subdomain under the existing bianrui.net domain.

Build Settings

• Framework preset: Astro
• Build command: pnpm build
• Output directory: dist
• Package manager: pnpm
• Node version: 22 or newer

Cloudflare Pages Setup

1. Create a Cloudflare Pages project from the GitHub repository.
2. Set the build command to pnpm build.
3. Set the output directory to dist.
4. Add the custom domain notes.bianrui.net.
5. Confirm Cloudflare creates the required DNS record.

Existing Domain Context

bianrui0315/bianrui0315.github.io is already connected to bianrui.net through Cloudflare. This knowledge base can live on a subdomain while the primary site remains separate.

Privacy Modes

Public Static Mode

Use this for the default Cloudflare Pages deployment. Private and draft notes are not routed.

pnpm build

Protected Private Mode

For truly private deployed notes, create a separate Pages project or subdomain such as notes.bianrui.net, then protect it with Cloudflare Access.

Recommended Access policy:

• Application type: Self-hosted
• Domain: notes.bianrui.net
• Identity provider: Google or one-time PIN
• Policy: Allow only Rui’s email

Preflight

• No private content appears in dist.
• pnpm guard:public passes.
• Search index exists at dist/pagefind.
• RSS exists at /rss.xml.
• Sitemap exists at /sitemap-index.xml.

Rollback

Use Cloudflare Pages deployment history to promote the last known-good build.