countries-list vs country-code-lookup vs country-data vs country-list vs i18n-iso-countries vs iso-3166-1
Country Data Libraries for Frontend Applications
Search packages..
countries-listcountry-code-lookupcountry-datacountry-listi18n-iso-countriesiso-3166-1Similar Packages:

Country Data Libraries for Frontend Applications

These six npm packages provide country-related data for web applications, but they serve different purposes. countries-list, country-list, and country-data offer comprehensive country information including names, codes, currencies, and languages. i18n-iso-countries focuses on ISO standard country code translations across multiple languages. country-code-lookup provides simple code-to-country mapping utilities. iso-3166-1 delivers strict ISO 3166-1 standard compliance. Choosing the right one depends on whether you need full country details, just code translations, or strict standards adherence.

Npm Package Weekly Downloads Trend

3 Years

Github Stars Ranking

Stat Detail

Package
Downloads
Stars
Size
Issues
Publish
License
countries-list01,309274 kB921 days agoMIT
country-code-lookup08761.4 kB59 hours agoMIT
country-data0518-359 years agoMIT
country-list028216.9 kB17 months agoMIT
i18n-iso-countries0888624 kB55a year agoMIT
iso-3166-105938.1 kB4-MIT

Country Data Libraries: Technical Comparison for Frontend Developers

When building international applications, you will need country data for forms, validation, display, or analytics. These six packages all handle country information, but they differ significantly in scope, data structure, and intended use cases. Let's examine how each one works in practice.

πŸ“¦ Data Structure and Access Patterns

The way you access country data varies greatly between these packages. Some return objects, others return arrays, and some provide utility functions.

countries-list exports country data as an object with country codes as keys.

import { countries } from 'countries-list';

// Access by country code
const usa = countries['US'];
console.log(usa.name); // "United States"
console.log(usa.currency); // "USD"
console.log(usa.languages); // ["en"]

// Iterate through all countries
Object.values(countries).forEach(country => {
  console.log(country.name);
});

country-code-lookup provides utility functions for code-to-name conversion.

import lookup from 'country-code-lookup';

// Lookup by ISO code
const country = lookup.byIso('US');
console.log(country.country); // "United States"

// Lookup by country name
const byName = lookup.byCountry('United States');
console.log(byName.iso2); // "US"

// Get all countries
const all = lookup.countries;

country-data exports data as arrays with detailed metadata.

import countries from 'country-data';

// Access countries array
const usa = countries.countries.find(c => c.alpha2 === 'US');
console.log(usa.name); // "United States"
console.log(usa.region); // "Americas"
console.log(usa.flag); // "πŸ‡ΊπŸ‡Έ"

// Access currencies separately
const usd = countries.currencies.USD;

country-list provides a simple array of country objects.

import countries from 'country-list';

// Get all countries as array
const all = countries.getData();
// [{ code: 'US', name: 'United States' }, ...]

// Find by code
const usa = countries.getName('US'); // "United States"

// Get code from name
const code = countries.getCode('United States'); // "US"

i18n-iso-countries focuses on translated country names with ISO compliance.

import countries from 'i18n-iso-countries';
import enLocale from 'i18n-iso-countries/langs/en.json';

// Register locale
countries.registerLocale(enLocale);

// Get name in registered language
const name = countries.getName('US', 'en'); // "United States"

// Get all names in a language
const allNames = countries.getNames('en');
// { US: "United States", GB: "United Kingdom", ... }

// Get code from name
const code = countries.getCode('United States', 'en'); // "US"

iso-3166-1 provides strict ISO standard code mappings.

import { alpha2, alpha3, numeric } from 'iso-3166-1';

// Get country by alpha-2 code
const usa = alpha2.get('US');
console.log(usa.name); // "United States"
console.log(usa.alpha3); // "USA"
console.log(usa.numeric); // "840"

// Get by alpha-3 code
const byAlpha3 = alpha3.get('USA');

// Get all countries
const all = alpha2.all();

🌍 Internationalization and Language Support

Language support is a major differentiator between these packages.

countries-list includes language codes per country but does not translate country names.

import { countries } from 'countries-list';

const france = countries['FR'];
console.log(france.languages); // ["fr"]
console.log(france.name); // "France" (English only)

country-code-lookup provides English names only without translation support.

import lookup from 'country-code-lookup';

const country = lookup.byIso('DE');
console.log(country.country); // "Germany" (English only)

country-data includes English names with some regional metadata but no built-in translations.

import countries from 'country-data';

const japan = countries.countries.find(c => c.alpha2 === 'JP');
console.log(japan.name); // "Japan" (English only)
console.log(japan.region); // "Asia"

country-list supports multiple languages through separate locale packages.

import countries from 'country-list';
import { translate } from 'country-list/translate';

// Default English
const name = countries.getName('ES'); // "Spain"

// With translation (requires additional setup)
translate('ES', 'fr'); // "Espagne"

i18n-iso-countries excels at multi-language support with 100+ locales available.

import countries from 'i18n-iso-countries';
import enLocale from 'i18n-iso-countries/langs/en.json';
import frLocale from 'i18n-iso-countries/langs/fr.json';
import deLocale from 'i18n-iso-countries/langs/de.json';

countries.registerLocale(enLocale);
countries.registerLocale(frLocale);
countries.registerLocale(deLocale);

const nameEn = countries.getName('ES', 'en'); // "Spain"
const nameFr = countries.getName('ES', 'fr'); // "Espagne"
const nameDe = countries.getName('ES', 'de'); // "Spanien"

iso-3166-1 provides standard codes without name translations.

import { alpha2 } from 'iso-3166-1';

const country = alpha2.get('BR');
console.log(country.name); // "Brazil" (English only)
console.log(country.alpha2); // "BR"
console.log(country.alpha3); // "BRA"

πŸ” Lookup Methods and Performance

Different packages offer different lookup strategies that affect both code clarity and runtime performance.

countries-list uses direct object property access for O(1) lookups.

import { countries } from 'countries-list';

// Direct property access - fastest
const country = countries['CA'];

// Convert to array if needed
const countryArray = Object.values(countries);

country-code-lookup provides multiple lookup methods with internal caching.

import lookup from 'country-code-lookup';

// Multiple lookup strategies
const byIso2 = lookup.byIso('CA');
const byIso3 = lookup.byIso('CAN');
const byName = lookup.byCountry('Canada');
const byCallingCode = lookup.byCallingCode('1');

country-data requires array iteration for lookups.

import countries from 'country-data';

// Array find operation - O(n)
const country = countries.countries.find(c => c.alpha2 === 'CA');

// Direct access for currencies
const currency = countries.currencies.CAD;

country-list provides helper functions for common operations.

import countries from 'country-list';

// Built-in helper methods
const name = countries.getName('CA');
const code = countries.getCode('Canada');
const all = countries.getData();

// Custom filtering
const filtered = countries.getData().filter(c => c.name.startsWith('A'));

i18n-iso-countries requires locale registration before lookups work.

import countries from 'i18n-iso-countries';
import enLocale from 'i18n-iso-countries/langs/en.json';

countries.registerLocale(enLocale);

// Lookups work after registration
const name = countries.getName('CA', 'en');
const code = countries.getCode('Canada', 'en');
const all = countries.getNames('en');

iso-3166-1 separates lookups by code type for type safety.

import { alpha2, alpha3, numeric } from 'iso-3166-1';

// Type-specific lookups
const byAlpha2 = alpha2.get('CA');
const byAlpha3 = alpha3.get('CAN');
const byNumeric = numeric.get('124');

// Get all of a specific type
const allAlpha2 = alpha2.all();

⚠️ Deprecation and Maintenance Status

Package maintenance affects long-term project stability.

country-data β€” This package is deprecated and should not be used in new projects. The maintainer has marked it as archived with no future updates planned. Existing projects should migrate to alternatives like countries-list or i18n-iso-countries.

// ❌ Do not use in new projects
import countries from 'country-data'; // Deprecated

// βœ… Use instead
import { countries } from 'countries-list';

countries-list, country-code-lookup, country-list, i18n-iso-countries, and iso-3166-1 are all actively maintained with regular updates for ISO standard changes.

πŸ› οΈ Real-World Implementation Patterns

Pattern 1: Country Selector Dropdown

For form dropdowns, you need a simple code-name pair list.

// Using countries-list
import { countries } from 'countries-list';

const options = Object.values(countries).map(c => ({
  value: c.iso2,
  label: c.name
}));

// Using country-list
import countries from 'country-list';

const options = countries.getData().map(c => ({
  value: c.code,
  label: c.name
}));

// Using i18n-iso-countries (for multi-language)
import countries from 'i18n-iso-countries';
import enLocale from 'i18n-iso-countries/langs/en.json';

countries.registerLocale(enLocale);
const options = Object.entries(countries.getNames('en')).map(([code, name]) => ({
  value: code,
  label: name
}));

Pattern 2: Validation Logic

For validating user input against country codes.

// Using country-code-lookup
import lookup from 'country-code-lookup';

function validateCountryCode(code) {
  const country = lookup.byIso(code);
  return country !== null;
}

// Using iso-3166-1
import { alpha2 } from 'iso-3166-1';

function validateCountryCode(code) {
  return alpha2.get(code) !== undefined;
}

// Using countries-list
import { countries } from 'countries-list';

function validateCountryCode(code) {
  return code in countries;
}

Pattern 3: Display with Flags

For showing country names with emoji flags.

// Using country-data (has flag emoji built-in)
import countries from 'country-data';

const usa = countries.countries.find(c => c.alpha2 === 'US');
console.log(`${usa.flag} ${usa.name}`); // πŸ‡ΊπŸ‡Έ United States

// Using countries-list (no flag, add manually)
import { countries } from 'countries-list';

function getFlagEmoji(countryCode) {
  const codePoints = countryCode
    .toUpperCase()
    .split('')
    .map(char => 127397 + char.charCodeAt());
  return String.fromCodePoint(...codePoints);
}

const usa = countries['US'];
console.log(`${getFlagEmoji(usa.iso2)} ${usa.name}`);

Pattern 4: Multi-Language Applications

For apps supporting multiple user languages.

// Using i18n-iso-countries (best for i18n)
import countries from 'i18n-iso-countries';
import enLocale from 'i18n-iso-countries/langs/en.json';
import esLocale from 'i18n-iso-countries/langs/es.json';
import frLocale from 'i18n-iso-countries/langs/fr.json';

countries.registerLocale(enLocale);
countries.registerLocale(esLocale);
countries.registerLocale(frLocale);

function getCountryName(code, userLanguage) {
  return countries.getName(code, userLanguage) || countries.getName(code, 'en');
}

// Usage
const name = getCountryName('DE', 'es'); // "Alemania"

πŸ“Š Feature Comparison Summary

Featurecountries-listcountry-code-lookupcountry-datacountry-listi18n-iso-countriesiso-3166-1
Country Namesβœ… Englishβœ… Englishβœ… Englishβœ… English + localesβœ… 100+ languagesβœ… English
ISO Codesβœ… Alpha-2, Alpha-3βœ… Alpha-2, Alpha-3βœ… Alpha-2, Alpha-3βœ… Alpha-2βœ… Alpha-2, Alpha-3, Numericβœ… Alpha-2, Alpha-3, Numeric
Currency Dataβœ… Yes❌ Noβœ… Yes❌ No❌ No❌ No
Language Dataβœ… Country languages❌ No❌ No❌ No❌ No❌ No
Flag Emoji❌ No❌ Noβœ… Yes❌ No❌ No❌ No
Multi-Language❌ No❌ No❌ No⚠️ Limitedβœ… Excellent❌ No
Lookup Speed⚑ O(1)⚑ O(1)🐌 O(n)⚑ O(1)⚑ O(1)⚑ O(1)
Maintenanceβœ… Activeβœ… Active❌ Deprecatedβœ… Activeβœ… Activeβœ… Active

πŸ’‘ Decision Framework

Choose based on your specific requirements:

Need multi-language support? β†’ i18n-iso-countries is the clear winner with 100+ locales and proper ISO compliance.

Need currency and language data per country? β†’ countries-list provides the most comprehensive metadata without deprecation concerns.

Need simple code-to-name lookup? β†’ country-code-lookup or country-list both work well with minimal overhead.

Need strict ISO standard compliance? β†’ iso-3166-1 provides the most accurate standard code mappings.

Need flag emojis? β†’ country-data has them built-in, but remember it is deprecated. Consider countries-list with manual emoji generation instead.

Building new projects? β†’ Avoid country-data entirely due to deprecation. Choose countries-list for rich data or i18n-iso-countries for internationalization.

🎯 Final Thoughts

These packages solve overlapping but distinct problems. i18n-iso-countries stands out for internationalized applications where users see country names in their language. countries-list works best when you need comprehensive country metadata like currencies and languages. country-code-lookup and country-list serve simple lookup needs with minimal setup. iso-3166-1 fits regulatory or financial contexts requiring strict standard compliance.

The deprecated status of country-data means new projects should evaluate the five remaining options based on their specific data requirements. For most modern frontend applications, countries-list or i18n-iso-countries will cover the majority of use cases with active maintenance and good developer experience.

How to Choose: countries-list vs country-code-lookup vs country-data vs country-list vs i18n-iso-countries vs iso-3166-1

  • countries-list:

    Choose countries-list if you need comprehensive country data including codes, names, currencies, and languages in a single package. It works well for forms with country selectors, shipping calculators, or any feature requiring detailed country information. The package provides both CommonJS and ES module exports for flexible integration.

  • country-code-lookup:

    Choose country-code-lookup if you need simple, fast lookups from country codes to country names without extra data overhead. It is ideal for validation logic, display formatting, or scenarios where you already have country codes and just need to show human-readable names to users.

  • country-data:

    Choose country-data if you need extensive country information including flags, regions, and calling codes alongside standard codes and names. This package suits applications requiring rich country metadata for internationalization, analytics dashboards, or geographic filtering features.

  • country-list:

    Choose country-list if you prefer a minimal, straightforward package that provides basic country code and name mappings. It works well for simple dropdowns, basic validation, or projects where you want to minimize dependencies without needing advanced features.

  • i18n-iso-countries:

    Choose i18n-iso-countries if your application needs country names translated into multiple languages with ISO standard compliance. It is perfect for internationalized applications, multi-language forms, or any project where users interact with country data in their preferred language.

  • iso-3166-1:

    Choose iso-3166-1 if you need strict adherence to the ISO 3166-1 standard with alpha-2, alpha-3, and numeric codes. It suits regulatory compliance scenarios, financial applications, or any project where standard code accuracy matters more than additional country metadata.

Similar Npm Packages to countries-list

countries-list is a popular npm package that provides a comprehensive list of countries and their respective codes. It is particularly useful for developers who need to work with country data in their applications, such as for dropdowns, forms, or localization purposes. The package includes country names, ISO codes, and other relevant information, making it a go-to choice for many projects. However, there are several alternatives that may also suit different needs:

  • countries-and-timezones is a package that combines country data with timezone information. This is especially useful for applications that require both geographical and temporal context, such as scheduling apps or global services. By providing detailed information about countries and their corresponding timezones, this package allows developers to handle date and time calculations more effectively.
  • country-data is another npm package that offers a wide range of country-related data, including names, codes, and additional attributes like population and area. It is designed for applications that need more than just a simple list of countries, making it a good choice for projects that require detailed demographic or geographical information.
  • country-list is a lightweight alternative that provides a simple list of country names and their ISO codes. It is easy to use and can be integrated quickly into projects that need basic country data without the overhead of additional features. This package is ideal for developers looking for a straightforward solution.
  • i18n-iso-countries is a library that focuses on internationalization, providing country names in various languages along with their ISO codes. This is particularly useful for applications that are intended for a global audience and need to display country names in the user's preferred language. It supports multiple languages and can enhance the user experience in multilingual applications.
  • iso-3166-1 is a package that provides ISO 3166-1 country codes and names. It is a minimalistic library that focuses solely on the ISO standard for country codes, making it suitable for applications that require strict adherence to international standards without additional data.

To explore how these packages compare, check out the following link: Comparing countries-and-timezones vs countries-list vs country-data vs country-list vs i18n-iso-countries vs iso-3166-1.

Similar Npm Packages to country-code-lookup

country-code-lookup is a simple and efficient npm package that allows developers to look up country codes and names based on ISO standards. This package is particularly useful for applications that need to display country information or validate country codes. It provides a straightforward API to retrieve country names, codes, and other related data, making it a popular choice for developers working on internationalization or location-based features.

While country-code-lookup is a solid option, there are several alternatives available in the npm ecosystem that offer similar functionalities. Here are a few noteworthy alternatives:

  • countries-list is a comprehensive package that provides a complete list of countries and their respective codes. It includes both ISO 3166-1 alpha-2 and alpha-3 codes, making it versatile for various applications. This package is particularly useful for developers who need a full dataset of countries and their details, as it also includes additional information like country names in different languages.

  • country-data is another alternative that offers a rich dataset of countries, including their codes, names, and other relevant information. It provides a more extensive set of data compared to country-code-lookup, making it suitable for applications that require detailed country information. The package is designed for easy integration and can be a great choice for developers needing comprehensive country data.

  • country-list is a lightweight package that provides a simple list of countries and their ISO codes. It is easy to use and integrates well with various applications. If you are looking for a minimalistic solution to retrieve country names and codes without additional overhead, country-list is an excellent option.

  • i18n-iso-countries is a library that focuses on internationalization, providing country names in multiple languages along with their ISO codes. This package is particularly useful for applications that need to support multiple languages and display country names accordingly. It offers a robust solution for developers working on global applications.

  • iso-3166-1-alpha-2 is a straightforward package that provides a mapping of ISO 3166-1 alpha-2 country codes to country names. It is a simple and efficient choice for developers who only need to work with alpha-2 codes without the additional complexity of other datasets.

For a detailed comparison of these packages, check out the following link: Comparing countries-list vs country-code-lookup vs country-data vs country-list vs i18n-iso-countries vs iso-3166-1-alpha-2.

Similar Npm Packages to country-data

country-data is an npm package that provides a comprehensive dataset of country information, including country names, codes, currencies, and more. This library is particularly useful for applications that require geographical data, such as internationalization, user location detection, or any feature that involves country-specific information. With its straightforward API, developers can easily access and manipulate country data to enhance their applications.

While country-data is a robust solution, there are several alternatives that also provide country-related information. Here are a few notable options:

  • countries-list is a simple and lightweight library that offers a list of countries along with their ISO codes. It provides a straightforward way to access country data without the additional overhead of more complex libraries. If your application only requires basic country information, countries-list is an excellent choice for its simplicity and ease of use.

  • country-code-lookup is another alternative that focuses specifically on mapping country names to their respective ISO codes. This library is useful for applications that need to convert country names into codes for API requests or data processing. If you are looking for a minimalistic solution that specializes in code lookups, country-code-lookup is a great option.

  • country-list is a lightweight library that provides a simple list of countries and their ISO codes. It is designed for easy integration into applications that require country selection or validation. If you need a straightforward solution to retrieve country names and codes without additional data, country-list is a solid choice.

  • i18n-iso-countries is a library that focuses on internationalization, providing country names in various languages along with their ISO codes. This package is particularly useful for applications that require localization and need to display country names in different languages. If your project involves internationalization and you need localized country names, i18n-iso-countries is the ideal solution.

To compare these packages, check out the following link: Comparing countries-list vs country-code-lookup vs country-data vs country-list vs i18n-iso-countries.

Similar Npm Packages to country-list

country-list is an npm package that provides a simple and easy-to-use list of countries and their corresponding ISO 3166-1 alpha-2 codes. This package is particularly useful for developers who need to implement country selection features in their applications, such as forms or dropdowns. It offers a straightforward API for retrieving country names and codes, making it a popular choice for projects that require country data.

While country-list is a great option, there are several alternatives that also provide country data and related functionalities. Here are a few notable ones:

  • countries-list is a comprehensive package that offers a complete list of countries along with their ISO codes, currencies, and other relevant information. It is particularly useful for applications that require detailed country data, including demographic or economic information. The package is well-maintained and provides a rich dataset for developers looking to implement more complex country-related features.
  • country-code-lookup is a lightweight library that allows developers to look up country names and their corresponding ISO codes. It is designed for simplicity and ease of use, making it a good choice for projects that need basic country code lookup functionality without the overhead of additional data.
  • country-data is another alternative that provides a wealth of information about countries, including names, codes, and various demographic details. This package is particularly useful for applications that require extensive country data for analytics or reporting purposes.
  • i18n-iso-countries is a library focused on internationalization, providing country names in various languages along with their ISO codes. This package is ideal for applications that need to support multiple languages and require localized country names for better user experience.
  • iso-3166-1 is a package that provides a simple way to access ISO 3166-1 country codes and names. It is lightweight and straightforward, making it suitable for projects that need basic country code functionality without additional features.

To see how these packages compare, check out the comparison: Comparing countries-list vs country-code-lookup vs country-data vs country-list vs i18n-iso-countries vs iso-3166-1.

Similar Npm Packages to i18n-iso-countries

i18n-iso-countries is a library that provides a comprehensive list of countries with their ISO codes, allowing developers to easily manage internationalization in their applications. It supports multiple languages and provides a simple API for retrieving country names and codes in various formats. This library is particularly useful for applications that require localization and need to display country names in different languages.

While i18n-iso-countries is a robust solution for handling country data, there are several alternatives available in the npm ecosystem that also provide similar functionalities. Here are a few noteworthy alternatives:

  • countries-list is a simple and straightforward library that offers a complete list of countries and their ISO codes. It provides country names in English and can be easily integrated into any JavaScript application. If you are looking for a lightweight solution without the need for localization, countries-list is a great option.

  • country-data is another library that provides detailed information about countries, including ISO codes, population, and more. It offers a more extensive dataset compared to some other libraries, making it suitable for applications that require additional country-related information. If you need more than just country names and codes, country-data might be the right choice for your project.

  • country-list is a simple library that provides a list of countries and their ISO codes in a straightforward format. It is easy to use and can be a good choice for applications that require basic country information without the overhead of additional features. If you are looking for a minimalistic approach, country-list is worth considering.

To see how these packages compare, check out the comparison: Comparing countries-list vs country-data vs country-list vs i18n-iso-countries.

Similar Npm Packages to iso-3166-1

iso-3166-1 is a lightweight JavaScript library that provides access to ISO 3166-1 country data, including country codes (alpha-2, alpha-3, and numeric), names, and official information as standardized by the International Organization for Standardization. It’s commonly used in applications requiring standardized country identifiers, such as forms, international shipping, or localization features. The package focuses strictly on compliance with the ISO standard and avoids adding extra metadata beyond what the specification defines.

There are several alternatives in the npm ecosystem that offer similar or extended country-related data:

  • countries-list provides a comprehensive list of countries with names, native names, phone codes, currencies, and emoji flags. It supports multiple languages and is ideal for UI-driven applications needing rich, user-friendly country information rather than just ISO codes.
  • country-data includes country names, ISO codes, calling codes, currencies, and more. It bundles data from multiple standards (including ISO 3166 and ISO 4217) and is useful when you need a broader dataset without fetching from external APIs.
  • country-list offers a simple mapping of ISO 3166-1 alpha-2 codes to English country names. It’s minimalistic and suitable for basic use cases where only country names and two-letter codes are required.
  • i18n-iso-countries provides ISO 3166-1 country data with full internationalization supportβ€”offering country names in dozens of languages. This package is especially valuable for multilingual applications that must display country names according to the user’s locale while maintaining strict ISO compliance.

For a detailed side-by-side comparison of these packages, visit: Comparing countries-list vs country-data vs country-list vs i18n-iso-countries vs iso-3166-1.

README for countries-list

Countries, Languages & Continents data

Monthly Downloads NPM Packagist CI: JS CI: PHP Twitter

Continents & countries: ISO 3166-1 alpha-2 code (with alpha-2 to alpha-3 set), name, ISO 639-1 languages, capital and ISO 4217 currency codes, native name, calling codes. Lists are available in JSON, CSV and SQL formats. Also, contains separate JSON files with additional country Emoji flags data.

Version 3.0: Breaking changes

Version 3 comes with some data structure changes. It was completely reworked under the hood with TypeScript, ESM exports and Turborepo file structure.

Everything is strongly typed so you can easily use data with auto-complete in your IDE.

Note: If your projects depend on the old structure, carefully specify required versions in your dependencies.

Installation

Package is available via:

  • Bun bun add countries-list
  • NPM npm install countries-list
  • Composer / Packagist composer require annexare/countries-list

Usage (version 3.x)

Module exports continents, countries, languages and utility functions.

// Interfaces and types
import type {
  ICountry,
  ICountryData,
  ILanguage,
  TContinentCode,
  TCountryCode,
  TLanguageCode,
} from 'countries-list'

// Main data and utils
import { continents, countries, languages } from 'countries-list'
// Utils
import { getCountryCode, getCountryData, getCountryDataList, getEmojiFlag } from 'countries-list'

// Minimal data in JSON
import countries2to3 from 'countries-list/minimal/countries.2to3.min.json'
import countries3to2 from 'countries-list/minimal/countries.3to2.min.json'
import languageNames from 'countries-list/minimal/languages.native.min'

getCountryCode('Ukraine') // 'UA'
getCountryCode('Π£ΠΊΡ€Π°Ρ—Π½Π°') // 'UA'
getCountryData('UA') // ICountryData

Built files are in the dist directory of this repository, and packages/countries directory contains source data.

Note: JS build contains ES modules, CommonJS and IIFE (for now)

  • CJS cjs/index.js
  • ESM mjs/index.js
  • IIFE index.iife.js

Data structure examples

const continents = {
  AF: 'Africa',
  AN: 'Antarctica',
  AS: 'Asia',
  EU: 'Europe',
  NA: 'North America',
  OC: 'Oceania',
  SA: 'South America',
}

const countries = {
  // ...
  UA: {
    name: 'Ukraine',
    native: 'Π£ΠΊΡ€Π°Ρ—Π½Π°',
    phone: [380],
    continent: 'EU',
    capital: 'Kyiv',
    currency: ['UAH'],
    languages: ['uk'],
  },
  // ...
}

const languages = {
  // ...
  uk: {
    name: 'Ukrainian',
    native: 'Π£ΠΊΡ€Π°Ρ—Π½ΡΡŒΠΊΠ°',
  },
  ur: {
    name: 'Urdu',
    native: 'اردو',
    rtl: 1,
  },
  // ...
}

Contributing to this repository

Everything is generated from strongly typed files in packages/countries/src, including SQL file.

Everything in dist is generated, so please make data related changes ONLY to files from packages/countries, commit them. Use bun run build (or turbo build, turbo test) command to build/test generated files.

Credits

Prepared by Annexare Studio from different public sources. Feel free to use it as you need in your apps or send updates into this public repository. It's under MIT license.

npm-compare.com is an independent website designed to help developers choose the most suitable npm packages. We are not affiliated with npm, Inc, the official website for the npm registry. Note that npm is a registered trademark of npm, Inc. Please share your feedback via our GitHub repository. For more details, please refer to our Terms & Privacy.