Custom domain for Vercel

• A Vercel project with a production deployment (the free plan is enough).
• A public GitHub repository with a LICENSE — OpenRepos serves open source projects only.
• The OpenRepos badge in your README: CI checks it on every new claim.

Pick a free name with the domain picker, then add it to register.json under the domain you chose:

"openrepos.org": {
  "awesome-project": {
    "repo": "https://github.com/octocat/awesome-project",
    "target": "awesome-project.vercel.app"
  }
}

Use your project's production hostname (<project>.vercel.app) or cname.vercel-dns.com; both are allowlisted. If Vercel shows a TXT record for _vercel when you add the domain, include it in the claim:

"txt": {
  "name": "_vercel",
  "value": "vc-domain-verify=awesome-project.openrepos.org,<hash>"
}

In your Vercel project open Settings → Domains → Add domain, enter your OpenRepos subdomain (for example awesome-project.openrepos.org) and confirm.

Vercel checks the CNAME that OpenRepos already created. If Vercel instead shows a Verify step with a TXT record, add that record to your claim as above, merge it, and press verify.

Vercel's own DNS instructions will mention a CNAME — you do not need to add it yourself; the OpenRepos claim creates exactly that record.

Once the domain is valid, Vercel issues the TLS certificate automatically. Open https://awesome-project.openrepos.org — the padlock should appear within minutes, occasionally a little longer while the certificate propagates.

• "Invalid Configuration" — DNS does not point at Vercel yet. Check dig awesome-project.openrepos.org CNAME; it should return your vercel.app host or cname.vercel-dns.com.
• 404 DEPLOYMENT_NOT_FOUND — DNS is fine but the domain is not assigned to the project, or there is no production deployment. Assign it under Settings → Domains.
• A TXT verification prompt — the domain is in use on another Vercel account. Add the txt field to your claim (M5-7 support), then verify.
• TLS error — the certificate is still being issued; wait a few minutes, then reload. Do not remove and re-add the domain.

See all guides for other providers, or compare free subdomain services. Stuck? Open an issue in the register repository.