[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"project-7248":3},{"id":4,"name":5,"fullName":6,"owner":7,"repo":5,"description":8,"homepage":9,"htmlUrl":10,"language":11,"languages":10,"totalLinesOfCode":10,"stars":12,"forks":13,"watchers":14,"openIssues":15,"contributorsCount":16,"subscribersCount":16,"size":16,"stars1d":16,"stars7d":17,"stars30d":18,"stars90d":16,"forks30d":16,"starsTrendScore":19,"compositeScore":20,"rankGlobal":10,"rankLanguage":10,"license":21,"archived":22,"fork":22,"defaultBranch":23,"hasWiki":24,"hasPages":22,"topics":25,"createdAt":10,"pushedAt":10,"updatedAt":46,"readmeContent":47,"aiSummary":48,"trendingCount":16,"starSnapshotCount":16,"syncStatus":49,"lastSyncTime":50,"discoverSource":51},7248,"Calendar","kizitonwose\u002FCalendar","kizitonwose","A highly customizable calendar view and compose library for Android and Kotlin Multiplatform.","",null,"Kotlin",5545,581,33,9,0,6,17,1,68.99,"MIT License",false,"main",true,[26,27,28,29,30,31,32,33,34,35,36,37,38,39,40,41,42,43,44,45],"android","calendar","calendar-library","calendarview","compose","compose-calendar","compose-calendar-library","compose-multiplatform","date","date-range","date-range-picker","datepicker","heatmap-calendar","kmp","kmp-library","kotlin","kotlin-multiplatform","month-calendar","week-calendar","year-calendar","2026-06-12 04:00:32","# Calendar\n\nA highly customizable calendar library for Android and Compose Multiplatform, backed by RecyclerView for the view system, and LazyRow\u002FLazyColumn for compose.\n\n[![Check](https:\u002F\u002Fgithub.com\u002Fkizitonwose\u002FCalendar\u002Factions\u002Fworkflows\u002Fcheck.yml\u002Fbadge.svg?branch=main)](https:\u002F\u002Fgithub.com\u002Fkizitonwose\u002FCalendar\u002Factions\u002Fworkflows\u002Fcheck.yml)\n[![License](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FLicense-MIT-0097A7.svg)](https:\u002F\u002Fgithub.com\u002Fkizitonwose\u002FCalendar\u002Fblob\u002Fmain\u002FLICENSE.md)\n[![Twitter](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FTwitter-@kizitonwose-9C27B0.svg)](https:\u002F\u002Ftwitter.com\u002Fkizitonwose)\n[![Android Library](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002Fdynamic\u002Fxml.svg?label=Android%20Library&color=blue&url=https:\u002F\u002Frepo1.maven.org\u002Fmaven2\u002Fcom\u002Fkizitonwose\u002Fcalendar\u002Fcore\u002Fmaven-metadata.xml&query=(\u002F\u002Fmetadata\u002Fversioning\u002Fversions\u002Fversion)[not(contains(text(),%27-%27))][last()])](https:\u002F\u002Fcentral.sonatype.com\u002Fsearch?q=g:com.kizitonwose.calendar)\n[![Multiplatform Library](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002Fdynamic\u002Fxml.svg?label=Multiplatform%20Library&color=blue&url=https:\u002F\u002Frepo1.maven.org\u002Fmaven2\u002Fcom\u002Fkizitonwose\u002Fcalendar\u002Fcompose-multiplatform\u002Fmaven-metadata.xml&query=(\u002F\u002Fmetadata\u002Fversioning\u002Fversions\u002Fversion)[not(contains(text(),%27-%27))][last()])](https:\u002F\u002Fcentral.sonatype.com\u002Fsearch?q=g:com.kizitonwose.calendar)\n\n**With this library, your calendar will look however you want it to.**\n\n![Preview Phone](https:\u002F\u002Fuser-images.githubusercontent.com\u002F15170090\u002F197389318-b3925b65-aed9-4e1f-a778-ba73007cbdf7.png)\n\n![Preview Web Tablet](https:\u002F\u002Fgithub.com\u002Fuser-attachments\u002Fassets\u002Fdf7b11bb-23f8-423a-bbd4-9ade376a14be)\n\n## Features\n\n- [x] Week, month, or year modes - Show a week-based calendar, or the typical month calendar, or a year-based calendar.\n- [x] Single, multiple, or range selection - Total flexibility to implement the date selection\n  whichever way you like.\n- [x] Disable desired dates - Prevent selection of some dates by disabling them.\n- [x] Boundary dates - Limit the calendar date range.\n- [x] Custom date view\u002Fcomposable - Make your day cells look however you want, with any\n  functionality you want.\n- [x] Custom calendar view\u002Fcomposable - Make your calendar look however you want, with whatever\n  functionality you want.\n- [x] Custom first day of the week - Use any day as the first day of the week.\n- [x] Horizontal or vertical scrolling calendar.\n- [x] HeatMap calendar - Suitable for showing how data changes over time, like GitHub's contribution\n  chart.\n- [x] Year\u002FMonth\u002FWeek headers and footers - Add headers\u002Ffooters of any kind on each year\u002Fmonth\u002Fweek.\n- [x] Easily scroll to any date\u002Fweek\u002Fmonth\u002Fyear on the calendar via swipe actions or programmatically.\n- [x] Use all RecyclerView\u002FLazyRow\u002FLazyColumn customizations since the calendar extends from\n  RecyclerView for the view system and uses LazyRow\u002FLazyColumn for compose.\n- [x] Design your calendar [however you want.](https:\u002F\u002Fgithub.com\u002Fkizitonwose\u002FCalendar\u002Fissues\u002F1) The\n  library provides the logic, you provide the views\u002Fcomposables.\n\n## Sample project\n\nIt's important to check out the sample app. There are lots of examples provided for both view and compose implementations. \nMost techniques that you would want to implement are already done in the examples.\n\nDownload the Android sample app [here](https:\u002F\u002Fgithub.com\u002Fkizitonwose\u002FCalendar\u002Freleases\u002Fdownload\u002F2.5.4\u002Fsample.apk)\n\nView the Android sample app's source code [here](https:\u002F\u002Fgithub.com\u002Fkizitonwose\u002FCalendar\u002Ftree\u002Fmain\u002Fsample)\n\nView the multiplatform sample project online at https:\u002F\u002Fcalendar.kizitonwose.dev\n\nView the multiplatform sample project's source code [here](https:\u002F\u002Fgithub.com\u002Fkizitonwose\u002FCalendar\u002Ftree\u002Fmain\u002Fcompose-multiplatform\u002Fsample)\n\n## Setup\n\nThe library provides the following artifacts: \n\n`com.kizitonwose.calendar:compose`: The compose artifact for Android projects. This uses the [java.time](https:\u002F\u002Fdocs.oracle.com\u002Fjavase\u002F8\u002Fdocs\u002Fapi\u002Fjava\u002Ftime\u002Fpackage-summary.html) APIs. \n\n`com.kizitonwose.calendar:compose-multiplatform`: The compose artifact for Compose Multiplatform projects. This uses the [kotlinx-datetime](https:\u002F\u002Fgithub.com\u002FKotlin\u002Fkotlinx-datetime) library and supports Android, iOS, js, WasmJs and Desktop platforms.\n\n`com.kizitonwose.calendar:view`: The view artifact for Android projects. This uses the [java.time](https:\u002F\u002Fdocs.oracle.com\u002Fjavase\u002F8\u002Fdocs\u002Fapi\u002Fjava\u002Ftime\u002Fpackage-summary.html) APIs and can exist alongside the Android compose artifact in an Android project if needed.\n\n#### Step 1\n\n**This step is required ONLY if your Android app's `minSdkVersion` is below 26. Jump to [step 2](#step-2) if this does not apply to you.**\n\nAndroid apps with `minSdkVersion` below 26 have to enable [Java 8+ API desugaring](https:\u002F\u002Fdeveloper.android.com\u002Fstudio\u002Fwrite\u002Fjava8-support#library-desugaring) for backward compatibility since `java.time` classes were added in Java 8 which is supported natively starting from Android SDK 26. To set up your project for desugaring, you need to first ensure that you are using [Android Gradle plugin](https:\u002F\u002Fdeveloper.android.com\u002Fstudio\u002Freleases\u002Fgradle-plugin#updating-plugin) 4.0.0 or higher.\n\nThen include the following in your app's `build.gradle` file:\n\n```groovy\nandroid {\n  defaultConfig {\n    \u002F\u002F Required ONLY if your minSdkVersion is below 21\n    multiDexEnabled true\n  }\n\n  compileOptions {\n    \u002F\u002F Enable support for the new language APIs\n    coreLibraryDesugaringEnabled true\n    \u002F\u002F Set Java compatibility (version can be higher if desired)\n    sourceCompatibility JavaVersion.VERSION_1_8\n    targetCompatibility JavaVersion.VERSION_1_8\n  }\n\n  kotlinOptions {\n    \u002F\u002F Also add this for Kotlin projects (version can be higher if desired)\n    jvmTarget = \"1.8\"\n  }\n}\n\ndependencies {\n  coreLibraryDesugaring 'com.android.tools:desugar_jdk_libs:\u003Clatest-version>'\n}\n```\n\nYou can find the latest version of `desugar_jdk_libs` [here](https:\u002F\u002Fmvnrepository.com\u002Fartifact\u002Fcom.android.tools\u002Fdesugar_jdk_libs).\n\n#### Step 2A - For pure Android projects without multiplatform setup\n\nAdd the desired calendar library (view or compose) to your app's `build.gradle.kts`:\n\n```kotlin\ndependencies {\n  \u002F\u002F The view calendar library for Android\n  implementation(\"com.kizitonwose.calendar:view:\u003Clatest-version>\")\n\n  \u002F\u002F The compose calendar library for Android\n  implementation(\"com.kizitonwose.calendar:compose:\u003Clatest-version>\")\n}\n```\n\n#### Step 2B - For Compose Multiplatform projects\n\nAdd the multiplatform calendar library to your project's `build.gradle.kts`:\n\n```kotlin\ncommonMain.dependencies {\n  \u002F\u002F The calendar library for compose multiplatform projects\n  \u002F\u002F Supports Android, iOS, js, WasmJs and Desktop platforms\n  implementation(\"com.kizitonwose.calendar:compose-multiplatform:\u003Clatest-version>\")\n}\n```\n\nYou can find the latest version of the library on the maven central badge above.\n\nSnapshots of the development version are available in [Central Portal Snapshots repository](https:\u002F\u002Fcentral.sonatype.com\u002Fservice\u002Frest\u002Frepository\u002Fbrowse\u002Fmaven-snapshots\u002Fcom\u002Fkizitonwose\u002Fcalendar\u002F).\n\n#### Compose UI version compatibility\n\nFor the compose calendar library, ensure that you are using the library version that matches the Compose UI version in your project. If you use a version of the library that has a higher version of Compose UI than the one in your project, gradle will upgrade the Compose UI version in your project via transitive dependency.\n\n| Compose UI | Android Calendar Library | Multiplatform Calendar Library |\n|:----------:|:------------------------:|:------------------------------:|\n|   1.2.x    |          2.0.x           |               -                |\n|   1.3.x    |      2.1.x - 2.2.x       |               -                |\n|   1.4.x    |          2.3.x           |               -                |\n|   1.5.x    |          2.4.x           |               -                |\n|   1.6.x    |          2.5.x           |             2.5.x              |\n|   1.7.x    |          2.6.x           |             2.6.x              |\n|   1.8.x    |      2.7.x - 2.8.x       |         2.7.x - 2.8.x          |\n|   1.9.x    |          2.9.x           |             2.9.x              |\n|   1.10.x   |          2.10.x          |             2.10.x             |\n\n## Usage\n\nYou can find the relevant documentation for the library in the links below.\n\n|[View-based documentation](https:\u002F\u002Fgithub.com\u002Fkizitonwose\u002FCalendar\u002Fblob\u002Fmain\u002Fdocs\u002FView.md)|[Compose documentation](https:\u002F\u002Fgithub.com\u002Fkizitonwose\u002FCalendar\u002Fblob\u002Fmain\u002Fdocs\u002FCompose.md)|\n|:-:|:-:|\n\n## Migration\n\nIf you're upgrading from calendar library version 1.x.x to 2.x.x, see the [migration guide](https:\u002F\u002Fgithub.com\u002Fkizitonwose\u002Fcalendar\u002Fblob\u002Fmain\u002Fdocs\u002FMigrationGuide.md).\n\n## Share your creations\n\nMade a cool calendar with this library? Share an image [here](https:\u002F\u002Fgithub.com\u002Fkizitonwose\u002FCalendar\u002Fissues\u002F1).\n\n## Contributing\n\nFound a bug? feel free to fix it and send a pull request or [open an issue](https:\u002F\u002Fgithub.com\u002Fkizitonwose\u002FCalendar\u002Fissues).\n\n## License\n\nCalendar library is distributed under the MIT license.\nSee [LICENSE](https:\u002F\u002Fgithub.com\u002Fkizitonwose\u002FCalendar\u002Fblob\u002Fmain\u002FLICENSE.md) for details.\n","kizitonwose\u002FCalendar 是一个适用于 Android 和 Kotlin 多平台的高度可定制日历视图和组合库。它支持周、月、年三种显示模式，以及单个、多个或范围日期选择，并允许开发者自定义禁用特定日期、边界日期及日历外观等。此外，该库还提供了热力图日历功能，适合展示随时间变化的数据趋势。基于 RecyclerView 和 LazyRow\u002FLazyColumn 构建，使得滚动性能优异且易于扩展。无论是需要为移动应用添加美观的日历组件，还是希望在跨平台项目中统一日历体验，此库都是理想的选择。",2,"2026-06-11 03:11:24","top_language"]