A Kotlin Multiplatform phone number validation library for Android and iOS.

• Global phone number validation
• Validation by country ISO code
• Validation by country calling code
• Format phone numbers to E.164
• Format phone numbers to international format
• Extract region code
• Extract country calling code
• Shared API for Android and iOS
• Uses platform-native implementations internally:
  • Android: libphonenumber
  • iOS: PhoneNumberKit

Maven Central publishing will be added once the library is publicly released.

dependencies {
    implementation("com.ajayinnovations.phonenumber:phonenumber:0.1.0")
}

val isValid = PhoneNumberValidator.isValid("+2348012345678")

val isValidForRegion = PhoneNumberValidator.isValidForRegion(
    phoneNumber = "+2348012345678",
    regionCode = "NG"
)

val isValidForCountryCode = PhoneNumberValidator.isValidForCountryCode(
    phoneNumber = "+2348012345678",
    countryCode = 234
)

val e164 = PhoneNumberValidator.format(
    phoneNumber = "+2348012345678",
    format = PhoneNumberFormat.E164
)

val international = PhoneNumberValidator.format(
    phoneNumber = "+2348012345678",
    format = PhoneNumberFormat.INTERNATIONAL
)

val regionCode = PhoneNumberValidator.regionCode("+2348012345678")

val countryCode = PhoneNumberValidator.countryCode("+2348012345678")

val info = PhoneNumberValidator.parse("+2348012345678")

Main entry point for:

• validating numbers
• formatting numbers
• extracting metadata
• parsing structured phone number information

Supported output formats:

• E164
• INTERNATIONAL

Structured parsed phone number data containing:

• raw input
• E.164 format
• international format
• region code
• country code

This library uses different underlying implementations per platform:

• Android uses Google's libphonenumber
• iOS uses PhoneNumberKit through a wrapper bridge

This keeps the public API shared while using strong platform-specific parsing and formatting underneath.

This library is currently in active development and pre-release.

Apache License 2.0