Developer handover · 20 Nov 2026
Releasing heptabridge.com
Everything needed to host the new Heptabridge website and point the domain at it. The source code comes as a zip from the owner, with this same guide inside as HANDOVER.md.
- Next.js 16.4.6
- Static export → out/
- Host: Cloudflare Pages
- Secrets in code: none
Where things stand
- The site is finished and builds cleanly. It has not been released. heptabridge.com still points at Northwest.
- It is a fully static site: no server, database or API routes.
npm run buildwrites plain files toout/. - The only outside connection is the "free check" form. It posts straight from the browser to HubSpot (EU data centre).
- Three owner details are still missing and the legal pages are drafts. You can host before they arrive, but don't release publicly until the owner says so.
Owner inputs before release
All in lib/site.ts. While a value is null, the site shows a visible bracketed placeholder.
| Field | Shown in | Status |
|---|---|---|
supportEmail | Footer, Privacy, Terms, Refund policy | Waiting |
postalAddress | Footer, Privacy | Waiting |
bookingUrl | "Pick a time" button on /book (HubSpot meetings link) | Waiting |
The legal pages (/privacy, /terms, /refund-policy) show "Draft for lawyer review. Not yet in force." from components/LegalPage.tsx. Remove that line only after the owner confirms a lawyer approved the text. Rebuild and redeploy after any edit.
Build
Node 20.9 or newer (built and tested on Node 24).
npm ci npm run build
Output is out/: about 98 files, under 2 MB. Pages export as about.html and so on, and Cloudflare Pages serves them at clean URLs (/about). For a local preview, run npm run dev and open http://localhost:3000.
Next.js was updated from 16.4.3 to 16.4.6 on 20 Nov to clear npm advisories, and npm audit now reports 0. None of those advisories affected a static export.
Hosting on Cloudflare Pages
Chosen because the free plan allows commercial use, public/_headers works with no extra config, and it is fast globally. Northwest's plan is WordPress-only, and Vercel's free plan is non-commercial only.
Option A: upload from your machine (simplest)
npx wrangler login npx wrangler pages project create heptabridge --production-branch main npx wrangler pages deploy out --project-name heptabridge --branch main
Option B: connect a Git repo
| Build command | npm run build |
| Build output directory | out |
| Environment variable | NODE_VERSION = 24 |
Either way, the project lives in the owner's Cloudflare account. Ask the owner to invite you as a member rather than sharing a password. The temporary heptabridge.pages.dev address is kept out of search engines by a rule in _headers.
Domain and DNS
Registered at Northwest, with a transfer lock on. Do not transfer the domain. Only the DNS changes.
The domain has live email at Northwest. MX, SPF, DMARC and any DKIM records must survive the switch, or company email stops or lands in spam.
Live DNS on 20 Nov 2026
| Record | Value |
|---|---|
| NS | ns1/ns2.hosting.businessidentity.llc |
A @, www | 66.223.49.89 (current Northwest site) |
MX @ | mailserver.businessidentity.llc, priority 10 |
TXT @ | v=spf1 a mx include:spf.postal.businessidentity.llc ~all |
TXT _dmarc | v=DMARC1; p=quarantine; rua=mailto:bounce@dmarc.businessidentity.llc; ruf=mailto:bounce@dmarc.businessidentity.llc; fo=1 |
Recommended: move DNS to Cloudflare (free)
- In Cloudflare, add the site
heptabridge.comon the Free plan and let it scan the records. - Ask Northwest for a full zone export and compare. The scan can miss DKIM (
selector._domainkeyTXT records), so add anything missing by hand. - Keep every mail record DNS only (grey cloud).
- If DNSSEC is on at Northwest, turn it off first.
- Ask Northwest to switch to the two Cloudflare nameservers. Their support chat can do it.
- When the zone is active, go to Pages →
heptabridge→ Custom domains and addheptabridge.comandwww.heptabridge.com. - Redirect
wwwto the bare domain with a 301 Redirect Rule. The canonical URL in the code ishttps://heptabridge.com. - Send a test email to and from a heptabridge.com address.
Alternative: keep DNS at Northwest
Point www at heptabridge.pages.dev with a CNAME. Pages can't serve the bare domain unless the zone is on Cloudflare, so the bare domain would need a forward to www at Northwest, if they offer one. In that case, set site.url to https://www.heptabridge.com.
The form (HubSpot)
lib/submitCheck.tsposts tohttps://api-eu1.hsforms.com/submissions/v3/integration/submit/149069309/0397b2ec-275e-4a8a-b326-bd178ff8b7f3.- Portal and form IDs are public by design. There are no API keys or secrets in the project.
- HubSpot form "Website Missed-Call Check" (portal 149069309, EU1). Fields: firstname, company, email, phone,
hb_niche,hb_consent_source,hb_sms_consent. - Spam protection is a hidden honeypot field only, with no CAPTCHA or rate limit.
- After release, submit one test from the live site. The owner confirms it in HubSpot and deletes it.
- Adding analytics, chat or an embedded booking widget means adding its domains to the CSP in
public/_headers, or the browser blocks it.
Release checklist
Content rules
Don't change copy without the owner.
- No prices, testimonials or client logos, and no invented results.
- No "coming soon" labels. Every service is presented as available.
- Clinic pages never claim blanket "HIPAA compliant" and never offer billing, prior authorisation or medical scribes.
- Brand: navy
#10233F, Bridge Blue#2563B9, Sky#5B9BEF, Montserrat. Logo files are inpublic/.
Map of the code
| Path | What it is |
|---|---|
lib/site.ts | Company details, nav, HubSpot IDs |
lib/content.ts | The seven leaks, bundles and the full service list (one source for every page) |
lib/submitCheck.ts | Form submission |
app/*/page.tsx | One folder per page |
components/home/ | Homepage sections and logo animation (logo-motion.js) |
components/pages/ | Page visuals: clinic day arc, job route, no-show maths |
public/_headers | Production security headers |
What was tested
| 31 Oct | Local production build: all pages and links, logo animation, reduced motion, headers on a Cloudflare-style server, phone width, and one real form submission that reached HubSpot. |
| 20 Nov | After the Next.js update: rebuild passed, and the homepage, Capabilities and Book pages load with no console errors. |
| Not yet | On Cloudflare's servers, on real phones, or with the final owner details filled in. |