flutter_libphonenumber
Leverages libphonenumber to allow for asynchronous and synchronous formatting of phone numbers in Flutter apps.
2.8.4
88K downloads/mo
#1180 most downloaded on pub.dev
acoutts/flutter_libphonenumber
What this package is like to depend on
Last release 1 months ago
19 Jul 2026
Release timing varies
gaps range from 3 weeks to 10 months
Nearly every release is documented
notes for 51 of 54 stable releases
Nothing withdrawn
no release was ever pulled
6 years old
57 releases · first in 2020
6 releases in the last 12 months
see the full history below
Release timeline
57 releases · Jun 2020 to Jul 2026Releases
latest 57-
2.8.419 Jul 2026Release notes
Open source →- Bump flutter_libphonenumber_android to 2.1.1: fixes the Android build failure
Could not find method kotlin()on AGP 9 withandroid.builtInKotlin=false(the state Flutter 3.44's migrator writes into apps) (#101, #102 — thanks @proninyaroslav). If your build broke on AGP 9, runflutter pub upgradeto pick up the fix. - Example app: buildable on pre-3.44 Flutter again (explicitly applies the Kotlin Gradle Plugin).
- Bump flutter_libphonenumber_android to 2.1.1: fixes the Android build failure
-
2.8.312 Jun 2026Release notes
Open source →- Bump flutter_libphonenumber_android to 2.1.0: ready for Flutter's Built-in Kotlin cutover — the Kotlin Gradle Plugin is now applied only on AGP <9 hosts where Flutter doesn't manage Kotlin itself. Flutter <3.44 remains supported. Flutter 3.44's KGP warning may still name the plugin; this is a false positive of Flutter's text-based detection.
- Example app: migrate off the Kotlin Gradle Plugin per the Flutter 3.44 Built-in Kotlin guide (building the example now requires Flutter 3.44+)
-
2.8.212 Jun 2026Nothing published for this version
-
2.8.111 Jun 2026Release notes
Open source →- Bump flutter_libphonenumber_android to 2.0.1: reduces repeated work in getAllSupportedRegions (#100 @higorlapacw)
- Fix example app Android build on current Android Gradle Plugin: remove the legacy manifest package attribute and fully-qualify the MainActivity name
- Example app: bump Java compatibility to 17 to match the plugins, add an integration test covering getAllSupportedRegions
-
2.8.011 Jun 2026Release notes
Open source →- Bump flutter_libphonenumber_darwin to 2.2.0: adds Swift Package Manager support while retaining CocoaPods compatibility (#98). Building with Swift Package Manager enabled requires Flutter 3.41+, and the iOS deployment target is now 13.0.
-
2.7.006 Dec 2025Release notes
Open source →- Migrate example app to declarative gradle plugins
- Bump flutter_libphonenumber_darwin to 2.1.0
- BREAKING: Removed flutter_libphonenumber_ios since it's now part of flutter_libphonenumber_darwin
- Remove melos in favor of dart workspace
- Updated flutter_libphonenumber/example android to latest gradle configs
-
2.5.113 Feb 2025Release notes
Open source →- Bump flutter_libphonenumber_android to 1.4.1: This fixes unresolved Registrar issue occurring after upgrading Flutter to 3.29.0 (#93 @amitkhairnar44)
-
2.5.019 Sep 2024Release notes
Open source →- Bump flutter_libphonenumber_platform_interface to 2.1.0
- Bump flutter_libphonenumber_android to v1.4.0.
- Bump flutter_libphonenumber_ios to v1.4.0.
- Bump flutter_libphonenumber_web to v1.3.0.
-
2.4.018 Sep 2024Release notes
Open source →- Bump flutter_libphonenumber_platform_interface to 2.0.0
- Bump flutter_libphonenumber_android to v1.3.0.
- Bump flutter_libphonenumber_ios to v1.3.0.
- Bump flutter_libphonenumber_web to v1.2.0.
-
2.3.319 Aug 2024 -
2.3.219 Aug 2024 -
2.3.119 Aug 2024 -
2.3.001 Aug 2024Nothing published for this version
-
2.2.316 Apr 2024 -
2.2.216 Apr 2024 -
2.2.107 Dec 2023 -
2.2.007 Dec 2023Release notes
Open source →- Bump flutter_libphonenumber_ios to v1.2.0.
- BREAKING Raises minimum iOS deployment to 12.0.
-
2.1.519 Jul 2023 -
2.1.408 Jun 2023 -
2.1.317 May 2023Release notes
Open source →- Fix pod issue with PhoneNumberKit by bumping flutter_libphonenumber_ios version to latest.
-
2.1.201 May 2023 -
2.1.101 May 2023 -
2.1.001 May 2023Release notes
Open source →- BREAKING: Bumped flutter_libphonenumber_ios to 1.1.0 which includes the latest PhoneNumberKit version. You must include the entry in your Podfile now. See updated README for details.
-
2.0.024 Mar 2023Release notes
Open source →- Migrated to new federated plugin configuration.
- Added web implementation from laynor.
-
1.4.010 Mar 2023Release notes
Open source →- Fixed
onFormatFinishedcallback not being called whenshouldKeepCursorAtEndOfInput=true.
- Fixed
-
1.3.005 Dec 2022Release notes
Open source →- Adds a new field (region_code) to the result of the parse method.
- Upgrades the dependencies:
- libphonenumber to 8.12.52
- PhoneNumberKit to 3.3.4
- Fixes some lint issues.
- Upgrade gradle/kotlin versions in android project.
-
1.2.410 Mar 2022Release notes
Open source →- Fixed some edge cases with cursor position when
shouldKeepCursorAtEndOfInputis set tofalse
- Fixed some edge cases with cursor position when
-
1.2.308 Mar 2022Release notes
Open source →- New optional setting
shouldKeepCursorAtEndOfInputonLibPhonenumberTextFormatterwhich will either keep the cursor at the end of the input if the middle of the input is changed, or the cursor will remain at the same position as where it was edited.
- New optional setting
-
1.2.213 Jan 2022 -
1.2.111 Sep 2021Release notes
Open source →- Fixed bug where region was not passed to
parsecall ingetFormattedParseResult.
- Fixed bug where region was not passed to
-
1.2.026 Aug 2021Release notes
Open source →- BREAKING: renamed
hideCountryCodetoinputContainsCountryCodeinLibPhonenumberTextFormatter. - BREAKING: renamed
removeCountryCodetoremoveCountryCodeFromResultand added new parameterinputContainsCountryCodeinformatNumberSync(). Use this to accurately describe if the input number contains a country code and whether or not the result should strip that country code out.
- BREAKING: renamed
-
1.1.001 Jul 2021Release notes
Open source →- Improvements to how masking is performed.
- Now allows for additional digits to be added on the end of the input mask for countries with varying number patterns.
-
1.0.408 Jun 2021Release notes
Open source →- Fix number parsing issue by not attaching a leading '+' anymore. This fixes the problem parsing GB numbers starting with 07 which didn't have the 44 country code at the start.
- Bumped libphonenumber version on android.
-
1.0.310 Feb 2021Release notes
Open source →- Nullsafety for main version.
- UK numbers will correctly remove leading 0 now on international numbers.
-
1.0.2-nullsafety03 Feb 2021 pre-releaseRelease notes
Open source →- Bumped underlying native lib versions. PhoneNumberKit -> 3.3.3, libphonenumber -> 8.12.17.
-
1.0.1-nullsafety22 Nov 2020 pre-release -
1.0.0-nullsafety22 Nov 2020 pre-release -
0.3.1203 Feb 2021Nothing published for this version
-
0.3.1102 Nov 2020 -
0.3.1027 Oct 2020Release notes
Open source →- Bumped PhoneNumberKit to 3.3 (iOS) and libphonenumber to 8.12.11 (Android).
- Fixed overflows in example app on smaller devices.
-
0.3.919 Oct 2020 -
0.3.829 Sep 2020Release notes
Open source →- Downgrade Android minSdkVersion version from 21 to 18 and bump libphonenumber version from 8.12.5 to 8.12.10 via #3.
-
0.3.715 Jul 2020 -
0.3.609 Jul 2020 -
0.3.525 Jun 2020Release notes
Open source →- Added ability to override country mask/phone data. Added fix for UK international numbers when someone pastes in a national format.
-
0.3.416 Jun 2020Release notes
Open source →- Fixed bug when formatting the very first number where it wouldn't move the text selection to the very end.
-
0.3.312 Jun 2020Release notes
Open source →- Fixed bug where realtime formatter didn't ignore leading country code if present when overrideSkipCountryCode was provided.
-
0.3.212 Jun 2020Release notes
Open source →- Fixed formatParsePhonenumberAsync to return the correct phone number international/national format based on what was requested.
-
0.3.110 Jun 2020 -
0.3.010 Jun 2020Release notes
Open source →- Can now format based on the national or international format of a country's phone number.
-
0.2.005 Jun 2020Release notes
Open source →- Added ability to format numbers as either mobile or fixed line, while defaulting to mobile.
-
0.1.505 Jun 2020 -
0.1.405 Jun 2020Release notes
Open source →- Fixed bugs in the way masking is applied which caused numbers to be formatted incorrectly to their mask.
-
0.1.305 Jun 2020Release notes
Open source →- Removed print statements
- Countries list in CountryManager is now read-only outside of the lib
-
0.1.205 Jun 2020 -
0.1.105 Jun 2020 -
0.1.005 Jun 2020