A powerful, flexible, and fully customizable Country Picker & Phone Number Input library for Jetpack Compose and Compose Multiplatform.

Designed for modern apps that need seamless international phone number handling with clean UI and developer-friendly APIs.

• 🌎 250+ Countries Supported
• 🔍 Searchable Country List
• 📱 Country Picker Bottom Sheet
• ☎️ Smart Phone Number Input
• ✅ Country-based Validation
• 🔄 Auto Parsing of International Numbers (+880...)
• 🎨 Fully Customizable UI & Theme
• 🚫 Whitelist / Blacklist Countries
• 🌐 Compose Multiplatform Ready
• 🧩 Use Built-in UI or Build Your Own

Country Picker

Phone Input Field

Error & Validation

<dependency>
    <groupId>io.github.mdabdulkayum</groupId>
    <artifactId>cmp-countrypicker</artifactId>
    <version>1.0.9</version>
</dependency>

implementation("io.github.mdabdulkayum:cmp-countrypicker:1.0.9")

implementation 'io.github.mdabdulkayum:cmp-countrypicker:1.0.9'

val pickerState = rememberCountryPickerState()

var isOpen by remember { mutableStateOf(false) }

Button(onClick = { isOpen = true }) {
    Text("Select Country")
}

CountryPickerBottomSheet(
    state = pickerState,
    isOpen = isOpen,
    onDismiss = { isOpen = false },
    onCountrySelected = { country ->
        println("Selected: ${country.name}")
    }
)

var phoneState by remember {
    mutableStateOf(PhoneInputState())
}

PhoneInputField(
    state = phoneState,
    onStateChange = { phoneState = it }
)

var phoneState by remember {
    mutableStateOf(PhoneInputState())
}

PhoneInputField(
    state = phoneState,
    onStateChange = { phoneState = it },
    defaultCountry = CountryRepository.getByIso2("BD"),
    countryFilter = CountryFilter.Whitelist(
        setOf("BD", "US", "IN")
    ),
    allowFormatting = true,
    showCountryFlag = true,
    showCountryISO2 = true
)

Easily customize the look and behavior:

PhoneInputField(
    state = state,
    onStateChange = { },
    theme = CountryPickerThemeDefaults.light(),
    showCountryCode = true,
    showCountryFlag = true,
    showCountryISO2 = false
)

• Light / Dark themes
• Custom typography
• Custom colors
• Shape customization

Control which countries are visible:

// Show all
CountryFilter.All

// Only specific countries
CountryFilter.Whitelist(setOf("US", "BD", "IN"))

// Exclude countries
CountryFilter.Blacklist(setOf("PK", "AF"))

val state = PhoneInputState.fromFullNumber("+8801712345678")

• Automatically detects country
• Extracts national number
• Applies validation

• Country-specific rules
• Length validation
• Optional regex support

allowFormatting = true

• Toggle formatting dynamically
• Displays formatted output below input

Easily mark a field as required by adding * to the label.

The library will automatically render the * in red color, keeping your UI clean and consistent.

PhoneInputField(
    state = phoneState,
    onStateChange = { phoneState = it },
    label = "Phone Number *"
)

• "Phone Number" → displayed as normal text
• "*" → automatically styled in red

The label is internally parsed and styled using AnnotatedString:

fun buildRequiredLabel(label: String): AnnotatedString {
    return buildAnnotatedString {
        append(label.replace("*", "").trim())
        append(" ")
        withStyle(style = SpanStyle(color = Color.Red)) {
            append("*")
        }
    }
}

• No extra configuration required
• Automatically applied when * is present
• Ensures consistent required field indication across your app

• Name, ISO2, ISO3
• Dial code (+880)
• Flag emoji
• Validation rules

• Get all countries
• Search countries
• Filter countries
• Lookup by ISO / dial code

• Selected country
• Search query
• Filtered list

• Phone number
• Selected country
• Validation state
• Error handling

• Matches dial codes efficiently
• Handles overlapping dial codes (+1, +1-268)
• Extracts national number cleanly

• 🔐 Login / Signup forms
• 📲 OTP verification
• 🌍 International apps
• 🛒 E-commerce checkout
• 📞 Contact forms

• 🌐 Localization support
• 🖼 Replace emoji flags with image assets
• 💻 Improved Compose Desktop support
• 🌍 Web (Compose WASM) enhancements
• ⚡ Async country loading

Contributions are welcome!

1. Fork the repo
2. Create a feature branch
3. Commit your changes
4. Open a Pull Request

MIT License © 2026

If you like this project:

• ⭐ Star the repository
• 🐛 Report issues
• 💡 Suggest features

Md. Abdul Kayum

Built with ❤️ using Jetpack Compose & Compose Multiplatform