🔍⌘K

Start typing to search docs.

Domain Management

1.0.0

DNS verification, SSL automation, and white-label domains.

On this page
  1. Flow overview
  2. Required records
  3. CLI verification
  4. Troubleshooting
  5. Related docs

Flow overview

  1. Customer enters domain in the dashboard.
  2. Forge CLI creates Vercel project + DNS records.
  3. Customer verifies DNS via forge domain verify <domain>.
  4. SSL cert is issued automatically; domain status updates via Supabase.

Required records

RecordPurpose
CNAMEPoints customer subdomain to the generated Vercel project.
AUsed when mapping apex domains through Vercel + Cloudflare.
TXTStores verification token to prove ownership.

Info

Tokens and verification status live in Supabase tables prefixed by the app slug. Use Forge API to poll status from external systems.

CLI verification

Verify domain
pnpm forge domain verify docs.customer.com --timeout 600
  • Polls Vercel + Supabase until DNS propagates or times out.
  • Writes status back to Supabase so the dashboard reflects progress.

Troubleshooting

View

Ensure the CNAME/A record points to Vercel and remove conflicting records. Use dig docs.customer.com to confirm.