🌐 Custom Domain Setup - Quick Reference#

Two Methods Available#

Method 1: DNS Settings (Faster! ⚡)#

Time: ~2 minutes
Link: https://dash.cloudflare.com/a23b54e8877a833a1cf8db7765bce3ca/aesthetic.computer/dns/records

Steps:#

1. Open DNS settings
2. Click "Add record"
3. Fill in:
   • Type: CNAME
   • Name: grab
   • Target: aesthetic-grab.aesthetic-computer.workers.dev
   • Proxy: Enabled (orange cloud ☁️)
4. Click Save
5. Wait ~30 seconds
6. Test: curl -I "https://grab.aesthetic.computer/icon/128x128/prompt.png"

✅ Done!

Method 2: Workers Dashboard#

Time: ~5 minutes
Link: https://dash.cloudflare.com/

Method 2: Workers Dashboard#

Time: ~5 minutes
Link: https://dash.cloudflare.com/

Steps:#

1. Go to Workers & Pages
2. Select aesthetic-grab
3. Click Settings → Domains & Routes
4. Click "Add Custom Domain"
5. Enter: grab.aesthetic.computer
6. Save and wait 2-5 minutes

Which Method to Use?#

Use DNS Method (Method 1) if:

• ✅ You want it done faster (30 seconds vs 2-5 minutes)
• ✅ You prefer direct control over DNS
• ✅ You're comfortable with DNS records

Use Workers Dashboard (Method 2) if:

• ✅ You prefer automated setup
• ✅ You don't want to touch DNS directly
• ✅ You're following the feed deployment pattern exactly

Both create the same result! Choose whichever you prefer.

What Gets Created#

Either method creates this DNS record:

Type:    CNAME
Name:    grab.aesthetic.computer
Target:  aesthetic-grab.aesthetic-computer.workers.dev
Proxy:   Enabled (orange cloud)

Verification#

# Test the custom domain
curl -I "https://grab.aesthetic.computer/icon/128x128/prompt.png"

# Expected response:
# HTTP/2 200
# content-type: image/png
# cache-control: public, max-age=3600

✅ If you see 200 OK, the setup is complete!

What Happens Automatically#

DNS Configuration#

Cloudflare creates:

grab.aesthetic.computer → aesthetic-grab.aesthetic-computer.workers.dev (CNAME)

SSL/TLS Certificate#

• Automatic issuance via Let's Encrypt
• Full (strict) encryption mode
• HTTP → HTTPS redirect enabled

Routing#

• All requests to grab.aesthetic.computer/* → worker
• Edge routing (no origin server needed)
• Global CDN distribution

Troubleshooting#

Domain Not Resolving#

Issue: curl: (6) Could not resolve host: grab.aesthetic.computer

Solution: Wait a few more minutes for DNS propagation

Check DNS:

dig grab.aesthetic.computer
nslookup grab.aesthetic.computer

SSL Certificate Error#

Issue: Certificate mismatch or "not secure" warning

Solution:

1. Wait for certificate provisioning (can take 5-10 minutes)
2. Force refresh: Clear browser cache
3. Check Cloudflare SSL/TLS settings

404 Not Found#

Issue: Domain resolves but returns 404

Solution:

1. Verify worker is deployed: wrangler deployments list
2. Check custom domain in Dashboard is pointing to correct worker
3. Try workers.dev URL to verify worker is running

After Setup Complete#

Update PLAN.md#

Mark custom domain task as complete:

- [x] **Configure Custom Domain** ✅
  - Domain: grab.aesthetic.computer
  - SSL: Active
  - DNS: Propagated

Test Production Integration#

# Test on live site
curl -I "https://aesthetic.computer/icon/128x128/prompt.png"

# Should redirect to:
# https://grab.aesthetic.computer/icon/128x128/prompt.png

# Test og:image
curl -s "https://aesthetic.computer/prompt" | grep "og:image"
# Should show: content="https://grab.aesthetic.computer/preview/1200x630/prompt.png"

Monitor Logs#

cd /workspaces/aesthetic-computer/grab
npx wrangler tail

Reference URLs#

Before Custom Domain Setup#

• Worker: https://aesthetic-grab.aesthetic-computer.workers.dev
• Parse.mjs expects: https://grab.aesthetic.computer (hardcoded)
• Status: Worker works but URLs don't match

After Custom Domain Setup#

• Worker: https://grab.aesthetic.computer
• Parse.mjs expects: https://grab.aesthetic.computer
• Status: ✅ Everything matches and works!

Dashboard Quick Links#

Main Dashboard: https://dash.cloudflare.com/a23b54e8877a833a1cf8db7765bce3ca

Worker Settings: https://dash.cloudflare.com/a23b54e8877a833a1cf8db7765bce3ca/workers/services/view/aesthetic-grab/production/settings

Domains & Routes: https://dash.cloudflare.com/a23b54e8877a833a1cf8db7765bce3ca/workers/services/view/aesthetic-grab/production/settings/domains

Completion Checklist#

• Logged into Cloudflare Dashboard
• Navigated to aesthetic-grab worker
• Added custom domain grab.aesthetic.computer
• Waited for DNS propagation
• Verified with curl command
• Tested production integration
• Updated PLAN.md
• Monitoring logs for errors

Estimated Total Time: 5-10 minutes (including DNS propagation)