is-pinoy.dev logois-pinoy.dev
Workflow

3–4: Create Your JSON File

Steps 3–4 — Create subdomains/<name>.json and fill in your DNS records.

Step 3: Find your DNS values

Before creating your file, you need the CNAME value (and sometimes a TXT value) from your hosting provider.

See the Provider Guides section and follow the guide for your platform. Come back here once you have your values.

Step 4: Create your subdomain file

Create a new file at subdomains/.json inside the repository you cloned.

touch subdomains/.json

Replace with the subdomain you want (e.g. juan for juan.is-pinoy.dev).

Open the file and fill it in:

{
  "$schema": "https://raw.githubusercontent.com/is-pinoy-dev/domains/main/schemas/v1/subdomain.schema.json",
  "subdomain": "",
  "owner": {
    "github": "your-github-username"
  },
  "records": {
    "CNAME": {
      "value": "xxxxxxxxxxxxxxxx.vercel-dns-017.com."
    }
  }
}
{
  "$schema": "https://raw.githubusercontent.com/is-pinoy-dev/domains/main/schemas/v1/subdomain.schema.json",
  "subdomain": "",
  "owner": {
    "github": "your-github-username"
  },
  "records": {
    "CNAME": {
      "value": "xxxxxxxxxxxxxxxx.vercel-dns-017.com."
    },
    "TXT": {
      "value": "vc-domain-verify=.is-pinoy.dev,abc123",
      "provider": "vercel"
    }
  }
}

Replace , your-github-username, and the record values with your actual information.

Before you continue — checklist

Double-check all three of these before running the validator:

  • The filename (.json) matches the subdomain field ("subdomain": "") exactly
  • owner.github matches your GitHub username exactly (case-sensitive)
  • The CNAME value ends with a trailing dot (.)

Next: Validate

1–2: Fork & Clone

Steps 1–2 — Fork the domains repository on GitHub and clone it to your machine.

5: Validate

Step 5 — Run the validator to catch errors before opening a PR.

On this page

Step 3: Find your DNS valuesStep 4: Create your subdomain fileBefore you continue — checklist