# huanghaibin-dev/calendarview architecture

> Architecture diagram of the GitHub repository huanghaibin-dev/calendarview, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-02). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/huanghaibin-dev/calendarview
- Repository: https://github.com/huanghaibin-dev/calendarview

## Overview

CalendarView is an Android calendar UI library with a demo app. Users open the demo, choose a calendar example, navigate/select dates, and see customized month/week/year views and associated content. The library centers on CalendarView coordinating paging, calendar layout, selection state, and date conversion. The README also highlights range selection, multi-date selection, year views, and extensive visual customization. Several implementation files are unsampled, so relationships beyond explicit call evidence or README capability statements are omitted.

Main entry points: [`calendarview/src/main/java/com/haibin/calendarview/CalendarView.java`](https://github.com/huanghaibin-dev/calendarview/blob/master/calendarview/src/main/java/com/haibin/calendarview/CalendarView.java) (CalendarView API), [`calendarview/src/main/java/com/haibin/calendarview/CalendarViewDelegate.java`](https://github.com/huanghaibin-dev/calendarview/blob/master/calendarview/src/main/java/com/haibin/calendarview/CalendarViewDelegate.java) (Calendar state), [`app/src/main/java/com/haibin/calendarviewproject/ArticleAdapter.java`](https://github.com/huanghaibin-dev/calendarview/blob/master/app/src/main/java/com/haibin/calendarviewproject/ArticleAdapter.java) (Article adapter), [`app/src/main/java/com/haibin/calendarviewproject`](https://github.com/huanghaibin-dev/calendarview/tree/master/app/src/main/java/com/haibin/calendarviewproject) (Calendar examples)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_demo["Demo experiences"]
  node_main["Demo launcher<br/>[MainActivity.java]"]
  node_examples["Calendar examples"]
  node_simple["Simple calendar"]
  node_index["Indexed calendar<br/>[IndexActivity.java]"]
  node_custom["Custom styles"]
  node_color["Color themes"]
  node_meizu["Meizu style<br/>[MeiZuActivity.java]"]
  node_range["Range selection<br/>[RangeActivity.java]"]
  node_multi["Multi-date<br/>[MultiActivity.java]"]
  node_pager["Pager demo"]
end

subgraph group_ui["Calendar UI"]
  node_calendarview["CalendarView API<br/>[CalendarView.java]"]
  node_layout["Expand layout"]
  node_delegate["Calendar state"]
  node_monthpager["Month paging"]
  node_weekpager["Week paging<br/>[WeekViewPager.java]"]
  node_yearview["Year browsing"]
  node_views["Calendar renderers<br/>[BaseMonthView.java]"]
  node_weekbar["Week header<br/>[WeekBar.java]"]
end

subgraph group_date["Date model"]
  node_calendar["Date object<br/>[Calendar.java]"]
  node_util["Date calculations<br/>[CalendarUtil.java]"]
  node_lunar["Lunar conversion<br/>[LunarCalendar.java]"]
  node_terms["Solar terms<br/>[SolarTermUtil.java]"]
end

subgraph group_lists["Demo content"]
  node_articles["Article data<br/>[Article.java]"]
  node_articleadapter["Article adapter"]
  node_groupview["Grouped list"]
  node_decoration["Group headers"]
end

node_user(("Calendar user"))

node_user -->|"opens demo"| node_main
node_main -->|"launches examples"| node_examples
node_examples -.->|"opens example"| node_simple
node_examples -.->|"opens example"| node_index
node_simple -->|"configures calendar"| node_calendarview
node_index -->|"configures calendar"| node_calendarview
node_color -.->|"configures calendar"| node_calendarview
node_meizu -.->|"configures calendar"| node_calendarview
node_range -.->|"uses selection"| node_calendarview
node_multi -.->|"uses selection"| node_calendarview
node_pager -->|"embeds calendar"| node_calendarview
node_custom -.->|"customizes views"| node_calendarview
node_calendarview -->|"maintains state"| node_delegate
node_calendarview -->|"coordinates paging"| node_monthpager
node_calendarview -->|"coordinates paging"| node_weekpager
node_calendarview -->|"coordinates browsing"| node_yearview
node_calendarview -->|"configures header"| node_weekbar
node_calendarview -->|"sets up layout"| node_layout
node_layout -->|"reads state"| node_delegate
node_delegate -->|"stores dates"| node_calendar
node_delegate -->|"adds lunar data"| node_lunar
node_util -->|"creates dates"| node_calendar
node_calendarview -->|"computes navigation"| node_util
node_articles -->|"supplies records"| node_articleadapter
node_index -->|"attaches list"| node_articleadapter
node_color -.->|"attaches list"| node_articleadapter
node_articleadapter -->|"uses grouped adapter"| node_groupview
node_groupview -->|"installs decoration"| node_decoration

click node_main "https://github.com/huanghaibin-dev/calendarview/blob/master/app/src/main/java/com/haibin/calendarviewproject/MainActivity.java"
click node_examples "https://github.com/huanghaibin-dev/calendarview/tree/master/app/src/main/java/com/haibin/calendarviewproject"
click node_simple "https://github.com/huanghaibin-dev/calendarview/blob/master/app/src/main/java/com/haibin/calendarviewproject/simple/SimpleActivity.java"
click node_index "https://github.com/huanghaibin-dev/calendarview/blob/master/app/src/main/java/com/haibin/calendarviewproject/index/IndexActivity.java"
click node_custom "https://github.com/huanghaibin-dev/calendarview/tree/master/app/src/main/java/com/haibin/calendarviewproject/custom"
click node_color "https://github.com/huanghaibin-dev/calendarview/blob/master/app/src/main/java/com/haibin/calendarviewproject/colorful/ColorfulActivity.java"
click node_meizu "https://github.com/huanghaibin-dev/calendarview/blob/master/app/src/main/java/com/haibin/calendarviewproject/meizu/MeiZuActivity.java"
click node_range "https://github.com/huanghaibin-dev/calendarview/blob/master/app/src/main/java/com/haibin/calendarviewproject/range/RangeActivity.java"
click node_multi "https://github.com/huanghaibin-dev/calendarview/blob/master/app/src/main/java/com/haibin/calendarviewproject/multi/MultiActivity.java"
click node_pager "https://github.com/huanghaibin-dev/calendarview/blob/master/app/src/main/java/com/haibin/calendarviewproject/pager/ViewPagerActivity.java"
click node_calendarview "https://github.com/huanghaibin-dev/calendarview/blob/master/calendarview/src/main/java/com/haibin/calendarview/CalendarView.java"
click node_layout "https://github.com/huanghaibin-dev/calendarview/blob/master/calendarview/src/main/java/com/haibin/calendarview/CalendarLayout.java"
click node_delegate "https://github.com/huanghaibin-dev/calendarview/blob/master/calendarview/src/main/java/com/haibin/calendarview/CalendarViewDelegate.java"
click node_monthpager "https://github.com/huanghaibin-dev/calendarview/blob/master/calendarview/src/main/java/com/haibin/calendarview/MonthViewPager.java"
click node_weekpager "https://github.com/huanghaibin-dev/calendarview/blob/master/calendarview/src/main/java/com/haibin/calendarview/WeekViewPager.java"
click node_yearview "https://github.com/huanghaibin-dev/calendarview/blob/master/calendarview/src/main/java/com/haibin/calendarview/YearRecyclerView.java"
click node_views "https://github.com/huanghaibin-dev/calendarview/blob/master/calendarview/src/main/java/com/haibin/calendarview/BaseMonthView.java"
click node_weekbar "https://github.com/huanghaibin-dev/calendarview/blob/master/calendarview/src/main/java/com/haibin/calendarview/WeekBar.java"
click node_calendar "https://github.com/huanghaibin-dev/calendarview/blob/master/calendarview/src/main/java/com/haibin/calendarview/Calendar.java"
click node_util "https://github.com/huanghaibin-dev/calendarview/blob/master/calendarview/src/main/java/com/haibin/calendarview/CalendarUtil.java"
click node_lunar "https://github.com/huanghaibin-dev/calendarview/blob/master/calendarview/src/main/java/com/haibin/calendarview/LunarCalendar.java"
click node_terms "https://github.com/huanghaibin-dev/calendarview/blob/master/calendarview/src/main/java/com/haibin/calendarview/SolarTermUtil.java"
click node_articles "https://github.com/huanghaibin-dev/calendarview/blob/master/app/src/main/java/com/haibin/calendarviewproject/Article.java"
click node_articleadapter "https://github.com/huanghaibin-dev/calendarview/blob/master/app/src/main/java/com/haibin/calendarviewproject/ArticleAdapter.java"
click node_groupview "https://github.com/huanghaibin-dev/calendarview/blob/master/app/src/main/java/com/haibin/calendarviewproject/group/GroupRecyclerView.java"
click node_decoration "https://github.com/huanghaibin-dev/calendarview/blob/master/app/src/main/java/com/haibin/calendarviewproject/group/GroupItemDecoration.java"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_main,node_examples,node_simple,node_index,node_custom,node_color,node_meizu,node_range,node_multi,node_pager,node_user toneBlue
class node_calendarview,node_layout,node_delegate,node_monthpager,node_weekpager,node_yearview,node_views,node_weekbar toneAmber
class node_calendar,node_util,node_lunar,node_terms toneMint
class node_articles,node_articleadapter,node_groupview,node_decoration toneRose
```

## Components

### Demo experiences

- [Demo launcher](https://github.com/huanghaibin-dev/calendarview/blob/master/app/src/main/java/com/haibin/calendarviewproject/MainActivity.java): `app/src/main/java/com/haibin/calendarviewproject/MainActivity.java`
- [Calendar examples](https://github.com/huanghaibin-dev/calendarview/tree/master/app/src/main/java/com/haibin/calendarviewproject): `app/src/main/java/com/haibin/calendarviewproject`
- [Simple calendar](https://github.com/huanghaibin-dev/calendarview/blob/master/app/src/main/java/com/haibin/calendarviewproject/simple/SimpleActivity.java): `app/src/main/java/com/haibin/calendarviewproject/simple/SimpleActivity.java`
- [Indexed calendar](https://github.com/huanghaibin-dev/calendarview/blob/master/app/src/main/java/com/haibin/calendarviewproject/index/IndexActivity.java): `app/src/main/java/com/haibin/calendarviewproject/index/IndexActivity.java`
- [Custom styles](https://github.com/huanghaibin-dev/calendarview/tree/master/app/src/main/java/com/haibin/calendarviewproject/custom): `app/src/main/java/com/haibin/calendarviewproject/custom`
- [Color themes](https://github.com/huanghaibin-dev/calendarview/blob/master/app/src/main/java/com/haibin/calendarviewproject/colorful/ColorfulActivity.java): `app/src/main/java/com/haibin/calendarviewproject/colorful/ColorfulActivity.java`
- [Meizu style](https://github.com/huanghaibin-dev/calendarview/blob/master/app/src/main/java/com/haibin/calendarviewproject/meizu/MeiZuActivity.java): `app/src/main/java/com/haibin/calendarviewproject/meizu/MeiZuActivity.java`
- [Range selection](https://github.com/huanghaibin-dev/calendarview/blob/master/app/src/main/java/com/haibin/calendarviewproject/range/RangeActivity.java): `app/src/main/java/com/haibin/calendarviewproject/range/RangeActivity.java`
- [Multi-date](https://github.com/huanghaibin-dev/calendarview/blob/master/app/src/main/java/com/haibin/calendarviewproject/multi/MultiActivity.java): `app/src/main/java/com/haibin/calendarviewproject/multi/MultiActivity.java`
- [Pager demo](https://github.com/huanghaibin-dev/calendarview/blob/master/app/src/main/java/com/haibin/calendarviewproject/pager/ViewPagerActivity.java): `app/src/main/java/com/haibin/calendarviewproject/pager/ViewPagerActivity.java`

### Calendar UI

- [CalendarView API](https://github.com/huanghaibin-dev/calendarview/blob/master/calendarview/src/main/java/com/haibin/calendarview/CalendarView.java): `calendarview/src/main/java/com/haibin/calendarview/CalendarView.java`
- [Expand layout](https://github.com/huanghaibin-dev/calendarview/blob/master/calendarview/src/main/java/com/haibin/calendarview/CalendarLayout.java): `calendarview/src/main/java/com/haibin/calendarview/CalendarLayout.java`
- [Calendar state](https://github.com/huanghaibin-dev/calendarview/blob/master/calendarview/src/main/java/com/haibin/calendarview/CalendarViewDelegate.java): `calendarview/src/main/java/com/haibin/calendarview/CalendarViewDelegate.java`
- [Month paging](https://github.com/huanghaibin-dev/calendarview/blob/master/calendarview/src/main/java/com/haibin/calendarview/MonthViewPager.java): `calendarview/src/main/java/com/haibin/calendarview/MonthViewPager.java`
- [Week paging](https://github.com/huanghaibin-dev/calendarview/blob/master/calendarview/src/main/java/com/haibin/calendarview/WeekViewPager.java): `calendarview/src/main/java/com/haibin/calendarview/WeekViewPager.java`
- [Year browsing](https://github.com/huanghaibin-dev/calendarview/blob/master/calendarview/src/main/java/com/haibin/calendarview/YearRecyclerView.java): `calendarview/src/main/java/com/haibin/calendarview/YearRecyclerView.java`
- [Calendar renderers](https://github.com/huanghaibin-dev/calendarview/blob/master/calendarview/src/main/java/com/haibin/calendarview/BaseMonthView.java): `calendarview/src/main/java/com/haibin/calendarview/BaseMonthView.java`
- [Week header](https://github.com/huanghaibin-dev/calendarview/blob/master/calendarview/src/main/java/com/haibin/calendarview/WeekBar.java): `calendarview/src/main/java/com/haibin/calendarview/WeekBar.java`

### Date model

- [Date object](https://github.com/huanghaibin-dev/calendarview/blob/master/calendarview/src/main/java/com/haibin/calendarview/Calendar.java): `calendarview/src/main/java/com/haibin/calendarview/Calendar.java`
- [Date calculations](https://github.com/huanghaibin-dev/calendarview/blob/master/calendarview/src/main/java/com/haibin/calendarview/CalendarUtil.java): `calendarview/src/main/java/com/haibin/calendarview/CalendarUtil.java`
- [Lunar conversion](https://github.com/huanghaibin-dev/calendarview/blob/master/calendarview/src/main/java/com/haibin/calendarview/LunarCalendar.java): `calendarview/src/main/java/com/haibin/calendarview/LunarCalendar.java`
- [Solar terms](https://github.com/huanghaibin-dev/calendarview/blob/master/calendarview/src/main/java/com/haibin/calendarview/SolarTermUtil.java): `calendarview/src/main/java/com/haibin/calendarview/SolarTermUtil.java`

### Demo content

- [Article data](https://github.com/huanghaibin-dev/calendarview/blob/master/app/src/main/java/com/haibin/calendarviewproject/Article.java): `app/src/main/java/com/haibin/calendarviewproject/Article.java`
- [Article adapter](https://github.com/huanghaibin-dev/calendarview/blob/master/app/src/main/java/com/haibin/calendarviewproject/ArticleAdapter.java): `app/src/main/java/com/haibin/calendarviewproject/ArticleAdapter.java`
- [Grouped list](https://github.com/huanghaibin-dev/calendarview/blob/master/app/src/main/java/com/haibin/calendarviewproject/group/GroupRecyclerView.java): `app/src/main/java/com/haibin/calendarviewproject/group/GroupRecyclerView.java`
- [Group headers](https://github.com/huanghaibin-dev/calendarview/blob/master/app/src/main/java/com/haibin/calendarviewproject/group/GroupItemDecoration.java): `app/src/main/java/com/haibin/calendarviewproject/group/GroupItemDecoration.java`

### Other components

- **Calendar user**

## Connections

- Calendar user → Demo launcher: opens demo (evidence: `README.md`)
- Demo launcher → Calendar examples: launches examples (evidence: `app/src/main/java/com/haibin/calendarviewproject/MainActivity.java`)
- Calendar examples → Simple calendar: opens example (evidence: `app/src/main/java/com/haibin/calendarviewproject/MainActivity.java`)
- Calendar examples → Indexed calendar: opens example (evidence: `app/src/main/java/com/haibin/calendarviewproject/MainActivity.java`)
- Simple calendar → CalendarView API: configures calendar (evidence: `app/src/main/java/com/haibin/calendarviewproject/simple/SimpleActivity.java`)
- Indexed calendar → CalendarView API: configures calendar (evidence: `app/src/main/java/com/haibin/calendarviewproject/index/IndexActivity.java`)
- Color themes → CalendarView API: configures calendar (evidence: `app/src/main/java/com/haibin/calendarviewproject/colorful/ColorfulActivity.java`)
- Meizu style → CalendarView API: configures calendar (evidence: `app/src/main/java/com/haibin/calendarviewproject/meizu/MeiZuActivity.java`)
- Range selection → CalendarView API: uses selection (evidence: `app/src/main/java/com/haibin/calendarviewproject/range/RangeActivity.java`)
- Multi-date → CalendarView API: uses selection (evidence: `app/src/main/java/com/haibin/calendarviewproject/multi/MultiActivity.java`)
- Pager demo → CalendarView API: embeds calendar (evidence: `app/src/main/java/com/haibin/calendarviewproject/pager/ViewPagerActivity.java`)
- Custom styles → CalendarView API: customizes views (evidence: `app/src/main/java/com/haibin/calendarviewproject/custom/CustomActivity.java`)
- CalendarView API → Calendar state: maintains state (evidence: `calendarview/src/main/java/com/haibin/calendarview/CalendarView.java`)
- CalendarView API → Month paging: coordinates paging (evidence: `calendarview/src/main/java/com/haibin/calendarview/CalendarView.java`)
- CalendarView API → Week paging: coordinates paging (evidence: `calendarview/src/main/java/com/haibin/calendarview/CalendarView.java`)
- CalendarView API → Year browsing: coordinates browsing (evidence: `calendarview/src/main/java/com/haibin/calendarview/CalendarView.java`)
- CalendarView API → Week header: configures header (evidence: `calendarview/src/main/java/com/haibin/calendarview/CalendarView.java`)
- CalendarView API → Expand layout: sets up layout (evidence: `calendarview/src/main/java/com/haibin/calendarview/CalendarView.java`)
- Expand layout → Calendar state: reads state (evidence: `calendarview/src/main/java/com/haibin/calendarview/CalendarLayout.java`)
- Calendar state → Date object: stores dates (evidence: `calendarview/src/main/java/com/haibin/calendarview/CalendarViewDelegate.java`)
- Calendar state → Lunar conversion: adds lunar data (evidence: `calendarview/src/main/java/com/haibin/calendarview/CalendarViewDelegate.java`)
- Date calculations → Date object: creates dates (evidence: `calendarview/src/main/java/com/haibin/calendarview/CalendarUtil.java`)
- CalendarView API → Date calculations: computes navigation (evidence: `calendarview/src/main/java/com/haibin/calendarview/CalendarView.java`)
- Article data → Article adapter: supplies records (evidence: `app/src/main/java/com/haibin/calendarviewproject/ArticleAdapter.java`)
- Indexed calendar → Article adapter: attaches list (evidence: `app/src/main/java/com/haibin/calendarviewproject/index/IndexActivity.java`)
- Color themes → Article adapter: attaches list (evidence: `app/src/main/java/com/haibin/calendarviewproject/colorful/ColorfulActivity.java`)
- Article adapter → Grouped list: uses grouped adapter (evidence: `app/src/main/java/com/haibin/calendarviewproject/ArticleAdapter.java`)
- Grouped list → Group headers: installs decoration (evidence: `app/src/main/java/com/haibin/calendarviewproject/group/GroupRecyclerView.java`)
