# 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:

```bash
wrangler login
```

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

### 2. Create the Pages Project

```bash
# 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)

```bash
# 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/`:

```toml
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

| URL | What |
|-----|------|
| `notes-hoffdesk.pages.dev` | Default Pages URL |
| `notes.hoffdesk.com` | Your custom domain (after DNS) |
| `hoffdesk.com/blog/*` | If you want path-based routing |

---

## 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.