← Command Center

Root Domain Setup Guide

Enter your details once. Every code block updates automatically.

Your Variables
Step 1 — Supabase: Register the Root Domain

Insert a row into the root_domains table so NowPage recognizes your domain.

Save the returned id — paste it into the Root Domain ID field above.

Step 2 — Supabase: Grant User Access

Give your Supabase user permission to create subdomains on this root domain.

Finding your user ID In the Supabase dashboard, go to Authentication → Users. Click your user to see the UUID. Paste it into the User ID field above.
Step 3 — Vercel: Add Wildcard Domain

Add a wildcard domain so all subdomains route to NowPage.

Option A: Vercel Dashboard

Option B: Vercel CLI

Step 4 — DNS: Point to Vercel

Configure your domain's DNS to point to Vercel. Go to your DNS provider (Cloudflare, Namecheap, GoDaddy, etc.).

For Wildcard Subdomains

For Root Domain (optional)

DNS propagation Changes can take 5 minutes to 48 hours. Usually under 30 minutes. Use dnschecker.org to verify.
Step 5 — NowPage: Create Your First Subdomain

Go to the NowPage dashboard and create your first subdomain.

If the domain shows a warning icon, click "Fix All" to trigger Vercel provisioning. This adds the subdomain to Vercel's routing and provisions an SSL certificate.

Verification After "Fix All", visit in your browser. You should see the NowPage 404 page (which means routing is working — you just need to publish a page).

Troubleshooting

SSL Certificate Not Ready

Vercel provisions SSL automatically. If you see a certificate error, wait 5-10 minutes and try again. The wildcard cert covers all subdomains.

Domain Shows "Misconfigured"

Check that your CNAME record points to cname.vercel-dns.com (not the old alias.zeit.co). Delete any conflicting A records on the wildcard.

"Fix All" Button Not Working

Ensure your VERCEL_TOKEN and VERCEL_PROJECT_ID environment variables are set in your Vercel deployment. The fix-all action calls the Vercel API to add domains.