🚩 Country Picker KMP

You've just started a new project and need to implement a feature that allows users to select a country, phone number, dial code, or currency and you're realizing it involves a lot of boilerplate: managing country data, handling flags, and building a clean UI. This library is built to solve exactly that. It provides a powerful yet simple Country enum class that includes all these information for you. But it doesn’t stop there. To make integration even better, the library includes two prebuilt UI components:

CountryPickerDialog: A searchable dialog that allows users to browse and select from a list of countries.

CountryPickerField: A UI component similar to a TextField that displays the currently selected country and opens the picker dialog on click.

This is a lightweight and fully customizable Kotlin Multiplatform (KMP) solution designed to work seamlessly across Android, iOS, Desktop, Kotlin/JS and Kotlin/WASM targets.

• ✅ Predefined list of countries with:
  • Name
  • Dial code
  • Currency
  • ISO code
  • Flag resource
• ✅ Built-in CountryPickerDialog and CountryPickerField Composables
• ✅ Real-time search support
• ✅ Multiple display options: Dial Code, Currency, Name
• ✅ Kotlin Multiplatform ready (Android, iOS, Desktop, WASM)

Make sure to include the library in your commonMain source set:

implementation("com.stevdza-san:countrypicker:1.0.4")

Or a version catalog (libs.versions.toml)

[versions]
country-picker = "1.0.4"

[libraries]
country-picker-kmp = { module = "com.stevdza-san:countrypicker", version.ref = "country-picker" }

var selectedCountry by remember { mutableStateOf(Country.Serbia) }
var showDialog by remember { mutableStateOf(false) }

AnimatedVisibility(visible = showDialog) {
    CountryPickerDialog(
        selectedCountry = selectedCountry,
        onConfirmClick = { country ->
            selectedCountry = country
            showDialog = false
        },
        onDismiss = { showDialog = false }
    )
}

CountryPickerField(
    selectedCountry = selectedCountry,
     onClick = { showDialog = true }
)

enum class CountryDisplayOption {
    NAME,
    CURRENCY,
    DIAL_CODE,
    ISO_CODE,
    DIAL_CODE_AND_NAME,
    NAME_AND_CURRENCY,
    NAME_AND_ISO_CODE
}

enum class Country(
    val dialCode: Int,
    val currency: String,
    val flag: DrawableResource,
    val isoCode: String
)

val allCountries = Country.entries

⭐ Give a star to this repository.
☕ Let's get a coffee. You're paying!😜 https://ko-fi.com/stevdza_san

Designed and developed by stevdza-san (Stefan Jovanović)

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

   http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.