Simplifies country selection by offering a predefined country list with names, dial codes, currencies, and flags. Includes customizable UI components for real-time search and selection.
🚩 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.
CountryPickerDialog and ComposablesMake sure to include the library in your commonMain source set:
implementation("com.stevdza-san:countrypicker:1.0.5")
Or a version catalog (libs.versions.toml)
[versions]
country-picker = "1.0.5"
[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.
CountryPickerFieldSurfaced from shared tags and platforms — no rankings paid for.