country_codes_plus
Country code plus is a helper package that provides country details given a particular localization, such as dial codes, ISO 3166 codes (alpha-2, alpha-3) and country names.
5.1.2
4.8K downloads/mo
#3904 most downloaded on pub.dev
seidlmatus/country_code_plus
What this package is like to depend on
Last release 1 months ago
04 Jul 2026
Ships fairly regularly
a new release about every 2 months
Most releases are documented
notes for 7 of 8 stable releases
Nothing withdrawn
no release was ever pulled
5 months old
8 releases · first in 2026
8 releases in the last 12 months
see the full history below
Release timeline
8 releases · Mar 2026 to Jul 2026Releases
latest 8-
5.1.204 Jul 2026Release notes
Open source →- Update Android 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.
- Refresh locked Flutter test dependencies.
- Remove the obsolete R8 flag, disable the unused Jetifier compatibility layer, and ignore generated iOS Swift Package Manager files.
- Replace placeholder CocoaPods metadata with package details and modernize the iOS simulator architecture setting.
- Refresh the iOS and macOS example projects for current Flutter/Xcode, including Swift Package Manager integration, UIScene lifecycle support, and supported deployment targets.
-
5.1.131 May 2026Release notes
Open source →- Export
CountrySubdivisionfrom the legacycountry_codes.dartentrypoint for compatibility with explicit subdivision type annotations. - Add country lookup/search helpers:
allCountries,searchCountries(),detailsFromAlpha3(),countriesFromDialCode(), andcountryFromDialCode(). - Improve global subdivision search performance by reusing cached subdivision objects instead of rebuilding the full dataset for each search.
- Add value equality,
hashCode, andtoString()implementations for public model classes. - Tighten country data typing and remove analyzer lint findings.
- Add tests for legacy subdivision exports, additional country lookup helpers, model value behavior, sub-region locale fallback, and empty-region platform locale fallback.
- Refresh lockfile metadata for current Flutter/Dart tooling.
- Fix Swift Package Manager manifests for Flutter's
FlutterFrameworkdependency and make iOS CI checkout path match the package identity. - Add release process documentation.
- Export
-
5.1.003 Mar 2026Release notes
Open source →- Add rich locale lookup API:
CountryCodes.lookupDetails()with explicit success/error status. - Add subdivision search helpers:
searchSubdivisions(query, ...)andsubdivisionTypesForCountry(alpha2). - Extend
DialCodeFormatterwith configurable separator and optional preservation of user-entered international prefixes. - Expand unit tests for new lookup, subdivision, and formatter behaviors.
- Extend example app and docs to demonstrate all new APIs and formatter variants.
- Add rich locale lookup API:
-
5.0.503 Mar 2026Release notes
Open source →- Harden
CountryCodes.init()against null/short/invalid platform payloads and avoidRangeError. - Add
CountryCodes.detailsForLocaleOrNull()for null-safe locale resolution while keepingdetailsForLocale()behavior explicit. - Make
detailsFromAlpha2()case-insensitive and return clearerArgumentErrorfor unknown codes. - Prevent
DialCodeFormattercrashes when dial code cannot be resolved. - Add tests for the new edge cases and null-safe flows.
- Improve docs and examples for safe initialization/error handling.
- Add visible Buy Me a Coffee support links to README and example docs.
- Harden
-
5.0.401 Mar 2026Release notes
Open source →- Add Kosovo (
XK) to the country list returned byCountryCodes.countryCodes(). - Include Kosovo metadata: alpha-3
XKX, dial code+383, and locale mappingsq_XK. - Add subdivisions API with ISO 3166-2 lookup methods.
- Add subdivision datasets for all supported countries, with manual fallback entries for Kosovo (
XK).
- Add Kosovo (
-
5.0.301 Mar 2026Release notes
Open source →- Add Swift Package Manager manifests for iOS and macOS plugin targets.
- Add Swift sources for SPM targets using the same platform channel behavior as existing plugin code.
-
5.0.201 Mar 2026Release notes
Open source →- Improve package documentation for pub.dev (README badges and install instructions).
- Replace default example README with package-specific usage notes.
- Keep repository metadata aligned for pub.dev score validation.
-
5.0.101 Mar 2026Nothing published for this version