prolificinteractive/material-calendarview

Material Calendar View is an Android library that adds a calendar widget to your app, styled to match Google's Material Design guidelines. Android includes a built-in CalendarView, but its appearance does not follow Material Design closely. This library was built to fill that gap, offering a cleaner look while giving developers more control over how the calendar behaves. To add it to an Android project, you include it as a dependency from the JitPack repository and drop the MaterialCalendarView component into any layout file. From there, you can listen for date selections in code or read the currently selected dates whenever you need them. The library offers a wide range of customization options. You can control whether users pick a single date, multiple dates, or a continuous date range. You can restrict which dates are selectable by setting minimum and maximum boundaries. The first day of the week can be changed, the header and weekday labels can be replaced with custom text, and dates from adjacent months can be shown or hidden. A decorator system lets you add colored dots, highlights, or custom background shapes to individual days, which is useful for marking events or availability. Version 2.0 made a significant internal change: the library switched from Java's older Calendar class to the newer LocalDate class for representing dates. Months are now numbered 1 through 12 instead of 0 through 11. Version 1.4 reorganized how certain settings (like date range limits and week start) are applied, grouping them into a state object so they take effect all at once rather than triggering repeated recalculations. The project is maintained by Prolific Interactive, a software agency. The library is open source and available under a permissive license.