
Composable month, week, year calendars with Material 3 theming, flexible single/range/multi selection and drag-to-select, lunar and alternate calendar support, rich decorators, pickers and schedule views.
Compose Multiplatform calendars and date pickers for Android, iOS, Desktop and Web.
Month, week and year calendars; single, range and multi selection with drag-to-select;
Material 3 date, range, date-time and month picker dialogs; day and week schedules
with an agenda; heatmaps; and optional Chinese lunar, Hijri, Persian and
public-holiday modules. Day cells are composable slots styled by your Material 3
theme, and dates are kotlinx-datetime types.
▶ Try the live demo in your browser (Kotlin/Wasm, no install)
The shared Compose Multiplatform demo on Desktop (JVM), iOS and Web (Kotlin/Wasm): multi-day week event banners, a collapsible Month / TwoWeeks / Week calendar over the Agenda, a working-hours Day / Week schedule with stacked overlaps, hotel stays with split check-in / check-out endpoints and turnover days, and the style presets under a Mon–Fri two-week strip.
Expanded Month with spanning WeekEventBanners (+N overflow), TwoWeeks mode with drag handle, collapsed Week strip, and Dark theme with lunisolar sub-labels & event count badges:
SplitDiagonal check-in/check-out triangles and SplitHorizontal half-cell endpoints with same-day turnover (Oct 29) and nightly pricing sub-labels:
Custom circular progress ring day cells across a TwoWeeks strip and Month grid, plus visibleDaysOfWeek (Mon–Fri) 5-column weekday filtering:
Working-hours WeekSchedule (07:00–22:00) with all-day banners, current-time indicator, and SideBySide timed event lanes, alongside DaySchedule with EventOverlapMode.Stacked cascading cards:
12-month YearCalendar overview + GitHub-style HeatmapCalendar, and built-in CalendarStyle presets (roundedSquareStyle, segmentedRangeStyle, borderedCardStyle with Meizu W/H corner badges, and custom DayDecorator glow/festival styles):
Modal OrreryDatePickerDialog and full-screen OrreryDateRangePickerDialog with quick range preset chips:
Guides · API reference · Live demo · Changelog · Migrating from CalendarView
| Orrery | kizitonwose/Calendar | Material 3 DatePicker
|
|
|---|---|---|---|
| Platforms | Android, iOS, Desktop, Web (Wasm) | Android, iOS, Desktop, Web (JS and Wasm) | Android, plus Compose Multiplatform |
| Android Views | Compose only | ✅ View and Compose artifacts | ✅ MaterialDatePicker
|
| Month, week and year layouts | ✅ | ✅ | Month picker only |
| Ready-made day cells | ✅ DefaultDay, decorators, style presets |
You design the cells (by design) | Fixed Material look |
| Selection | Built in and validated: single, range (min/max), multi, week, month, drag-to-select | You implement it on top of the day cells | Single or range |
| Disabled dates |
DisabledDates DSL; blocks ranges that span them |
✅ | SelectableDates |
| Picker dialogs | Date, range with presets, date-time, month | – | Date and range (time picker is separate) |
| Day/week schedules and agenda | ✅ | – | – |
| Heatmap | ✅ | ✅ | – |
| Lunar, Hijri, Persian, public holidays | ✅ optional modules | – | – |
| Home-screen widget and share-image snapshots | Experimental orrery-widget: month, week and agenda bitmaps (guide) |
– | – |
| Maturity | Pre-1.0, new | Mature, widely used | First-party |
Choose kizitonwose/Calendar if you need Android Views, Kotlin/JS or a long track record, and Material 3's picker if a standard dialog is all you need. Orrery is for when you want calendars, pickers and schedules that work out of the box and look like the rest of your Material 3 app.
The library ships these artifacts on Maven Central under the group
me.kozakov.orrery:
| Artifact | Contents |
|---|---|
me.kozakov.orrery:orrery-core |
Pure-Kotlin calendar models, grid math and selection engine |
me.kozakov.orrery:orrery-compose |
Jetpack Compose calendar composables with Material3 theming |
me.kozakov.orrery:orrery-lunar |
Chinese lunisolar calendar, solar terms and festivals as a DayInfoProvider |
me.kozakov.orrery:orrery-calendars |
Hijri (Umm al-Qura, tabular) and Persian calendars as DayInfoProviders |
me.kozakov.orrery:orrery-holidays |
Rule-based public holidays for US, GB, DE and UA as a DayInfoProvider |
me.kozakov.orrery:orrery-widget |
Experimental, not released yet (#89). Headless calendar snapshots for app widgets and share images |
Multiplatform:
orrery-composealso publishes Desktop (JVM), iOS and Web (wasmJs) variants. In a Kotlin Multiplatform project, add it tocommonMaindependencies and Gradle picks the variant for each target.
orrery-compose already depends on orrery-core. Use the same version for every
orrery-* artifact.
// app/build.gradle.kts
dependencies {
implementation("me.kozakov.orrery:orrery-compose:0.9.2")
// Optional DayInfoProvider modules:
implementation("me.kozakov.orrery:orrery-lunar:0.9.2")
implementation("me.kozakov.orrery:orrery-calendars:0.9.2")
implementation("me.kozakov.orrery:orrery-holidays:0.9.2")
}Using a version catalog
(gradle/libs.versions.toml)?
[versions]
orrery = "0.9.2"
[libraries]
orrery-compose = { module = "me.kozakov.orrery:orrery-compose", version.ref = "orrery" }
orrery-lunar = { module = "me.kozakov.orrery:orrery-lunar", version.ref = "orrery" }
orrery-calendars = { module = "me.kozakov.orrery:orrery-calendars", version.ref = "orrery" }
orrery-holidays = { module = "me.kozakov.orrery:orrery-holidays", version.ref = "orrery" }// app/build.gradle.kts
dependencies {
implementation(libs.orrery.compose)
implementation(libs.orrery.lunar) // optional
}@Composable
fun TripCalendar() {
val state = rememberCalendarState()
val selection = rememberCalendarSelectionState(mode = SelectionMode.Range(maxDays = 14))
Column {
CalendarNavHeader(state = state)
HorizontalCalendar(state = state, dragSelection = selection) { day ->
DefaultDay(day, selectionState = selection)
}
Text(selection.selection.range?.let { "${it.start} – ${it.endInclusive}" } ?: "Pick your dates")
}
}Tap two days, or long-press and drag, to pick a range of up to 14 days. From here, add decorators for event dots or progress rings, disabled dates, or swap the calendar for a picker dialog.
The sample app (sample/) is five product-style screens: an Agenda with a
collapsible calendar and named events (switchable to Day and Week time grids), a Trips booking flow with drag-select,
nightly prices, blackout dates and stay rules (minimum / maximum nights, no stay across a booked night), a Habits tracker with streaks and animated
progress rings, an Almanac backed by orrery-lunar, orrery-calendars and orrery-holidays, and a Pickers screen
demonstrating all four picker dialogs.
| Area | What you get | Guide |
|---|---|---|
| Calendars |
HorizontalCalendar, VerticalCalendar, WeekCalendar, YearCalendar; unbounded scrolling; two-week and work-week (e.g. Mon–Fri) modes; CollapsibleCalendarScaffold with Month / TwoWeeks / Week stops and spring-settled drags; week numbers, sticky month headers, CalendarNavHeader; next / previous month and week step helpers; keyboard and D-pad navigation in every calendar; Flow observation of visible months |
Calendars |
| Selection | Single (with auto-advance), range (min/max days), multi, week and month modes; booking guardrails (minimum / maximum stay, no range across a disabled date); long-press drag-to-select; DisabledDates; presets and validated programmatic writes; selection haptics |
Selection |
| Day cells and styling |
DefaultDay with per-state colors and shapes, today indicators, segmented or banded range fills, hospitality check-in / check-out range endpoints, weekend tinting, animated color changes, CalendarStyle presets |
Day cells |
| Decorators and heatmaps | Event dots, progress rings and bars, count badges, strikethrough, underline, custom DrawScope decorators, animated values; HeatmapCalendar and HeatmapMonth
|
Day cells |
| Events |
DaySchedule / WeekSchedule time grids (side-by-side or stacked overlaps, working-hours window, all-day banners, pinch-to-zoom and animated programmatic zoom, page step helpers, current-time line); Agenda; multi-day WeekEventBanners on month calendars |
Schedules |
| Pickers |
OrreryDatePickerDialog, OrreryDateRangePickerDialog with preset chips, OrreryDateTimePickerDialog, OrreryMonthPickerDialog; calendar and text-input modes |
Pickers |
| Calendar systems |
orrery-lunar: lunar dates (conversion golden-tested against CalendarView for every day of 1900–2099), 24 solar terms, festivals and 干支 years. orrery-calendars: Hijri (Umm al-Qura, tabular) and Persian, checked day by day against java.time and ICU4J. orrery-holidays: US, GB, DE and UA public holidays, checked against python-holidays for 2000–2050, plus your own rules |
Calendar systems |
| Platform and quality | Material 3 theming with dark mode and dynamic color; accessibility semantics; RTL (mirrored range bands, check-in / check-out halves, schedule grid and arrow keys); locale-driven names and first day of week; built-in strings in English, Ukrainian, German, Spanish, Simplified Chinese and Japanese |
Orrery is pre-1.0, so public APIs can still change between minor versions. Every
change is listed in the CHANGELOG, and CI checks the public API with
Kotlin's ABI validation (checkKotlinAbi), so API changes are always deliberate.
| Orrery | Kotlin | Compose Multiplatform | Compose BOM (Android) | kotlinx-datetime | Android compileSdk
|
|---|---|---|---|---|---|
| 0.7.0 – 0.9.2 | 2.4.21 | 1.12.2 | 2026.09.00 | 0.8.0 | 37 |
| 0.6.0 | 2.4.0 | 1.11.1 | 2026.06.01 | 0.8.0 | 36 |
These are the versions each release was built against. Android apps need minSdk 23
and, from 0.7.0, compileSdk 37 (Compose 1.12 requires it). Releases before 0.6.0
are Android-only.
Snapshots: development builds are published as
0.9.2-SNAPSHOTto the Central snapshots repository. To use them, addmaven("https://central.sonatype.com/repository/maven-snapshots/")to your repositories and depend on the-SNAPSHOTversion.
ComposeView, or
use orrery-core for the grid math and selection rules.orrery-compose ships
arm64 device and Apple-silicon simulator builds, not iosX64.Bug reports, questions and pull requests are welcome. See CONTRIBUTING.md for how to build, test and send changes.
Apache License 2.0 — see LICENSE. Ports algorithms and data tables from CalendarView (Apache 2.0); see NOTICE.
Compose Multiplatform calendars and date pickers for Android, iOS, Desktop and Web.
Month, week and year calendars; single, range and multi selection with drag-to-select;
Material 3 date, range, date-time and month picker dialogs; day and week schedules
with an agenda; heatmaps; and optional Chinese lunar, Hijri, Persian and
public-holiday modules. Day cells are composable slots styled by your Material 3
theme, and dates are kotlinx-datetime types.
▶ Try the live demo in your browser (Kotlin/Wasm, no install)
The shared Compose Multiplatform demo on Desktop (JVM), iOS and Web (Kotlin/Wasm): multi-day week event banners, a collapsible Month / TwoWeeks / Week calendar over the Agenda, a working-hours Day / Week schedule with stacked overlaps, hotel stays with split check-in / check-out endpoints and turnover days, and the style presets under a Mon–Fri two-week strip.
Expanded Month with spanning WeekEventBanners (+N overflow), TwoWeeks mode with drag handle, collapsed Week strip, and Dark theme with lunisolar sub-labels & event count badges:
SplitDiagonal check-in/check-out triangles and SplitHorizontal half-cell endpoints with same-day turnover (Oct 29) and nightly pricing sub-labels:
Custom circular progress ring day cells across a TwoWeeks strip and Month grid, plus visibleDaysOfWeek (Mon–Fri) 5-column weekday filtering:
Working-hours WeekSchedule (07:00–22:00) with all-day banners, current-time indicator, and SideBySide timed event lanes, alongside DaySchedule with EventOverlapMode.Stacked cascading cards:
12-month YearCalendar overview + GitHub-style HeatmapCalendar, and built-in CalendarStyle presets (roundedSquareStyle, segmentedRangeStyle, borderedCardStyle with Meizu W/H corner badges, and custom DayDecorator glow/festival styles):
Modal OrreryDatePickerDialog and full-screen OrreryDateRangePickerDialog with quick range preset chips:
Guides · API reference · Live demo · Changelog · Migrating from CalendarView
| Orrery | kizitonwose/Calendar | Material 3 DatePicker
|
|
|---|---|---|---|
| Platforms | Android, iOS, Desktop, Web (Wasm) | Android, iOS, Desktop, Web (JS and Wasm) | Android, plus Compose Multiplatform |
| Android Views | Compose only | ✅ View and Compose artifacts | ✅ MaterialDatePicker
|
| Month, week and year layouts | ✅ | ✅ | Month picker only |
| Ready-made day cells | ✅ DefaultDay, decorators, style presets |
You design the cells (by design) | Fixed Material look |
| Selection | Built in and validated: single, range (min/max), multi, week, month, drag-to-select | You implement it on top of the day cells | Single or range |
| Disabled dates |
DisabledDates DSL; blocks ranges that span them |
✅ | SelectableDates |
| Picker dialogs | Date, range with presets, date-time, month | – | Date and range (time picker is separate) |
| Day/week schedules and agenda | ✅ | – | – |
| Heatmap | ✅ | ✅ | – |
| Lunar, Hijri, Persian, public holidays | ✅ optional modules | – | – |
| Home-screen widget and share-image snapshots | Experimental orrery-widget: month, week and agenda bitmaps (guide) |
– | – |
| Maturity | Pre-1.0, new | Mature, widely used | First-party |
Choose kizitonwose/Calendar if you need Android Views, Kotlin/JS or a long track record, and Material 3's picker if a standard dialog is all you need. Orrery is for when you want calendars, pickers and schedules that work out of the box and look like the rest of your Material 3 app.
The library ships these artifacts on Maven Central under the group
me.kozakov.orrery:
| Artifact | Contents |
|---|---|
me.kozakov.orrery:orrery-core |
Pure-Kotlin calendar models, grid math and selection engine |
me.kozakov.orrery:orrery-compose |
Jetpack Compose calendar composables with Material3 theming |
me.kozakov.orrery:orrery-lunar |
Chinese lunisolar calendar, solar terms and festivals as a DayInfoProvider |
me.kozakov.orrery:orrery-calendars |
Hijri (Umm al-Qura, tabular) and Persian calendars as DayInfoProviders |
me.kozakov.orrery:orrery-holidays |
Rule-based public holidays for US, GB, DE and UA as a DayInfoProvider |
me.kozakov.orrery:orrery-widget |
Experimental, not released yet (#89). Headless calendar snapshots for app widgets and share images |
Multiplatform:
orrery-composealso publishes Desktop (JVM), iOS and Web (wasmJs) variants. In a Kotlin Multiplatform project, add it tocommonMaindependencies and Gradle picks the variant for each target.
orrery-compose already depends on orrery-core. Use the same version for every
orrery-* artifact.
// app/build.gradle.kts
dependencies {
implementation("me.kozakov.orrery:orrery-compose:0.9.2")
// Optional DayInfoProvider modules:
implementation("me.kozakov.orrery:orrery-lunar:0.9.2")
implementation("me.kozakov.orrery:orrery-calendars:0.9.2")
implementation("me.kozakov.orrery:orrery-holidays:0.9.2")
}Using a version catalog
(gradle/libs.versions.toml)?
[versions]
orrery = "0.9.2"
[libraries]
orrery-compose = { module = "me.kozakov.orrery:orrery-compose", version.ref = "orrery" }
orrery-lunar = { module = "me.kozakov.orrery:orrery-lunar", version.ref = "orrery" }
orrery-calendars = { module = "me.kozakov.orrery:orrery-calendars", version.ref = "orrery" }
orrery-holidays = { module = "me.kozakov.orrery:orrery-holidays", version.ref = "orrery" }// app/build.gradle.kts
dependencies {
implementation(libs.orrery.compose)
implementation(libs.orrery.lunar) // optional
}@Composable
fun TripCalendar() {
val state = rememberCalendarState()
val selection = rememberCalendarSelectionState(mode = SelectionMode.Range(maxDays = 14))
Column {
CalendarNavHeader(state = state)
HorizontalCalendar(state = state, dragSelection = selection) { day ->
DefaultDay(day, selectionState = selection)
}
Text(selection.selection.range?.let { "${it.start} – ${it.endInclusive}" } ?: "Pick your dates")
}
}Tap two days, or long-press and drag, to pick a range of up to 14 days. From here, add decorators for event dots or progress rings, disabled dates, or swap the calendar for a picker dialog.
The sample app (sample/) is five product-style screens: an Agenda with a
collapsible calendar and named events (switchable to Day and Week time grids), a Trips booking flow with drag-select,
nightly prices, blackout dates and stay rules (minimum / maximum nights, no stay across a booked night), a Habits tracker with streaks and animated
progress rings, an Almanac backed by orrery-lunar, orrery-calendars and orrery-holidays, and a Pickers screen
demonstrating all four picker dialogs.
| Area | What you get | Guide |
|---|---|---|
| Calendars |
HorizontalCalendar, VerticalCalendar, WeekCalendar, YearCalendar; unbounded scrolling; two-week and work-week (e.g. Mon–Fri) modes; CollapsibleCalendarScaffold with Month / TwoWeeks / Week stops and spring-settled drags; week numbers, sticky month headers, CalendarNavHeader; next / previous month and week step helpers; keyboard and D-pad navigation in every calendar; Flow observation of visible months |
Calendars |
| Selection | Single (with auto-advance), range (min/max days), multi, week and month modes; booking guardrails (minimum / maximum stay, no range across a disabled date); long-press drag-to-select; DisabledDates; presets and validated programmatic writes; selection haptics |
Selection |
| Day cells and styling |
DefaultDay with per-state colors and shapes, today indicators, segmented or banded range fills, hospitality check-in / check-out range endpoints, weekend tinting, animated color changes, CalendarStyle presets |
Day cells |
| Decorators and heatmaps | Event dots, progress rings and bars, count badges, strikethrough, underline, custom DrawScope decorators, animated values; HeatmapCalendar and HeatmapMonth
|
Day cells |
| Events |
DaySchedule / WeekSchedule time grids (side-by-side or stacked overlaps, working-hours window, all-day banners, pinch-to-zoom and animated programmatic zoom, page step helpers, current-time line); Agenda; multi-day WeekEventBanners on month calendars |
Schedules |
| Pickers |
OrreryDatePickerDialog, OrreryDateRangePickerDialog with preset chips, OrreryDateTimePickerDialog, OrreryMonthPickerDialog; calendar and text-input modes |
Pickers |
| Calendar systems |
orrery-lunar: lunar dates (conversion golden-tested against CalendarView for every day of 1900–2099), 24 solar terms, festivals and 干支 years. orrery-calendars: Hijri (Umm al-Qura, tabular) and Persian, checked day by day against java.time and ICU4J. orrery-holidays: US, GB, DE and UA public holidays, checked against python-holidays for 2000–2050, plus your own rules |
Calendar systems |
| Platform and quality | Material 3 theming with dark mode and dynamic color; accessibility semantics; RTL (mirrored range bands, check-in / check-out halves, schedule grid and arrow keys); locale-driven names and first day of week; built-in strings in English, Ukrainian, German, Spanish, Simplified Chinese and Japanese |
Orrery is pre-1.0, so public APIs can still change between minor versions. Every
change is listed in the CHANGELOG, and CI checks the public API with
Kotlin's ABI validation (checkKotlinAbi), so API changes are always deliberate.
| Orrery | Kotlin | Compose Multiplatform | Compose BOM (Android) | kotlinx-datetime | Android compileSdk
|
|---|---|---|---|---|---|
| 0.7.0 – 0.9.2 | 2.4.21 | 1.12.2 | 2026.09.00 | 0.8.0 | 37 |
| 0.6.0 | 2.4.0 | 1.11.1 | 2026.06.01 | 0.8.0 | 36 |
These are the versions each release was built against. Android apps need minSdk 23
and, from 0.7.0, compileSdk 37 (Compose 1.12 requires it). Releases before 0.6.0
are Android-only.
Snapshots: development builds are published as
0.9.2-SNAPSHOTto the Central snapshots repository. To use them, addmaven("https://central.sonatype.com/repository/maven-snapshots/")to your repositories and depend on the-SNAPSHOTversion.
ComposeView, or
use orrery-core for the grid math and selection rules.orrery-compose ships
arm64 device and Apple-silicon simulator builds, not iosX64.Bug reports, questions and pull requests are welcome. See CONTRIBUTING.md for how to build, test and send changes.
Apache License 2.0 — see LICENSE. Ports algorithms and data tables from CalendarView (Apache 2.0); see NOTICE.