# kittug7/aquapal architecture

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

- Interactive diagram: https://gitdiagram.com/kittug7/aquapal
- Repository: https://github.com/kittug7/aquapal

## Overview

AquaPal is a single-file PyQt6 desktop hydration reminder. The user selects an interval and starts reminders; when the timer fires, a toast displays an animated character and offers drink-confirmation or snooze actions. Confirming restarts the selected interval, while snoozing schedules a ten-minute reminder. The README also describes quiet background operation and Windows-style presentation. The source shows timer, toast, and action wiring; no persistence or external service is present.

Main entry points: [`aquapal.py`](https://github.com/kittug7/aquapal/blob/Master/aquapal.py) (Toast notification)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_startup["App and settings"]
  node_app["App startup<br/>[aquapal.py]"]
  node_settings["Interval settings<br/>[aquapal.py]"]
end

subgraph group_reminders["Reminder flow"]
  node_timer["Reminder timer<br/>[aquapal.py]"]
end

subgraph group_toast["Toast interaction"]
  node_notification["Toast notification<br/>[aquapal.py]"]
  node_animation["Character animation"]
end

node_user(("User"))

node_user -->|"launches"| node_app
node_app -->|"opens"| node_settings
node_user -->|"selects interval"| node_settings
node_settings -->|"starts interval"| node_timer
node_timer -->|"triggers"| node_notification
node_notification -->|"loads character"| node_animation
node_user -->|"chooses action"| node_notification
node_notification -->|"restarts interval"| node_settings
node_notification -->|"starts snooze"| node_timer

click node_app "https://github.com/kittug7/aquapal/blob/Master/aquapal.py"
click node_settings "https://github.com/kittug7/aquapal/blob/Master/aquapal.py"
click node_timer "https://github.com/kittug7/aquapal/blob/Master/aquapal.py"
click node_notification "https://github.com/kittug7/aquapal/blob/Master/aquapal.py"

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_settings,node_user toneBlue
class node_timer toneAmber
class node_notification,node_animation toneMint
```

## Components

### App and settings

- [App startup](https://github.com/kittug7/aquapal/blob/Master/aquapal.py): `aquapal.py`
- [Interval settings](https://github.com/kittug7/aquapal/blob/Master/aquapal.py): `aquapal.py`

### Reminder flow

- [Reminder timer](https://github.com/kittug7/aquapal/blob/Master/aquapal.py): `aquapal.py`

### Toast interaction

- [Toast notification](https://github.com/kittug7/aquapal/blob/Master/aquapal.py): `aquapal.py`
- **Character animation**

### Other components

- **User**

## Connections

- User → App startup: launches (evidence: `README.md`)
- App startup → Interval settings: opens (evidence: `aquapal.py`)
- User → Interval settings: selects interval (evidence: `README.md`)
- Interval settings → Reminder timer: starts interval (evidence: `aquapal.py`)
- Reminder timer → Toast notification: triggers (evidence: `aquapal.py`)
- Toast notification → Character animation: loads character (evidence: `aquapal.py`)
- User → Toast notification: chooses action (evidence: `aquapal.py`)
- Toast notification → Interval settings: restarts interval (evidence: `aquapal.py`)
- Toast notification → Reminder timer: starts snooze (evidence: `aquapal.py`)
