bianrui-knowledge Architecture
A short architecture note for the personal knowledge base itself.
- Status
- published
- Visibility
- public
- Category
- Project
- Difficulty
- beginner
- Published
- Jun 28, 2026
- Updated
- Jun 28, 2026
System Shape
This project is intentionally static-first:
- Astro renders pages at build time.
- MDX stores notes as durable source files.
- Pagefind builds a local static search index.
- Cloudflare Pages serves the generated
distdirectory. - Cloudflare Access can protect a private subdomain if needed.
Why Static First
The site should be fast, cheap, easy to back up, and safe by default. Server features can move to Cloudflare Workers later, but most knowledge-base workflows do not need a server.
Publishing Boundary
Public builds include only notes with:
visibility: publicstatus: publishedorstatus: evergreen
The build guard checks the generated site for private content leakage before the build is considered valid.
Source Links
Related Notes
Cloudflare Pages Deployment Runbook
A deployment checklist for publishing the knowledge base to Cloudflare Pages and mapping notes.bianrui.net.
Backend and AI Infrastructure Roadmap
A role-readiness roadmap for backend, cloud, data, AI API, and production infrastructure skills.
Why I'm Building an AI Infrastructure Learning OS
A personal operating system for turning backend and AI infrastructure learning into durable, searchable engineering knowledge.
GCP Cloud Run Checklist
A deployment checklist for containerized backend services on Google Cloud Run.
Secrets Management Checklist
A checklist for safely handling API keys, database credentials, and service secrets.