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.

• 🎯 100% Native UI: Uses Google's MaterialDatePicker/MaterialTimePicker on Android and Apple's UIDatePicker on iOS.
• 🎨 Zero-Config Theming: Automatically adopts the host app's colors (e.g., if your app is Orange, the picker turns Orange).
• 🚀 Coroutines Powered: Simple suspend functions that return selected values or null if cancelled.
• 🏗 Compose Multiplatform Ready: Includes rememberDatePicker() and rememberTimePicker() helpers for seamless integration.
• 📅 Range & Time Support: Built-in support for selecting date ranges and specific times with a native experience.

Android	iOS

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")
        }
    }
}

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")
}

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")
}

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")
}

If you are not using Compose:

• Android:
  • val datePicker = DatePickerFactory(context).createDatePicker()
  • val timePicker = TimePickerFactory(context).createTimePicker()
• iOS:
  • val datePicker = DatePickerFactory().createDatePicker()
  • val timePicker = TimePickerFactory().createTimePicker()

The library is designed to be "Brand-Aware". You don't need to pass color codes manually.

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 -->

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.

• Android: Uses MaterialDatePicker and MaterialTimePicker from Google's Material Components.
• iOS: Uses UIDatePicker inside a UIAlertController.
  • Date: Uses UIDatePickerStyleWheels.
  • Time: Uses UIDatePickerStyleWheels.
  • Range: Uses a custom UIAlertController with a segmented control and UIDatePickerStyleInline for a smooth sequential selection.

Apache License 2.0. See LICENSE for details.