Search packages, repositories and app categories

country_codes cover
Package detailsv3.3.0

country_codes

Country codes is an helper package that provides country details given a particular localization, such as dial codes, ISO 3166 codes (alpha-2, alpha-3) and country names.

AndroidiOSmacOS
30-day downloads
33.9K
Likes
134
Pub points
150

Install package

flutter pub add country_codes

Package Overview

Package selection guidance compiled from public package information, community data, and project usage.

Country Codes is a Flutter/Dart package that provides comprehensive country information based on localization, including dial codes, ISO 3166 alpha-2 and alpha-3 codes, and localized country names. It simplifies handling international data by offering consistent access to country details across different regions. The package is lightweight and designed for use in forms, country pickers, and localization workflows. It supports Android, iOS, and macOS platforms, making it ideal for cross-platform applications requiring accurate country metadata.

Use cases

  • International phone number input
  • Country selection in forms
  • Localization of country names
  • Data validation with ISO codes
  • Building country picker widgets

Key features

  • Supports multiple country identifiers
  • Localized country names
  • Dial code lookup
  • ISO 3166 alpha-2 and alpha-3 codes
  • Cross-platform compatibility

Suitable for

  • Apps needing country data
  • Form inputs with country selection
  • Internationalization features
  • Mobile apps with global users
  • Developers building country pickers

Considerations

  • Requires manual handling of locale fallbacks
  • No built-in UI components
  • Limited to static country data
  • Does not include timezone or currency info
  • Depends on correct locale configuration

Original README

Original README snapshot from the linked source repository. Visit the repository for the latest content.

Country Codes

Country Codes Build Status Buy me a coffee

Country codes package provides an easy to way to access country codes based on a provided Locale.

Usage

There are two main ways to use this package.

1. Default by using device region

This will allow you to fetch the region of the underlying platform and display the data accordingly. Very handy if you use along with the DialCodeFormatter to provide integration with dial codes formatter, on phone TextFormFields in a Form, for example.

Assuming an en-US region based revice.

await CountryCodes.init(); // Optionally, you may provide a `Locale` to get countrie's localizadName

final Locale deviceLocale = CountryCodes.getDeviceLocale();
print(deviceLocale.languageCode); // Displays en
print(deviceLocale.countryCode); // Displays US

final CountryDetails details = CountryCodes.detailsForLocale();
print(details.alpha2Code); // Displays alpha2Code, for example US.
print(details.dialCode); // Displays the dial code, for example +1.
print(details.name); // Displays the extended name, for example United States.
print(details.localizedName); // Displays the extended name based on device's language (or other, if provided on init)
2. Use a custom Locale

This will use the provided Locale, which may not be related to the device's region but instead to the app supported languages.

For example, if your device is on US region but the app only supports PT, you'll get the following:

final CountryDetails details = CountryCodes.detailsForLocale(Localization.localeOf(context));

print(details.alpha2Code); // Displays alpha2Code, displays PT.
print(details.dialCode); // Displays the dial code for PT, +351.
print(details.name); // Displays the extended name, Portugal.

Formatters

DialCodeFormatter

Currently there's only available TextInputFormatter which allows you to dynamically set the dial code dynamically on a TextFormField.

TextFormField(
  keyboardType: TextInputType.phone,
  inputFormatters: [DialCodeFormatter()],
);

Example app

Example

Getting Started

This project is a starting point for a Dart package, a library module containing code that can be shared easily across multiple Flutter or Dart projects.

For help getting started with Flutter, view our online documentation, which offers tutorials, samples, guidance on mobile development, and a full API reference.

Categories

Source repository

Projects using this package