#locales

Countries

The countries array is the central dataset of arev. It contains ~195 sovereign states following the ISO 3166-1 standard, covering every continent.

Address Formats

arevdata includes normalized postal address metadata for every bundled country. The data is based on Google’s public address metadata, with a generic fallback for countries the upstream dataset does not cover.

Phone Country Codes

The phoneCountryCodes array is ready-to-use data for international phone number inputs (like WhatsApp, Stripe, or any contact form). It combines all sovereign countries with additional territories and special regions that have their own dialling codes.

Cities

The cities array contains 430+ bundled static city records, including every national capital and a growing set of subnational capitals. Each city has coordinates, country code, and population where available, with optional capital-role metadata.

Places

The place dataset is designed for country → place selectors without forcing your app to load worldwide city data up front.

States,Provinces & Administrative Divisions

The states array contains 5,000+ administrative divisions across every country in the dataset. It is backed by ISO 3166-2 subdivision data, normalized into a consistent set of types such as states, provinces, territories, districts, municipalities, counties, and regions.

Continents & Currencies

Languages

The language dataset adds three things that were missing from the core country data:

Flags

arev provides complete flag metadata for ~195 countries: