# riyaddecoder/voice-reminder-app architecture

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

- Interactive diagram: https://gitdiagram.com/riyaddecoder/voice-reminder-app
- Repository: https://github.com/riyaddecoder/voice-reminder-app

## Overview

Voice Reminder is a desktop reminder app: users create scheduled reminders, optionally record or attach audio, see them in the home list, and receive a popup and audio when due. The main frame coordinates reminder creation, file persistence, and timer scheduling; supporting UI includes reminder details and system-tray access. The graph reflects sampled calls and source-index references; several implementations are only identified by the index, so their internal interactions are omitted where not evidenced.

Main entry points: [`src/reminderapp/view/JFrameHomeUI.java`](https://github.com/riyaddecoder/voice-reminder-app/blob/master/src/reminderapp/view/JFrameHomeUI.java) (Home window), [`src/reminderapp/service/FileLuncher.java`](https://github.com/riyaddecoder/voice-reminder-app/blob/master/src/reminderapp/service/FileLuncher.java) (File and audio), [`src/reminderapp/view/JFrameNewReminder.java`](https://github.com/riyaddecoder/voice-reminder-app/blob/master/src/reminderapp/view/JFrameNewReminder.java) (New reminder), [`src/reminderapp/service/TimerAlarmStarter.java`](https://github.com/riyaddecoder/voice-reminder-app/blob/master/src/reminderapp/service/TimerAlarmStarter.java) (Timer scheduler)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_startup["Launch"]
  node_main["App entry<br/>[Main.java]"]
end

subgraph group_interface["Reminder UI"]
  node_home["Home window<br/>[JFrameHomeUI.java]"]
  node_new["New reminder"]
  node_alarm_list["Alarm list<br/>[JPanelAlarms.java]"]
  node_popup["Reminder popup"]
  node_properties["Reminder details"]
  node_tray["System tray<br/>[TrayClass.java]"]
end

subgraph group_runtime["Alarm Runtime"]
  node_model["Alarm model<br/>[SetAlarm.java]"]
  node_scheduler["Timer scheduler"]
end

subgraph group_files["Reminder Files"]
  node_storage[("File and audio<br/>[FileLuncher.java]")]
  node_cleanup["Deferred cleanup"]
end

node_user(("User"))

node_user -->|"starts app"| node_main
node_main -->|"opens"| node_home
node_home -->|"creates"| node_tray
node_tray -->|"opens"| node_new
node_home -->|"opens"| node_new
node_new -->|"saves audio"| node_storage
node_home -->|"loads alarms"| node_storage
node_storage -->|"creates"| node_model
node_home -->|"starts alarms"| node_scheduler
node_scheduler -->|"creates"| node_model
node_home -->|"displays"| node_alarm_list
node_alarm_list -.->|"opens details"| node_properties
node_home -.->|"shows due alarm"| node_popup
node_home -->|"sets alarm"| node_model
node_home -->|"creates alarm"| node_scheduler
node_storage -->|"requests cleanup"| node_cleanup

click node_main "https://github.com/riyaddecoder/voice-reminder-app/blob/master/src/reminderapp/Main.java"
click node_home "https://github.com/riyaddecoder/voice-reminder-app/blob/master/src/reminderapp/view/JFrameHomeUI.java"
click node_new "https://github.com/riyaddecoder/voice-reminder-app/blob/master/src/reminderapp/view/JFrameNewReminder.java"
click node_alarm_list "https://github.com/riyaddecoder/voice-reminder-app/blob/master/src/reminderapp/view/JPanelAlarms.java"
click node_popup "https://github.com/riyaddecoder/voice-reminder-app/blob/master/src/reminderapp/view/JDialogReminder.java"
click node_properties "https://github.com/riyaddecoder/voice-reminder-app/blob/master/src/reminderapp/view/JDialogReminderProperties.java"
click node_tray "https://github.com/riyaddecoder/voice-reminder-app/blob/master/src/reminderapp/service/TrayClass.java"
click node_model "https://github.com/riyaddecoder/voice-reminder-app/blob/master/src/reminderapp/service/SetAlarm.java"
click node_scheduler "https://github.com/riyaddecoder/voice-reminder-app/blob/master/src/reminderapp/service/TimerAlarmStarter.java"
click node_storage "https://github.com/riyaddecoder/voice-reminder-app/blob/master/src/reminderapp/service/FileLuncher.java"
click node_cleanup "https://github.com/riyaddecoder/voice-reminder-app/blob/master/src/reminderapp/service/ErrorCorrection.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_user toneBlue
class node_home,node_new,node_alarm_list,node_popup,node_properties,node_tray toneAmber
class node_model,node_scheduler toneMint
class node_storage,node_cleanup toneRose
```

## Components

### Launch

- [App entry](https://github.com/riyaddecoder/voice-reminder-app/blob/master/src/reminderapp/Main.java): `src/reminderapp/Main.java`

### Reminder UI

- [Home window](https://github.com/riyaddecoder/voice-reminder-app/blob/master/src/reminderapp/view/JFrameHomeUI.java): `src/reminderapp/view/JFrameHomeUI.java`
- [New reminder](https://github.com/riyaddecoder/voice-reminder-app/blob/master/src/reminderapp/view/JFrameNewReminder.java): `src/reminderapp/view/JFrameNewReminder.java`
- [Alarm list](https://github.com/riyaddecoder/voice-reminder-app/blob/master/src/reminderapp/view/JPanelAlarms.java): `src/reminderapp/view/JPanelAlarms.java`
- [Reminder popup](https://github.com/riyaddecoder/voice-reminder-app/blob/master/src/reminderapp/view/JDialogReminder.java): `src/reminderapp/view/JDialogReminder.java`
- [Reminder details](https://github.com/riyaddecoder/voice-reminder-app/blob/master/src/reminderapp/view/JDialogReminderProperties.java): `src/reminderapp/view/JDialogReminderProperties.java`
- [System tray](https://github.com/riyaddecoder/voice-reminder-app/blob/master/src/reminderapp/service/TrayClass.java): `src/reminderapp/service/TrayClass.java`

### Alarm Runtime

- [Alarm model](https://github.com/riyaddecoder/voice-reminder-app/blob/master/src/reminderapp/service/SetAlarm.java): `src/reminderapp/service/SetAlarm.java`
- [Timer scheduler](https://github.com/riyaddecoder/voice-reminder-app/blob/master/src/reminderapp/service/TimerAlarmStarter.java): `src/reminderapp/service/TimerAlarmStarter.java`

### Reminder Files

- [File and audio](https://github.com/riyaddecoder/voice-reminder-app/blob/master/src/reminderapp/service/FileLuncher.java): `src/reminderapp/service/FileLuncher.java`
- [Deferred cleanup](https://github.com/riyaddecoder/voice-reminder-app/blob/master/src/reminderapp/service/ErrorCorrection.java): `src/reminderapp/service/ErrorCorrection.java`

### Other components

- **User**

## Connections

- User → App entry: starts app
- App entry → Home window: opens (evidence: `src/reminderapp/Main.java`)
- Home window → System tray: creates (evidence: `src/reminderapp/view/JFrameHomeUI.java`)
- System tray → New reminder: opens (evidence: `src/reminderapp/service/TrayClass.java`)
- Home window → New reminder: opens (evidence: `src/reminderapp/view/JFrameHomeUI.java`)
- New reminder → File and audio: saves audio (evidence: `src/reminderapp/view/JFrameNewReminder.java`)
- Home window → File and audio: loads alarms (evidence: `src/reminderapp/view/JFrameHomeUI.java`)
- File and audio → Alarm model: creates (evidence: `src/reminderapp/service/FileLuncher.java`)
- Home window → Timer scheduler: starts alarms (evidence: `src/reminderapp/view/JFrameHomeUI.java`)
- Timer scheduler → Alarm model: creates (evidence: `src/reminderapp/service/TimerAlarmStarter.java`)
- Home window → Alarm list: displays (evidence: `src/reminderapp/view/JFrameHomeUI.java`)
- Alarm list → Reminder details: opens details (evidence: `src/reminderapp/view/JPanelAlarms.java`)
- Home window → Reminder popup: shows due alarm (evidence: `src/reminderapp/view/JFrameHomeUI.java`)
- Home window → Alarm model: sets alarm (evidence: `src/reminderapp/view/JFrameHomeUI.java`)
- Home window → Timer scheduler: creates alarm (evidence: `src/reminderapp/view/JFrameHomeUI.java`)
- File and audio → Deferred cleanup: requests cleanup (evidence: `src/reminderapp/service/FileLuncher.java`)
