Problems we need to solve:

Adding an existing (PROD) site domain to vercel

Adding a beta testing site domain (UAT) to vercel

Sites:

• https://www.29signals.org

• https://uat.29signals.org

Requirements

• You must have an existing Vercel/GitHub project(s) and have a purchased domain name
• You must have the ability to edit Domain Settings with your DNS Provider
• You must have the ability to self-manage your DNS custom configuration settings

Add a custom domain for Production Site

Assumes a production site repo exists on GitHub and has been added to Vercel as a project.

1. From the project dashboard, select Settings, then Domains
2. Add the Domain name, then click Add
3. A pop-up box will provide three ways to add your domain with a recommended default option
4. Click Add

Adding Custom DNS settings with your DNS Provider

1. There are now two boxes with red x's
2. One requires setting adding a new A record with your DNS Provider
3. Another, requires a CNAME will handles your www host calls

Host name: your.domain.com Type A TTL: 1 hour or 3600 Data IP: xxx.xxx.xxx.xxx

Those two boxes should now have checked circles with a notice about propagation time

Assigning a subdomain to a Vercel Project

1. Create a new project and assign a GitHub repo
2. Follow the instructions for adding a custom domain and give it a subdomain name
3. In the pop-up box, make sure to select the exact subdomain name, do not use www.mydomain.com or `mydomain.com, select the 3rd option
4. You will be asked to assign a new CNAME, i.e.: uat.mydomain.com
5. Now there is a subdomain associated with your domain.

Ref

• Vercel: Adding a custom domain
• (https://vercel.com/docs/deployments/environments