Medical Research Wiki

QUARTZ_PRIVATE_DEPLOYMENT

1 min read

Quartz Private Deployment

This vault is also a private Git repository and Quartz site source.

  • Repo root/source of truth: this existing Obsidian vault folder.
  • Quartz tooling lives in _quartz/.
  • The build command renders the vault root as content: cd _quartz && npm ci && npx quartz plugin install && npx quartz build -d .. -o ../public
  • Generated public/ and node_modules/ are ignored and should not be committed.
  • The deployed site is intended to be protected by Cloudflare Access before sharing links.
  • Preferred deployment: Cloudflare Pages Git integration pulls from the private GitHub repo and builds on Cloudflare. Do not store Cloudflare DNS/Access/custom-domain management tokens in GitHub.
  • GitHub only needs to host the private source repository and grant Cloudflare Pages read/build access via the Cloudflare GitHub app/OAuth connection.

Local build

./scripts/build_quartz.sh

Cloudflare Pages settings

Use Cloudflare Pages → Connect to Git → pbozzay/medical-research-wiki with:

Production branch: main
Root directory: /
Build command: cd _quartz && npm ci && npx quartz plugin install && npx quartz build -d .. -o ../public
Build output directory: public
Environment variable: NODE_VERSION=24

Cloudflare Access/custom domain/DNS should be configured in Cloudflare, not in GitHub.

Graph View