🌍 country_meta

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