Cloudflare Pages Deployment Guide

For: notes.hoffdesk.com
Status: Ready to configure
Tools: wrangler 4.84.0 ✅

Prerequisites (You Need to Do These)

1. Authenticate Wrangler

Run this on titanium-butler:

wrangler login

This will open a browser to authenticate with your Cloudflare account.

2. Create the Pages Project

# Create project (if it doesn't exist)
wrangler pages project create notes-hoffdesk

# Or verify it exists
wrangler pages project list

3. Configure DNS

In Cloudflare Dashboard:
- Go to DNS → Records
- Add CNAME: notes → notes-hoffdesk.pages.dev
- Or custom domain setup during project creation

Deployment Configuration

Option A: Direct Deploy (Recommended for testing)

# Navigate to built blog
cd ~/hoffdesk-api/dist/blog

# Deploy to Cloudflare Pages
wrangler pages deploy . --project-name=notes-hoffdesk --branch=main

Option B: Git-based (Recommended for production)

Create wrangler.toml in ~/hoffdesk-api/:

name = "notes-hoffdesk"
compatibility_date = "2026-04-21"

[site]
bucket = "./dist/blog"

Then in GitHub:
1. Connect repo to Cloudflare Pages
2. Build command: python -m blog.builder --output dist
3. Output directory: dist/blog

What Happens After Deploy

Integration with Existing Deploy

Current deploy goes to /var/www/hoffdesk.com/blog/. We can:

Option 1: Replace with CF Pages (clean break)
Option 2: Dual deploy (CF Pages for public, local for backup)

Next Steps

1. You run: wrangler login
2. Create project: wrangler pages project create notes-hoffdesk
3. I'll deploy: The built files
4. You configure: DNS CNAME in Cloudflare Dashboard

Ready when you are.