country_meta 1.0.0

SDKdartflutter
Platformandroidioswindowslinuxmacosweb

A Dart-only package that provides structured metadata for all countries, including ISO codes, phone codes, currencies, localized names, and flag image URLs.

🌍 country_meta

Pub Version

A Dart-only package providing metadata for countries with ISO codes, localized names, currencies, phone codes, and flag image utilities (SVG, WebP, JPEG, Emoji).


📦 Features

  • ✅ ISO Alpha-2, Alpha-3, and Numeric codes
  • 📞 Phone codes
  • 💱 Currencies and symbols
  • 🌐 Localized country names: English, Russian, Arabic
  • 🔎 Country lookup by code or locale
  • 🏁 Flag support: Emoji, SVG / WebP / JPEG (FlagCDN)
  • 🧪 Unit tests for model serialization, equality, and indexing

🇺🇳 Flag icons provided by flagpedia.net

🚀 Usage

🔍 Country Lookup

final country = CountryRepository.byAlpha2('US');
print(country?.currency); // USD
print(country?.phoneCode); // 1

🌐 Localized Name

final name = country?.localizedName('ru_RU');
print(name); // Соединенные Штаты

🏁 Flag URL

// Default SVG
final svg = country?.flagUrl();

// JPEG with height
final jpeg = country?.flagUrl(
  format: FlagImageFormat.jpeg,
  height: FlagHeight.h160,
);

// WebP with width
final webp = country?.flagUrl(
  format: FlagImageFormat.webp,
  width: FlagWidth.w320,
);

😀 Emoji Flag

final emoji = country?.flagEmoji();
print(emoji); // 🇺🇸

⚡️ Direct Flag Access

You don’t need to resolve a full CountryMeta to show a flag. Both emoji and image URLs can be generated directly from ISO alpha-2 codes.

// Emoji flags
print(FlagEmojiBuilder.build('US')); // 🇺🇸
print(FlagEmojiBuilder.build('DE')); // 🇩🇪

// Flag URLs
print(FlagUrlBuilder.svg('US'));                // https://flagcdn.com/us.svg
print(FlagUrlBuilder.webp('US', width: FlagWidth.w40));
print(FlagUrlBuilder.jpeg('JP', height: FlagHeight.h80));

🧪 Testing

Run all tests:

dart test

Includes tests for:

  • ✅ CountryMeta model parsing, serialization, equality
  • 📦 Country repository lookup
  • 🌐 Localized name fallback logic
  • 🏁 Flag URL generation and format fallback

📄 License

MIT