# rey5137/material architecture

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

- Interactive diagram: https://gitdiagram.com/rey5137/material
- Repository: https://github.com/rey5137/material

## Overview

MaterialLibrary is an Android UI component library that back-ports Material Design widgets to older Android versions. Its principal workflow is an application choosing a widget, styling it through themes, then displaying it with interactive behavior such as ripple feedback, progress animation, or popup selection. The repository also contains app-level contact-entry and recurring-schedule components. The README documents the broad feature set; source-index references and excerpts establish only some implementation relationships, so unsampled links are omitted.

Main entry points: [`material/src/main/java/com/rey/material/widget/EditText.java`](https://github.com/rey5137/material/blob/master/material/src/main/java/com/rey/material/widget/EditText.java) (Text and input), [`material/src/main/java/com/rey/material/app/ThemeManager.java`](https://github.com/rey5137/material/blob/master/material/src/main/java/com/rey/material/app/ThemeManager.java) (Dynamic themes), [`app/src/main/java/com/rey/material/app/RecurringPickerDialog.java`](https://github.com/rey5137/material/blob/master/app/src/main/java/com/rey/material/app/RecurringPickerDialog.java) (Recurring picker), [`material/src/main/java/com/rey/material/widget/Spinner.java`](https://github.com/rey5137/material/blob/master/material/src/main/java/com/rey/material/widget/Spinner.java) (Popup selection)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_widgets["UI widgets"]
  node_text["Text and input<br/>[EditText.java]"]
  node_layout["Layout widgets<br/>[FrameLayout.java]"]
  node_selection["Popup selection<br/>[Spinner.java]"]
  node_popup["Popup windows"]
  node_list["List view<br/>[ListView.java]"]
  node_progress["Progress indicators<br/>[ProgressView.java]"]
  node_controls["Buttons and controls<br/>[Button.java]"]
  node_tabs["Tab indicators"]
  node_snackbar["Snack bar<br/>[SnackBar.java]"]
end

subgraph group_feedback["Drawables and feedback"]
  node_ripplemanager["Ripple dispatch<br/>[RippleManager.java]"]
  node_ripple["Ripple drawable"]
  node_progressdrawables["Progress drawables"]
  node_divider["Divider drawable"]
end

subgraph group_app["Dialogs and app components"]
  node_dialogs["Dialogs and sheets<br/>[Dialog.java]"]
  node_contact_entry["Contact entry"]
  node_contact_view["Contact suggestion view<br/>[ContactView.java]"]
  node_recipient["Recipient data<br/>[Recipient.java]"]
  node_recurring_dialog["Recurring picker"]
  node_recurring["Recurring schedule<br/>[Recurring.java]"]
  node_week["Week selector<br/>[WeekView.java]"]
  node_date_dialog["Date picker dialog"]
end

subgraph group_theming["Theme and utilities"]
  node_theme_manager["Dynamic themes<br/>[ThemeManager.java]"]
  node_theme_utils["Theme utilities<br/>[ThemeUtil.java]"]
  node_view_utils["View utilities<br/>[ViewUtil.java]"]
  node_theme_store[("Theme preferences")]
end

node_developer(("Application developer"))

node_developer -->|"uses"| node_text
node_developer -->|"uses"| node_progress
node_developer -->|"uses"| node_controls
node_developer -->|"uses"| node_selection
node_developer -->|"uses"| node_tabs
node_developer -->|"uses"| node_snackbar
node_developer -->|"uses"| node_dialogs
node_developer -->|"configures"| node_theme_manager
node_text -->|"reads styles"| node_theme_manager
node_text -->|"uses"| node_view_utils
node_text -->|"uses"| node_divider
node_text -.->|"dispatches touch"| node_ripplemanager
node_ripplemanager -->|"configures and handles"| node_ripple
node_layout -->|"registers listener"| node_theme_manager
node_layout -->|"applies style"| node_view_utils
node_layout -.->|"delegates touch"| node_ripplemanager
node_selection -->|"uses styles"| node_theme_manager
node_selection -->|"uses popup"| node_popup
node_selection -->|"uses list"| node_list
node_popup -->|"hosts list"| node_list
node_progress -->|"renders with"| node_progressdrawables
node_dialogs -->|"builds action feedback"| node_ripple
node_dialogs -->|"uses"| node_view_utils
node_theme_manager -->|"reads and writes"| node_theme_store
node_theme_manager -.->|"styles widgets"| node_theme_utils
node_contact_entry -->|"stores recipients"| node_recipient
node_contact_entry -->|"renders suggestions"| node_contact_view
node_contact_entry -->|"extends input"| node_text
node_contact_view -->|"sets up feedback"| node_ripplemanager
node_contact_view -->|"reads dimensions"| node_theme_utils
node_recurring_dialog -->|"edits schedule"| node_recurring
node_recurring_dialog -->|"uses selector"| node_week
node_recurring_dialog -->|"builds on"| node_dialogs
node_recurring_dialog -->|"uses picker"| node_date_dialog

click node_text "https://github.com/rey5137/material/blob/master/material/src/main/java/com/rey/material/widget/EditText.java"
click node_layout "https://github.com/rey5137/material/blob/master/material/src/main/java/com/rey/material/widget/FrameLayout.java"
click node_selection "https://github.com/rey5137/material/blob/master/material/src/main/java/com/rey/material/widget/Spinner.java"
click node_popup "https://github.com/rey5137/material/blob/master/material/src/main/java/com/rey/material/widget/ListPopupWindow.java"
click node_list "https://github.com/rey5137/material/blob/master/material/src/main/java/com/rey/material/widget/ListView.java"
click node_progress "https://github.com/rey5137/material/blob/master/material/src/main/java/com/rey/material/widget/ProgressView.java"
click node_controls "https://github.com/rey5137/material/blob/master/material/src/main/java/com/rey/material/widget/Button.java"
click node_tabs "https://github.com/rey5137/material/blob/master/material/src/main/java/com/rey/material/widget/TabPageIndicator.java"
click node_snackbar "https://github.com/rey5137/material/blob/master/material/src/main/java/com/rey/material/widget/SnackBar.java"
click node_ripplemanager "https://github.com/rey5137/material/blob/master/material/src/main/java/com/rey/material/widget/RippleManager.java"
click node_ripple "https://github.com/rey5137/material/blob/master/material/src/main/java/com/rey/material/drawable/RippleDrawable.java"
click node_progressdrawables "https://github.com/rey5137/material/blob/master/material/src/main/java/com/rey/material/drawable/CircularProgressDrawable.java"
click node_divider "https://github.com/rey5137/material/blob/master/material/src/main/java/com/rey/material/drawable/DividerDrawable.java"
click node_dialogs "https://github.com/rey5137/material/blob/master/material/src/main/java/com/rey/material/app/Dialog.java"
click node_theme_manager "https://github.com/rey5137/material/blob/master/material/src/main/java/com/rey/material/app/ThemeManager.java"
click node_theme_utils "https://github.com/rey5137/material/blob/master/material/src/main/java/com/rey/material/util/ThemeUtil.java"
click node_view_utils "https://github.com/rey5137/material/blob/master/material/src/main/java/com/rey/material/util/ViewUtil.java"
click node_contact_entry "https://github.com/rey5137/material/blob/master/app/src/main/java/com/rey/material/app/ContactEditText.java"
click node_contact_view "https://github.com/rey5137/material/blob/master/app/src/main/java/com/rey/material/app/ContactView.java"
click node_recipient "https://github.com/rey5137/material/blob/master/app/src/main/java/com/rey/material/app/Recipient.java"
click node_recurring_dialog "https://github.com/rey5137/material/blob/master/app/src/main/java/com/rey/material/app/RecurringPickerDialog.java"
click node_recurring "https://github.com/rey5137/material/blob/master/app/src/main/java/com/rey/material/app/Recurring.java"
click node_week "https://github.com/rey5137/material/blob/master/app/src/main/java/com/rey/material/app/WeekView.java"
click node_date_dialog "https://github.com/rey5137/material/blob/master/material/src/main/java/com/rey/material/app/DatePickerDialog.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_text,node_layout,node_selection,node_popup,node_list,node_progress,node_controls,node_tabs,node_snackbar toneBlue
class node_ripplemanager,node_ripple,node_progressdrawables,node_divider toneAmber
class node_dialogs,node_contact_entry,node_contact_view,node_recipient,node_recurring_dialog,node_recurring,node_week,node_date_dialog toneMint
class node_theme_manager,node_theme_utils,node_view_utils,node_theme_store toneRose
class node_developer toneIndigo
```

## Components

### UI widgets

- [Text and input](https://github.com/rey5137/material/blob/master/material/src/main/java/com/rey/material/widget/EditText.java): `material/src/main/java/com/rey/material/widget/EditText.java`
- [Layout widgets](https://github.com/rey5137/material/blob/master/material/src/main/java/com/rey/material/widget/FrameLayout.java): `material/src/main/java/com/rey/material/widget/FrameLayout.java`
- [Popup selection](https://github.com/rey5137/material/blob/master/material/src/main/java/com/rey/material/widget/Spinner.java): `material/src/main/java/com/rey/material/widget/Spinner.java`
- [Popup windows](https://github.com/rey5137/material/blob/master/material/src/main/java/com/rey/material/widget/ListPopupWindow.java): `material/src/main/java/com/rey/material/widget/ListPopupWindow.java`
- [List view](https://github.com/rey5137/material/blob/master/material/src/main/java/com/rey/material/widget/ListView.java): `material/src/main/java/com/rey/material/widget/ListView.java`
- [Progress indicators](https://github.com/rey5137/material/blob/master/material/src/main/java/com/rey/material/widget/ProgressView.java): `material/src/main/java/com/rey/material/widget/ProgressView.java`
- [Buttons and controls](https://github.com/rey5137/material/blob/master/material/src/main/java/com/rey/material/widget/Button.java): `material/src/main/java/com/rey/material/widget/Button.java`
- [Tab indicators](https://github.com/rey5137/material/blob/master/material/src/main/java/com/rey/material/widget/TabPageIndicator.java): `material/src/main/java/com/rey/material/widget/TabPageIndicator.java`
- [Snack bar](https://github.com/rey5137/material/blob/master/material/src/main/java/com/rey/material/widget/SnackBar.java): `material/src/main/java/com/rey/material/widget/SnackBar.java`

### Drawables and feedback

- [Ripple dispatch](https://github.com/rey5137/material/blob/master/material/src/main/java/com/rey/material/widget/RippleManager.java): `material/src/main/java/com/rey/material/widget/RippleManager.java`
- [Ripple drawable](https://github.com/rey5137/material/blob/master/material/src/main/java/com/rey/material/drawable/RippleDrawable.java): `material/src/main/java/com/rey/material/drawable/RippleDrawable.java`
- [Progress drawables](https://github.com/rey5137/material/blob/master/material/src/main/java/com/rey/material/drawable/CircularProgressDrawable.java): `material/src/main/java/com/rey/material/drawable/CircularProgressDrawable.java`
- [Divider drawable](https://github.com/rey5137/material/blob/master/material/src/main/java/com/rey/material/drawable/DividerDrawable.java): `material/src/main/java/com/rey/material/drawable/DividerDrawable.java`

### Dialogs and app components

- [Dialogs and sheets](https://github.com/rey5137/material/blob/master/material/src/main/java/com/rey/material/app/Dialog.java): `material/src/main/java/com/rey/material/app/Dialog.java`
- [Contact entry](https://github.com/rey5137/material/blob/master/app/src/main/java/com/rey/material/app/ContactEditText.java): `app/src/main/java/com/rey/material/app/ContactEditText.java`
- [Contact suggestion view](https://github.com/rey5137/material/blob/master/app/src/main/java/com/rey/material/app/ContactView.java): `app/src/main/java/com/rey/material/app/ContactView.java`
- [Recipient data](https://github.com/rey5137/material/blob/master/app/src/main/java/com/rey/material/app/Recipient.java): `app/src/main/java/com/rey/material/app/Recipient.java`
- [Recurring picker](https://github.com/rey5137/material/blob/master/app/src/main/java/com/rey/material/app/RecurringPickerDialog.java): `app/src/main/java/com/rey/material/app/RecurringPickerDialog.java`
- [Recurring schedule](https://github.com/rey5137/material/blob/master/app/src/main/java/com/rey/material/app/Recurring.java): `app/src/main/java/com/rey/material/app/Recurring.java`
- [Week selector](https://github.com/rey5137/material/blob/master/app/src/main/java/com/rey/material/app/WeekView.java): `app/src/main/java/com/rey/material/app/WeekView.java`
- [Date picker dialog](https://github.com/rey5137/material/blob/master/material/src/main/java/com/rey/material/app/DatePickerDialog.java): `material/src/main/java/com/rey/material/app/DatePickerDialog.java`

### Theme and utilities

- [Dynamic themes](https://github.com/rey5137/material/blob/master/material/src/main/java/com/rey/material/app/ThemeManager.java): `material/src/main/java/com/rey/material/app/ThemeManager.java`
- [Theme utilities](https://github.com/rey5137/material/blob/master/material/src/main/java/com/rey/material/util/ThemeUtil.java): `material/src/main/java/com/rey/material/util/ThemeUtil.java`
- [View utilities](https://github.com/rey5137/material/blob/master/material/src/main/java/com/rey/material/util/ViewUtil.java): `material/src/main/java/com/rey/material/util/ViewUtil.java`
- **Theme preferences**

### Other components

- **Application developer**

## Connections

- Application developer → Text and input: uses
- Application developer → Progress indicators: uses
- Application developer → Buttons and controls: uses
- Application developer → Popup selection: uses
- Application developer → Tab indicators: uses
- Application developer → Snack bar: uses
- Application developer → Dialogs and sheets: uses
- Application developer → Dynamic themes: configures
- Text and input → Dynamic themes: reads styles (evidence: `material/src/main/java/com/rey/material/widget/EditText.java`)
- Text and input → View utilities: uses (evidence: `material/src/main/java/com/rey/material/widget/EditText.java`)
- Text and input → Divider drawable: uses (evidence: `material/src/main/java/com/rey/material/widget/EditText.java`)
- Text and input → Ripple dispatch: dispatches touch
- Ripple dispatch → Ripple drawable: configures and handles (evidence: `material/src/main/java/com/rey/material/widget/RippleManager.java`)
- Layout widgets → Dynamic themes: registers listener (evidence: `material/src/main/java/com/rey/material/widget/FrameLayout.java`)
- Layout widgets → View utilities: applies style (evidence: `material/src/main/java/com/rey/material/widget/FrameLayout.java`)
- Layout widgets → Ripple dispatch: delegates touch (evidence: `material/src/main/java/com/rey/material/widget/FrameLayout.java`)
- Popup selection → Dynamic themes: uses styles (evidence: `material/src/main/java/com/rey/material/widget/Spinner.java`)
- Popup selection → Popup windows: uses popup (evidence: `material/src/main/java/com/rey/material/widget/Spinner.java`)
- Popup selection → List view: uses list (evidence: `material/src/main/java/com/rey/material/widget/Spinner.java`)
- Popup windows → List view: hosts list (evidence: `material/src/main/java/com/rey/material/widget/ListPopupWindow.java`)
- Progress indicators → Progress drawables: renders with (evidence: `material/src/main/java/com/rey/material/drawable/CircularProgressDrawable.java`)
- Dialogs and sheets → Ripple drawable: builds action feedback (evidence: `material/src/main/java/com/rey/material/app/Dialog.java`)
- Dialogs and sheets → View utilities: uses (evidence: `material/src/main/java/com/rey/material/app/Dialog.java`)
- Dynamic themes → Theme preferences: reads and writes (evidence: `material/src/main/java/com/rey/material/app/ThemeManager.java`)
- Dynamic themes → Theme utilities: styles widgets
- Contact entry → Recipient data: stores recipients (evidence: `app/src/main/java/com/rey/material/app/ContactEditText.java`)
- Contact entry → Contact suggestion view: renders suggestions (evidence: `app/src/main/java/com/rey/material/app/ContactEditText.java`)
- Contact entry → Text and input: extends input (evidence: `app/src/main/java/com/rey/material/app/ContactEditText.java`)
- Contact suggestion view → Ripple dispatch: sets up feedback (evidence: `app/src/main/java/com/rey/material/app/ContactView.java`)
- Contact suggestion view → Theme utilities: reads dimensions (evidence: `app/src/main/java/com/rey/material/app/ContactView.java`)
- Recurring picker → Recurring schedule: edits schedule (evidence: `app/src/main/java/com/rey/material/app/RecurringPickerDialog.java`)
- Recurring picker → Week selector: uses selector (evidence: `app/src/main/java/com/rey/material/app/RecurringPickerDialog.java`)
- Recurring picker → Dialogs and sheets: builds on (evidence: `app/src/main/java/com/rey/material/app/RecurringPickerDialog.java`)
- Recurring picker → Date picker dialog: uses picker (evidence: `app/src/main/java/com/rey/material/app/RecurringPickerDialog.java`)
