# hvyas3662/easymonthpicker-android architecture

> Architecture diagram of the GitHub repository hvyas3662/easymonthpicker-android, 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/hvyas3662/easymonthpicker-android
- Repository: https://github.com/hvyas3662/easymonthpicker-android

## Overview

EasyMonthPicker is an Android library for choosing one or more months and returning month details, including the number of days in the month. Its central workflow is configuring and showing a dialog, selecting months, and delivering results or dismissal callbacks. The sample app demonstrates the single-selection API. The excerpts show the picker-to-adapter and callback behavior; other documented capabilities such as customization and locale configuration are represented within the picker and adapter nodes.

Main entry points: [`easymonthpicker/src/main/java/com/elevationsoft/easymonthpicker/EasyMonthPicker.java`](https://github.com/hvyas3662/easymonthpicker-android/blob/master/easymonthpicker/src/main/java/com/elevationsoft/easymonthpicker/EasyMonthPicker.java) (Picker dialog API), [`easymonthpicker/src/main/java/com/elevationsoft/easymonthpicker/MonthAdapter.java`](https://github.com/hvyas3662/easymonthpicker-android/blob/master/easymonthpicker/src/main/java/com/elevationsoft/easymonthpicker/MonthAdapter.java) (Month grid), [`app/src/main/java/com/elevationsoft/sample_month_picker/MainActivity.java`](https://github.com/hvyas3662/easymonthpicker-android/blob/master/app/src/main/java/com/elevationsoft/sample_month_picker/MainActivity.java) (Demo activity), [`easymonthpicker/src/main/java/com/elevationsoft/easymonthpicker/model/MonthPickerResult.java`](https://github.com/hvyas3662/easymonthpicker-android/blob/master/easymonthpicker/src/main/java/com/elevationsoft/easymonthpicker/model/MonthPickerResult.java) (Month result)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_picker["Picker UI"]
  node_picker_api["Picker dialog API"]
end

subgraph group_selection["Selection results"]
  node_month_adapter["Month grid<br/>[MonthAdapter.java]"]
  node_result["Month result"]
  node_single_listener["Single-select listener"]
  node_multi_listener["Multi-select listener"]
  node_dismiss_listener["Dismiss listener"]
end

subgraph group_sample["Sample app"]
  node_demo["Demo activity<br/>[MainActivity.java]"]
end

node_host(("Host app"))

node_host -->|"runs sample"| node_demo
node_demo -->|"configures and shows"| node_picker_api
node_picker_api -->|"creates grid"| node_month_adapter
node_month_adapter -->|"builds results"| node_result
node_picker_api -->|"dispatches callbacks"| node_single_listener
node_picker_api -->|"dispatches callbacks"| node_multi_listener
node_picker_api -->|"dispatches dismissal"| node_dismiss_listener

click node_demo "https://github.com/hvyas3662/easymonthpicker-android/blob/master/app/src/main/java/com/elevationsoft/sample_month_picker/MainActivity.java"
click node_picker_api "https://github.com/hvyas3662/easymonthpicker-android/blob/master/easymonthpicker/src/main/java/com/elevationsoft/easymonthpicker/EasyMonthPicker.java"
click node_month_adapter "https://github.com/hvyas3662/easymonthpicker-android/blob/master/easymonthpicker/src/main/java/com/elevationsoft/easymonthpicker/MonthAdapter.java"
click node_result "https://github.com/hvyas3662/easymonthpicker-android/blob/master/easymonthpicker/src/main/java/com/elevationsoft/easymonthpicker/model/MonthPickerResult.java"
click node_single_listener "https://github.com/hvyas3662/easymonthpicker-android/blob/master/easymonthpicker/src/main/java/com/elevationsoft/easymonthpicker/listener/OnMonthSelectListener.java"
click node_multi_listener "https://github.com/hvyas3662/easymonthpicker-android/blob/master/easymonthpicker/src/main/java/com/elevationsoft/easymonthpicker/listener/OnMonthMultiSelectListener.java"
click node_dismiss_listener "https://github.com/hvyas3662/easymonthpicker-android/blob/master/easymonthpicker/src/main/java/com/elevationsoft/easymonthpicker/listener/OnMonthPickerDismissListener.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_picker_api toneBlue
class node_month_adapter,node_result,node_single_listener,node_multi_listener,node_dismiss_listener toneAmber
class node_demo toneMint
class node_host toneIndigo
```

## Components

### Picker UI

- [Picker dialog API](https://github.com/hvyas3662/easymonthpicker-android/blob/master/easymonthpicker/src/main/java/com/elevationsoft/easymonthpicker/EasyMonthPicker.java): `easymonthpicker/src/main/java/com/elevationsoft/easymonthpicker/EasyMonthPicker.java`

### Selection results

- [Month grid](https://github.com/hvyas3662/easymonthpicker-android/blob/master/easymonthpicker/src/main/java/com/elevationsoft/easymonthpicker/MonthAdapter.java): `easymonthpicker/src/main/java/com/elevationsoft/easymonthpicker/MonthAdapter.java`
- [Month result](https://github.com/hvyas3662/easymonthpicker-android/blob/master/easymonthpicker/src/main/java/com/elevationsoft/easymonthpicker/model/MonthPickerResult.java): `easymonthpicker/src/main/java/com/elevationsoft/easymonthpicker/model/MonthPickerResult.java`
- [Single-select listener](https://github.com/hvyas3662/easymonthpicker-android/blob/master/easymonthpicker/src/main/java/com/elevationsoft/easymonthpicker/listener/OnMonthSelectListener.java): `easymonthpicker/src/main/java/com/elevationsoft/easymonthpicker/listener/OnMonthSelectListener.java`
- [Multi-select listener](https://github.com/hvyas3662/easymonthpicker-android/blob/master/easymonthpicker/src/main/java/com/elevationsoft/easymonthpicker/listener/OnMonthMultiSelectListener.java): `easymonthpicker/src/main/java/com/elevationsoft/easymonthpicker/listener/OnMonthMultiSelectListener.java`
- [Dismiss listener](https://github.com/hvyas3662/easymonthpicker-android/blob/master/easymonthpicker/src/main/java/com/elevationsoft/easymonthpicker/listener/OnMonthPickerDismissListener.java): `easymonthpicker/src/main/java/com/elevationsoft/easymonthpicker/listener/OnMonthPickerDismissListener.java`

### Sample app

- [Demo activity](https://github.com/hvyas3662/easymonthpicker-android/blob/master/app/src/main/java/com/elevationsoft/sample_month_picker/MainActivity.java): `app/src/main/java/com/elevationsoft/sample_month_picker/MainActivity.java`

### Other components

- **Host app**

## Connections

- Host app → Demo activity: runs sample (evidence: `README.md`)
- Demo activity → Picker dialog API: configures and shows (evidence: `app/src/main/java/com/elevationsoft/sample_month_picker/MainActivity.java`)
- Picker dialog API → Month grid: creates grid (evidence: `easymonthpicker/src/main/java/com/elevationsoft/easymonthpicker/EasyMonthPicker.java`)
- Month grid → Month result: builds results (evidence: `easymonthpicker/src/main/java/com/elevationsoft/easymonthpicker/MonthAdapter.java`)
- Picker dialog API → Single-select listener: dispatches callbacks (evidence: `easymonthpicker/src/main/java/com/elevationsoft/easymonthpicker/EasyMonthPicker.java`)
- Picker dialog API → Multi-select listener: dispatches callbacks (evidence: `easymonthpicker/src/main/java/com/elevationsoft/easymonthpicker/EasyMonthPicker.java`)
- Picker dialog API → Dismiss listener: dispatches dismissal (evidence: `easymonthpicker/src/main/java/com/elevationsoft/easymonthpicker/EasyMonthPicker.java`)
