---
ontology: true
type: pattern
domain: hha-workspace
summary: Workspace-side checklist for moving heavyhaulagent.com from the Brain to the Workspace (and the Brain to brain.heavyhaulagent.com)
tags: [domain, switch, runbook, heavyhaulagent.com, brain]
status: active
discovered: 2026-10-18
related: [NAMING-AND-ADDRESSES, INTEGRATION-THREAD]
---

# Address switch — the Workspace's checklist

Decided order (CTO thread, Oct 18; owner: no 30-day notice, the move is internal):
1. The Brain answers on `https://brain.heavyhaulagent.com` (done — health check answers).
2. The Brain posts its request-logging check (nothing else still calls Brain endpoints on heavyhaulagent.com) and a switch date in the CTO thread.
3. Synchron changes its one setting `HHA_BRAIN_URL` to `https://brain.heavyhaulagent.com`.
4. `heavyhaulagent.com` goes to the Workspace (steps below). Owner of steps: the Workspace developer; the Workspace CTO announces each in the CTO thread.

> **Status, Oct 21:** heavyhaulagent.com (and www) already serves the Workspace through Cloudflare, ahead of steps 2–3. Brain paths on the root domain answer 404. The developer was asked who changed it, when and what, and to finish sections B and C. Synchron was told to move HHA_BRAIN_URL to brain.heavyhaulagent.com.

## A. Before switch day (any time after step 1)
- [ ] Workspace: set `HHA_API_BASE_URL=https://brain.heavyhaulagent.com`; test `/api/workspace/health` and one permit reading.
- [ ] Prepare a 301 redirect `heavyhaulgbt.com/*` → `https://heavyhaulagent.com/*` (same path), ready to enable on switch day.
- [ ] List the Brain's public paths still linked from outside (`/static/…`, `/api/livekit/…`, widget scripts) and prepare redirects from `heavyhaulagent.com` to `brain.heavyhaulagent.com` for them (agreed earlier: callers move first; redirects are the safety net).
- [ ] Confirm the old Brain home page and early-access sign-ups are exported/preserved before they are retired (owner decision).

## B. Switch day (after step 3)
- [ ] DNS: point `heavyhaulagent.com` (and `www`) to the Workspace host. **Do not touch MX / SPF / DKIM** (mail records).
- [ ] Workspace settings: `NEXT_PUBLIC_APP_URL=https://heavyhaulagent.com`.
- [ ] Google sign-in: add `https://heavyhaulagent.com` to authorized origins and redirect URIs.
- [ ] reCAPTCHA: add `heavyhaulagent.com` to allowed domains.
- [ ] Supabase Auth: add the new site URL / redirect URLs if used.
- [ ] Email delivery webhook (ZeptoMail): change to `https://heavyhaulagent.com/api/webhooks/zeptomail/…`.
- [ ] Enable the `heavyhaulgbt.com` → `heavyhaulagent.com` redirect (keep heavyhaulgbt.com allowed in staging and during the move).
- [ ] Tell Synchron in the CTO thread: production callback `https://heavyhaulagent.com/api/webhooks/synchron`; checkout success/cancel URLs on heavyhaulagent.com are now live (paid HHA checkouts can start).

## C. Verify (same day)
- [ ] Home page, login by email code and by Google, one trip page per role (broker, carrier dispatch, driver).
- [ ] Upload one permit on a test trip: it reads (state, dates, dimensions, route status).
- [ ] `POST /api/webhooks/synchron` without a signature answers 401.
- [ ] Links in new emails use heavyhaulagent.com.

## D. Rollback
Point DNS back to the previous target and revert `NEXT_PUBLIC_APP_URL`; the Brain keeps working on brain.heavyhaulagent.com either way.
