Setting up Vercel with a bootmeh.dev subdomain

This guide walks you through pointing your bootmeh.dev subdomain at a Vercel site.

Ensure you have a Vercel site

If you haven't made a Vercel site yet, follow Vercel's getting started docs.

Creating the domain

1. Navigate to your Vercel dashboard. Open the Domains tab in your project's settings, click Add Domain, and enter the bootmeh.dev subdomain you want (e.g. example.bootmeh.dev).

Note: Vercel may offer to redirect example.bootmeh.dev to www.example.bootmeh.dev by default. Disable this — it makes the main subdomain a redirect to a nested one, which requires an extra file. If you do want www.example.bootmeh.dev, repeat step 4 for that subdomain using the records Vercel provides.

2. Once past the Configure Environment and Redirects tab (click Save if unsure), click Continue manually. Copy the TXT verification value — you'll need it in step 5.

3. Fork the is-a.dev repository and create a file in the /domains folder named your-domain.json, replacing your-domain with the subdomain you chose.

4. Paste the following JSON into that file, replacing all values:

{
    "owner": {
        "username": "your-github-username",
        "email": "[email protected]"
    },
    "records": {
        "A": ["216.198.79.1"]
    }
}

Note: The IP address above is an example. Check what records Vercel actually assigned to your domain and use those.

5. Create a second file named _vercel.your-domain.json (same subdomain substitution) with the TXT verification record:

{
    "owner": {
        "username": "your-github-username",
        "email": "[email protected]"
    },
    "records": {
        "TXT": ["insert-TXT-string-you-got-from-vercel-here"]
    }
}

Note: If you want multiple nested subdomains with Vercel, add all TXT verification records to this file.

Make a pull request

Once both files are created, open a pull request to the is-a.dev register repository. After it's merged, your site will be live at your bootmeh.dev subdomain.

If the subdomain still redirects to the bootmeh.dev site after merging, clear your browser cache.