@is-pinoy-dev/cli

CLI for managing is-pinoy.dev subdomains — validate JSON files locally and sync DNS records to Cloudflare.

Installation

npm install -g @is-pinoy-dev/cli

Commands

registry validate

Validate subdomain JSON files against the schema.

is-pinoy registry validate --dir ./subdomains

registry diff

Show what changes would be applied to Cloudflare without making any changes.

is-pinoy registry diff --dir ./subdomains

registry sync

Apply changes to Cloudflare DNS.

is-pinoy registry sync --dir ./subdomains

# Skip confirmation prompt
is-pinoy registry sync --dir ./subdomains --yes

# Preview only, no changes applied
is-pinoy registry sync --dir ./subdomains --dry-run

registry status

Show an overview of the current registry state.

is-pinoy registry status --dir ./subdomains

Environment Variables

Required for diff, sync, and status (not needed for validate):

CLOUDFLARE_API_TOKEN=
CLOUDFLARE_ZONE_ID=

Use --dotenv <path> to load from a .env file:

is-pinoy registry sync --dir ./subdomains --dotenv .env.local

Subdomain File Format

Each file in the subdomains/ directory represents one subdomain:

{
  "subdomain": "your-name",
  "owner": {
    "github": "your-github-username",
    "email": "[email protected]"  // optional — for contact purposes only
  },
  "records": {
    "CNAME": {
      "value": "your-deployment-url"
    }
  }
}