Common Errors
Validation errors from the CLI validator and how to fix each one.
These are the most common errors reported by npx @is-pinoy-dev/validate and by CI.
Missing trailing dot on CNAME
Error:
❌ CNAME value must end with a trailing dot (e.g. "yoursite.vercel.app.")Fix: Add a . at the end of your CNAME value:
"CNAME": {
"value": "xxxxxxxxxxxxxxxx.vercel-dns-017.com."
}Filename does not match subdomain field
Error:
❌ Filename "juan-dev.json" does not match subdomain field "juan"Fix: The filename (without .json) and the subdomain field must be identical. Either rename the file or update the field:
{
"subdomain": "juan-dev"
}mv subdomains/juan.json subdomains/juan-dev.jsonowner.github missing or wrong
Error:
❌ owner.github is requiredor from CI:
✖ owner.github (juandelacruz) does not match the pull request author (JuanDeLaCruz)Fix: Add or correct the owner.github field. It must exactly match your GitHub username (case-sensitive):
"owner": {
"github": "JuanDeLaCruz"
}Missing "provider" field on Vercel TXT record
Error:
❌ records.TXT.provider is required when TXT value starts with "vc-domain-verify"Fix: Add "provider": "vercel" to your TXT record:
"TXT": {
"value": "vc-domain-verify=.is-pinoy.dev,abc123",
"provider": "vercel"
}A and CNAME records both present
Error:
❌ records cannot contain both A and CNAMEFix: Use one or the other. If your site is on a hosted platform (Vercel, Netlify, GitHub Pages), use CNAME. If you're pointing to an IP address, use A:
"records": {
"CNAME": {
"value": "yoursite.vercel.app."
}
}Invalid subdomain characters
Error:
❌ subdomain must match pattern ^[a-z0-9]([a-z0-9-]*[a-z0-9])?$Fix: Use only lowercase letters, numbers, and hyphens. No uppercase, no underscores, no dots. No leading or trailing hyphens:
| Invalid | Valid |
|---|---|
Juan | juan |
juan_dev | juan-dev |
-juan | juan |
juan- | juan |