About the data

Phase 1 is intentionally static-first: the calling code data lives as versioned JSON inside this repo. That keeps the site cheap and immune to per-request compute bills.

What’s included (MVP)

• Country name + ISO2 code
• Country calling code (digits only)
• Trunk prefix (if commonly used)
• Example formats + simple notes
• Origin exit codes (IDD prefix) for legacy formatting

Limitations

• This is not a full libphonenumber replacement (yet).
• Some countries have nuanced rules (e.g., Italy fixed lines) that need special-casing.
• Some calling codes are shared (e.g., NANP +1). We model that but keep parsing simple in Phase 1.

Verification

The repo includes a dataset validator script so changes are safe and deterministic.

npm run validate-data