# hsakhiya/remindme architecture

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

- Interactive diagram: https://gitdiagram.com/hsakhiya/remindme
- Repository: https://github.com/hsakhiya/remindme

## Overview

RemindMe is an Android reminder app: users create or edit scheduled reminders, then view, filter, complete, snooze, or delete them; the app persists reminder state and schedules alerts. Recurrence and quiet-hour calculations support notification scheduling, while a home-screen widget offers a compact view and completion action. The graph includes the documented filtering, categories, settings, and quick-add capabilities. Evidence comes from the README and shown excerpts/SOURCE INDEX; unsampled UI and integrations are represented only where documented or referenced.

Main entry points: [`App.tsx`](https://github.com/hsakhiya/remindme/blob/main/App.tsx) (App coordinator), [`src/services/storageService.ts`](https://github.com/hsakhiya/remindme/blob/main/src/services/storageService.ts) (Reminder persistence), [`src/widgets/widgetTaskHandler.tsx`](https://github.com/hsakhiya/remindme/blob/main/src/widgets/widgetTaskHandler.tsx) (Widget task handler), [`src/services/notificationService.ts`](https://github.com/hsakhiya/remindme/blob/main/src/services/notificationService.ts) (Notification scheduling)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["App workflow"]
  node_app["App coordinator<br/>[App.tsx]"]
  node_create_edit["Create and edit"]
  node_filters["Search and filters<br/>[FilterBar.tsx]"]
  node_header["Summary and test alert<br/>[Header.tsx]"]
  node_reminder_card["Reminder actions<br/>[ReminderCard.tsx]"]
  node_settings["App settings<br/>[SettingsModal.tsx]"]
  node_empty_state["Empty results<br/>[EmptyState.tsx]"]
end

subgraph group_reminders["Reminder domain"]
  node_reminder_model["Reminder model<br/>[reminder.ts]"]
  node_interval_rules["Recurrence and quiet hours<br/>[intervalUtils.ts]"]
  node_date_helpers["Date formatting<br/>[dateUtils.ts]"]
end

subgraph group_delivery["Alerts and persistence"]
  node_storage["Reminder persistence<br/>[storageService.ts]"]
  node_local_store[("AsyncStorage")]
  node_notifications["Notification scheduling"]
  node_native_scheduler["Native alarm scheduler"]
  node_android_alarms["Android alarm services"]
end

subgraph group_widget["Home-screen widget"]
  node_widget_sync["Widget synchronization"]
  node_widget_task["Widget task handler"]
  node_widget_view["Reminder widget"]
end

subgraph group_presentation["Presentation support"]
  node_theme_context["Theme preferences<br/>[ThemeContext.tsx]"]
  node_theme["Theme and category styles<br/>[theme.ts]"]
end

node_user(("Reminder user"))
node_home_screen(("Android home screen"))

node_user -->|"uses"| node_app
node_app -->|"opens"| node_create_edit
node_app -->|"renders"| node_filters
node_app -->|"renders"| node_header
node_app -->|"renders"| node_reminder_card
node_app -->|"renders"| node_settings
node_app -->|"renders"| node_empty_state
node_app -->|"loads and updates"| node_storage
node_create_edit -->|"formats dates"| node_date_helpers
node_create_edit -->|"uses recurrence rules"| node_interval_rules
node_app -->|"uses reminder types"| node_reminder_model
node_storage -->|"reads and writes"| node_local_store
node_storage -->|"schedules and cancels"| node_notifications
node_storage -->|"calculates next cycle"| node_interval_rules
node_storage -->|"syncs native state"| node_native_scheduler
node_notifications -->|"delegates scheduling"| node_native_scheduler
node_native_scheduler -->|"uses AlarmManager"| node_android_alarms
node_storage -->|"refreshes widget"| node_widget_sync
node_widget_sync -->|"renders widget"| node_widget_view
node_widget_sync -->|"registers handler"| node_widget_task
node_widget_task -->|"loads and toggles"| node_storage
node_widget_task -->|"renders updates"| node_widget_view
node_home_screen -.->|"dispatches widget actions"| node_widget_task
node_theme_context -->|"creates theme"| node_theme
node_app -->|"provides app theme"| node_theme_context
node_header -->|"triggers test alert"| node_notifications
node_settings -->|"configures alerts"| node_notifications

click node_app "https://github.com/hsakhiya/remindme/blob/main/App.tsx"
click node_create_edit "https://github.com/hsakhiya/remindme/blob/main/src/components/AddReminderModal.tsx"
click node_filters "https://github.com/hsakhiya/remindme/blob/main/src/components/FilterBar.tsx"
click node_header "https://github.com/hsakhiya/remindme/blob/main/src/components/Header.tsx"
click node_reminder_card "https://github.com/hsakhiya/remindme/blob/main/src/components/ReminderCard.tsx"
click node_settings "https://github.com/hsakhiya/remindme/blob/main/src/components/SettingsModal.tsx"
click node_empty_state "https://github.com/hsakhiya/remindme/blob/main/src/components/EmptyState.tsx"
click node_reminder_model "https://github.com/hsakhiya/remindme/blob/main/src/types/reminder.ts"
click node_interval_rules "https://github.com/hsakhiya/remindme/blob/main/src/utils/intervalUtils.ts"
click node_date_helpers "https://github.com/hsakhiya/remindme/blob/main/src/utils/dateUtils.ts"
click node_storage "https://github.com/hsakhiya/remindme/blob/main/src/services/storageService.ts"
click node_notifications "https://github.com/hsakhiya/remindme/blob/main/src/services/notificationService.ts"
click node_native_scheduler "https://github.com/hsakhiya/remindme/blob/main/src/services/nativeReminderSchedulerService.ts"
click node_widget_sync "https://github.com/hsakhiya/remindme/blob/main/src/services/widgetSyncService.tsx"
click node_widget_task "https://github.com/hsakhiya/remindme/blob/main/src/widgets/widgetTaskHandler.tsx"
click node_widget_view "https://github.com/hsakhiya/remindme/blob/main/src/widgets/RemindersWidget.tsx"
click node_theme_context "https://github.com/hsakhiya/remindme/blob/main/src/context/ThemeContext.tsx"
click node_theme "https://github.com/hsakhiya/remindme/blob/main/src/theme/theme.ts"

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_app,node_create_edit,node_filters,node_header,node_reminder_card,node_settings,node_empty_state,node_user,node_home_screen toneBlue
class node_reminder_model,node_interval_rules,node_date_helpers toneAmber
class node_storage,node_local_store,node_notifications,node_native_scheduler,node_android_alarms toneMint
class node_widget_sync,node_widget_task,node_widget_view toneRose
class node_theme_context,node_theme toneIndigo
```

## Components

### App workflow

- [App coordinator](https://github.com/hsakhiya/remindme/blob/main/App.tsx): `App.tsx`
- [Create and edit](https://github.com/hsakhiya/remindme/blob/main/src/components/AddReminderModal.tsx): `src/components/AddReminderModal.tsx`
- [Search and filters](https://github.com/hsakhiya/remindme/blob/main/src/components/FilterBar.tsx): `src/components/FilterBar.tsx`
- [Summary and test alert](https://github.com/hsakhiya/remindme/blob/main/src/components/Header.tsx): `src/components/Header.tsx`
- [Reminder actions](https://github.com/hsakhiya/remindme/blob/main/src/components/ReminderCard.tsx): `src/components/ReminderCard.tsx`
- [App settings](https://github.com/hsakhiya/remindme/blob/main/src/components/SettingsModal.tsx): `src/components/SettingsModal.tsx`
- [Empty results](https://github.com/hsakhiya/remindme/blob/main/src/components/EmptyState.tsx): `src/components/EmptyState.tsx`

### Reminder domain

- [Reminder model](https://github.com/hsakhiya/remindme/blob/main/src/types/reminder.ts): `src/types/reminder.ts`
- [Recurrence and quiet hours](https://github.com/hsakhiya/remindme/blob/main/src/utils/intervalUtils.ts): `src/utils/intervalUtils.ts`
- [Date formatting](https://github.com/hsakhiya/remindme/blob/main/src/utils/dateUtils.ts): `src/utils/dateUtils.ts`

### Alerts and persistence

- [Reminder persistence](https://github.com/hsakhiya/remindme/blob/main/src/services/storageService.ts): `src/services/storageService.ts`
- **AsyncStorage**
- [Notification scheduling](https://github.com/hsakhiya/remindme/blob/main/src/services/notificationService.ts): `src/services/notificationService.ts`
- [Native alarm scheduler](https://github.com/hsakhiya/remindme/blob/main/src/services/nativeReminderSchedulerService.ts): `src/services/nativeReminderSchedulerService.ts`
- **Android alarm services**

### Home-screen widget

- [Widget synchronization](https://github.com/hsakhiya/remindme/blob/main/src/services/widgetSyncService.tsx): `src/services/widgetSyncService.tsx`
- [Widget task handler](https://github.com/hsakhiya/remindme/blob/main/src/widgets/widgetTaskHandler.tsx): `src/widgets/widgetTaskHandler.tsx`
- [Reminder widget](https://github.com/hsakhiya/remindme/blob/main/src/widgets/RemindersWidget.tsx): `src/widgets/RemindersWidget.tsx`

### Presentation support

- [Theme preferences](https://github.com/hsakhiya/remindme/blob/main/src/context/ThemeContext.tsx): `src/context/ThemeContext.tsx`
- [Theme and category styles](https://github.com/hsakhiya/remindme/blob/main/src/theme/theme.ts): `src/theme/theme.ts`

### Other components

- **Reminder user**
- **Android home screen**

## Connections

- Reminder user → App coordinator: uses (evidence: `README.md`)
- App coordinator → Create and edit: opens (evidence: `App.tsx`)
- App coordinator → Search and filters: renders (evidence: `App.tsx`)
- App coordinator → Summary and test alert: renders (evidence: `App.tsx`)
- App coordinator → Reminder actions: renders (evidence: `App.tsx`)
- App coordinator → App settings: renders (evidence: `App.tsx`)
- App coordinator → Empty results: renders (evidence: `App.tsx`)
- App coordinator → Reminder persistence: loads and updates (evidence: `App.tsx`)
- Create and edit → Date formatting: formats dates (evidence: `src/components/AddReminderModal.tsx`)
- Create and edit → Recurrence and quiet hours: uses recurrence rules (evidence: `src/components/AddReminderModal.tsx`)
- App coordinator → Reminder model: uses reminder types (evidence: `App.tsx`)
- Reminder persistence → AsyncStorage: reads and writes (evidence: `src/services/storageService.ts`)
- Reminder persistence → Notification scheduling: schedules and cancels (evidence: `src/services/storageService.ts`)
- Reminder persistence → Recurrence and quiet hours: calculates next cycle (evidence: `src/services/storageService.ts`)
- Reminder persistence → Native alarm scheduler: syncs native state (evidence: `src/services/storageService.ts`)
- Notification scheduling → Native alarm scheduler: delegates scheduling (evidence: `src/services/notificationService.ts`)
- Native alarm scheduler → Android alarm services: uses AlarmManager (evidence: `src/services/nativeReminderSchedulerService.ts`)
- Reminder persistence → Widget synchronization: refreshes widget (evidence: `src/services/storageService.ts`)
- Widget synchronization → Reminder widget: renders widget (evidence: `src/services/widgetSyncService.tsx`)
- Widget synchronization → Widget task handler: registers handler (evidence: `src/services/widgetSyncService.tsx`)
- Widget task handler → Reminder persistence: loads and toggles (evidence: `src/widgets/widgetTaskHandler.tsx`)
- Widget task handler → Reminder widget: renders updates (evidence: `src/widgets/widgetTaskHandler.tsx`)
- Android home screen → Widget task handler: dispatches widget actions
- Theme preferences → Theme and category styles: creates theme (evidence: `src/context/ThemeContext.tsx`)
- App coordinator → Theme preferences: provides app theme (evidence: `App.tsx`)
- Summary and test alert → Notification scheduling: triggers test alert (evidence: `src/components/Header.tsx`)
- App settings → Notification scheduling: configures alerts (evidence: `src/components/SettingsModal.tsx`)
