KmpNativeDatePicker
1.0.2indexedTruly native date picker UI leveraging system pickers, auto-inheriting app theming; asynchronous suspend-style APIs for single or range selection, plus UI toolkit helper.
1
Stars
—
Used by
dependents
—
Health
/ 100
📅 KmpNativeDatePicker
A Kotlin Multiplatform library that provides a truly native Date and Time Picker experience for both Android and iOS. This library uses platform-specific components that automatically inherit your application's theme and branding.
✨ Features
📺 Demo
| Android | iOS |
|---|---|
 |  |
📦 Installation
Add the dependency to your commonMain source set in your build.gradle.kts:
kotlin {
sourceSets {
commonMain.dependencies {
implementation("io.github.ktsnippetbyshubham:kmp-native-datepicker:1.0.2")
}
}
}
🚀 Usage
1️⃣ In Compose Multiplatform (Recommended)
📅 Date Picker
val datePicker = rememberDatePicker()
val scope = rememberCoroutineScope()
Button(onClick = {
scope.launch {
val selectedMillis = datePicker.pickDate(
title = "Select Birthday"
)
if (selectedMillis != null) {
// Handle selected date
}
}
}) {
Text("Open Date Picker")
}
🕒 Time Picker
val timePicker = rememberTimePicker()
Button(onClick = {
scope.launch {
val time = timePicker.pickTime(
title = "Select Time",
is24Hour = true
)
if (time != null) {
println("Selected: ${time.hour}:${time.minute}")
}
}
}) {
Text("Open Time Picker")
}
🗓 Date Range Picker
Button(onClick = {
scope.launch {
val range = datePicker.pickDateRange(
title = "Select Vacation Dates"
)
if (range != null) {
println("Range: ${range.startDateMillis} - ${range.endDateMillis}")
}
}
}) {
Text("Open Range Picker")
}
2️⃣ Manual Initialization
If you are not using Compose:
- Android:
val datePicker = DatePickerFactory(context).createDatePicker()val timePicker = TimePickerFactory(context).createTimePicker()
- iOS:
val datePicker = DatePickerFactory().createDatePicker()
🎨 Theming & Customization
The library is designed to be "Brand-Aware". You don't need to pass color codes manually.
🤖 Android
The pickers follow your MaterialTheme. To change the color, simply update your colorPrimary in your app's theme:
<item name="colorPrimary">#FF5722</item> <!-- Your brand color -->
🍎 iOS
The pickers automatically use the System Global Tint. If you have set a custom tint color for your app's window, the picker buttons and selection highlights will match it automatically.
📖 API Reference
pickDate
pickTime
🛠 Platform Details
📄 License
Apache License 2.0. See LICENSE for details.