Releases

1. ▸▾5.2.126 Sept 2026

   Fixed\n\n- Correct the Slovak localized name of Greece to Grécko when older platform locale data returns the misspelling Greécko .\n\nPublished on pub

   Fixed\n\n- Correct the Slovak localized name of Greece to Grécko when older platform locale data returns the misspelling Greécko.\n\nPublished on pub.dev.

   Open source →

   Additional notes2 sources agree

   • Correct the Slovak localized name of Greece to Grécko across supported native platforms.

   Open source →
2. ▸▾5.2.030 Aug 2026Breaking

   This is a breaking change for consumers using country_codes_plus .

   Release Notes

   5.2.0 - 2026-08-30

   This release adds Web support, AX/SZ country data, null-safe code lookups,
   flag emoji, longest-prefix phone-number matching, deterministic CLDR locale
   inference, indexed lookups, integrity validation, and refreshed pub.dev
   metadata/docs. No intentional breaking public API changes were introduced.

   5.1.2 - 2026-07-04

   Highlights:

   • Update Android build tooling to Kotlin 2.3.20 and migrate the plugin Gradle build to the current Kotlin DSL.
   • Update the example app to Android Gradle Plugin 9.0.1 and Gradle 9.1.0 while retaining Java 17.
   • Refresh locked Flutter test dependencies (meta and test_api).
   • Remove the obsolete android.enableR8 option, disable the unused Jetifier compatibility layer, and ignore generated iOS Swift Package Manager files.
   • Replace placeholder iOS and macOS CocoaPods metadata with the package's actual description, homepage, and author.
   • Replace the deprecated iOS simulator VALID_ARCHS setting with EXCLUDED_ARCHS.
   • Refresh the example's Apple platform projects for current Flutter/Xcode: iOS 13 with UIScene lifecycle and macOS 10.15 with the modern app delegate, plus Swift Package Manager integration on both platforms.

   Notes:

   • Patch release with no Dart API changes.

   5.1.1 - 2026-05-31

   Highlights:

   • Export CountrySubdivision from the legacy country_codes.dart entrypoint.
   • Add country lookup/search helpers for alpha-3 codes, dial codes, and country search.
   • Add value equality, hashCode, and toString() support to public model classes.
   • Reuse cached subdivision objects for global subdivision searches to avoid rebuilding the full dataset on every query.
   • Clean up analyzer findings and tighten country data typing.
   • Add regression coverage for country lookup helpers, model value behavior, legacy entrypoint compatibility, sub-region locale fallback, and empty-region platform responses.
   • Refresh lockfile metadata for current Flutter/Dart tooling.
   • Fix Swift Package Manager manifests for Flutter's FlutterFramework dependency and align the iOS CI checkout path with the package identity.
   • Add release process documentation.

   Notes:

   • Patch release with no breaking API changes.

   5.1.0 - 2026-03-03

   Highlights:

   • Add CountryCodes.lookupDetails() returning CountryLookupResult with explicit lookup status.
   • Add subdivision discovery helpers: searchSubdivisions() and subdivisionTypesForCountry().
   • Extend DialCodeFormatter with configurable separator and international-prefix preservation control.
   • Expand tests and example app coverage for all new APIs and formatter modes.
   • Update documentation sections and usage snippets across package and example docs.

   Notes:

   • Minor release with additive API changes and no breaking removals.

   5.0.5 - 2026-03-03

   Highlights:

   • Harden CountryCodes.init() to safely handle null/short/invalid platform channel payloads.
   • Add detailsForLocaleOrNull() as a null-safe lookup API while preserving existing detailsForLocale().
   • Improve detailsFromAlpha2() UX with case-insensitive input and clear ArgumentError messaging.
   • Prevent DialCodeFormatter from crashing when a dial code cannot be resolved.
   • Expand tests for init payload validation, formatter safety, and alpha2 lookup behavior.
   • Improve README/example guidance for safe initialization and add visible donation links.

   Notes:

   • Patch release with no breaking API changes.

   5.0.4 - 2026-03-01

   Highlights:

   • Add Kosovo (XK) to the built-in country list returned by CountryCodes.countryCodes().
   • Include alpha-3 code (XKX), dial code (+383), and locale mapping (sq_XK).
   • Add subdivision lookup APIs: subdivisions(), subdivisionsForCountry(alpha2), and subdivisionFromCode(code).
   • Add ISO 3166-2 subdivision datasets for all supported countries in the package, with manual fallback entries for XK.

   Notes:

   • Adds one new country entry with no breaking API changes.

   5.0.3 - 2026-03-01

   Highlights:

   • Add Package.swift manifests for iOS and macOS under the plugin package layout expected by Flutter tooling.
   • Add Swift source targets for SPM with equivalent method-channel behavior.

   Notes:

   • No Dart API changes; this release improves Apple platform package integration metadata.

   5.0.2 - 2026-03-01

   Highlights:

   • Improve pub.dev package page quality with updated README badges and installation snippet.
   • Replace the generic example README with clear package-specific guidance.
   • Align repository metadata checks for the next pub.dev analysis run.

   Notes:

   • No API changes; this is a documentation and release-quality update.

   5.0.1 - 02/09/2026

   Highlights:

   • Fix Android plugin registration by aligning the main class location with the Android package.
   • Add lib/country_codes_plus.dart entrypoint and keep the legacy entrypoint as a re-export.
   • Refresh dev dependency tooling (update lints to 6.1.0 and related transitive updates).

   Notes:

   • No API changes; this is a patch release to address Android plugin discovery.

   5.0.0 - 02/09/2026

   Highlights:

   • Package renamed to country_codes_plus (update imports and dependency names).
   • Example app and platform configs aligned with the new package name.

   Notes:

   • This is a breaking change for consumers using country_codes_plus.

   4.0.0 - 02/07/2026

   Highlights:

   • Locale fallback improvements for language-only locales (e.g., Locale('en') defaults to US) with tests.
   • Android locale selection now respects multi-locale priority; iOS/macOS use auto-updating locales.
   • Added validation tests for ISO/dial codes and platform channel init.
   • CI now runs dart analyze, unit tests, and example builds for Android/iOS.
   • Documentation updates covering edge cases and web support limitations.
   • Android build now targets Java 17 bytecode for Kotlin/Java sources.
   • Updated Android Gradle tooling (AGP/Kotlin/Gradle) and migrated the example to Flutter's plugins DSL.
   • Disabled Jetifier for the example app after verifying all dependencies are AndroidX.

   Notes:

   • API remains compatible with 3.3.x for typical usage.