Setting up Cloudflare Pages with an is-a.dev subdomain

This guide will walk you through the process of setting up a Cloudflare Pages website and pointing your is-a.dev subdomain towards it.

Create a Cloudflare Pages Website

First, you'll need to create a website on Cloudflare Pages. Follow the instructions in the Cloudflare Pages Getting Started Guide.

Point your subdomain to your Cloudflare Pages site

Next, you'll need to point your is-a.dev subdomain to your Cloudflare Pages website. Follow the instructions in the Cloudflare Pages Custom Domains Guide. Only follow the "Add a custom domain" section, and then return to this guide for the next steps.

Create the Domain File

In the domains directory, create a new JSON file for your subdomain (domains/subdomain.json) and submit a pull request. This file should contain the following:

{
    "owner": {
        "username": "your-github-username",
        "email": "your-email@example.com"
    },
    "records": {
        "CNAME": "your-sitename.pages.dev"
    }
}

Adding the domain to Cloudflare Pages

Once your pull request has been merged (or while you're waiting if you want to get over with it), you should add your domain. Before, you could easily do it from the dashboard, but now you can't, due to us being in the Public Suffix List. Because of this, we have to use Cloudflare's API. There are 2 ways: you can either do it the manual way (like using cURL) like this, or you can use our GUI that we made to make it easier.

If you have followed all the steps correctly, then your website should be live after your pull request has been merged.

guides