# patrix14r/trollino architecture

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

- Interactive diagram: https://gitdiagram.com/patrix14r/trollino
- Repository: https://github.com/patrix14r/trollino

## Overview

Despertroll is an Android alarm app: users create, edit by enabling or deleting, and schedule one-time or weekly alarms with labels and ringtone choices; the app schedules them with Android and presents a ringing notification when they fire. The graph follows the evidenced UI, view-model, scheduler, receiver, and notification calls. Alarm state is currently in-memory sample data, and ringtone playback is not shown in the sampled runtime. Boot handling and visual-theme wiring are included as capabilities, but their runtime connections are not established by the excerpts.

Main entry points: [`app/src/main/java/com/coldeanx/despertroll/ui/home/HomeScreen.kt`](https://github.com/patrix14r/trollino/blob/main/app/src/main/java/com/coldeanx/despertroll/ui/home/HomeScreen.kt) (Alarm home), [`app/src/main/java/com/coldeanx/despertroll/domain/AlarmScheduler.kt`](https://github.com/patrix14r/trollino/blob/main/app/src/main/java/com/coldeanx/despertroll/domain/AlarmScheduler.kt) (Alarm scheduler), [`app/src/main/java/com/coldeanx/despertroll/MainActivity.kt`](https://github.com/patrix14r/trollino/blob/main/app/src/main/java/com/coldeanx/despertroll/MainActivity.kt) (Main activity), [`app/src/main/java/com/coldeanx/despertroll/ui/home/HomeViewModel.kt`](https://github.com/patrix14r/trollino/blob/main/app/src/main/java/com/coldeanx/despertroll/ui/home/HomeViewModel.kt) (Alarm actions)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_ui["App interface"]
  node_activity["Main activity<br/>[MainActivity.kt]"]
  node_home["Alarm home<br/>[HomeScreen.kt]"]
  node_homevm["Alarm actions<br/>[HomeViewModel.kt]"]
end

subgraph group_alarm["Alarm scheduling"]
  node_alarmmodel["Alarm model<br/>[Alarm.kt]"]
  node_ringtones["Ringtone choices<br/>[TrollRingtone.kt]"]
  node_scheduler["Alarm scheduler<br/>[AlarmScheduler.kt]"]
end

subgraph group_notify["Alarm delivery"]
  node_alarmreceiver["Alarm receiver<br/>[AlarmReceiver.kt]"]
  node_bootreceiver["Boot receiver<br/>[BootReceiver.kt]"]
  node_notification["Alarm notification"]
end

subgraph group_prefs["Preferences and theme"]
  node_settingsvm["Display preferences"]
  node_settings["Settings dialog<br/>[SettingsScreen.kt]"]
  node_theme["Neumorphic theme<br/>[Theme.kt]"]
  node_colors["Theme colors<br/>[Color.kt]"]
end

node_user(("User"))
node_alarmmanager["Android alarm manager"]
node_notificationsystem["Android notifications"]

node_user -->|"uses"| node_home
node_activity -->|"sets content"| node_home
node_activity -->|"creates"| node_settingsvm
node_activity -->|"creates channel"| node_notification
node_home -->|"calls actions"| node_homevm
node_home -->|"renders alarms"| node_alarmmodel
node_home -->|"offers choices"| node_ringtones
node_homevm -->|"creates"| node_alarmmodel
node_homevm -->|"schedules or cancels"| node_scheduler
node_homevm -->|"selects"| node_ringtones
node_scheduler -->|"reads schedule"| node_alarmmodel
node_scheduler -->|"builds broadcast"| node_alarmreceiver
node_scheduler -->|"sets or cancels"| node_alarmmanager
node_alarmmanager -->|"delivers alarm"| node_alarmreceiver
node_alarmreceiver -->|"shows notification"| node_notification
node_alarmreceiver -->|"reschedules repeats"| node_alarmmanager
node_notification -->|"posts notification"| node_notificationsystem
node_settingsvm -.->|"provides mode"| node_theme
node_settings -->|"reads preferences"| node_settingsvm
node_activity -->|"applies theme"| node_theme
node_theme -.->|"uses palette"| node_colors
node_bootreceiver -.->|"may restore alarms"| node_scheduler

click node_activity "https://github.com/patrix14r/trollino/blob/main/app/src/main/java/com/coldeanx/despertroll/MainActivity.kt"
click node_home "https://github.com/patrix14r/trollino/blob/main/app/src/main/java/com/coldeanx/despertroll/ui/home/HomeScreen.kt"
click node_homevm "https://github.com/patrix14r/trollino/blob/main/app/src/main/java/com/coldeanx/despertroll/ui/home/HomeViewModel.kt"
click node_alarmmodel "https://github.com/patrix14r/trollino/blob/main/app/src/main/java/com/coldeanx/despertroll/data/Alarm.kt"
click node_ringtones "https://github.com/patrix14r/trollino/blob/main/app/src/main/java/com/coldeanx/despertroll/data/TrollRingtone.kt"
click node_scheduler "https://github.com/patrix14r/trollino/blob/main/app/src/main/java/com/coldeanx/despertroll/domain/AlarmScheduler.kt"
click node_alarmreceiver "https://github.com/patrix14r/trollino/blob/main/app/src/main/java/com/coldeanx/despertroll/receiver/AlarmReceiver.kt"
click node_bootreceiver "https://github.com/patrix14r/trollino/blob/main/app/src/main/java/com/coldeanx/despertroll/receiver/BootReceiver.kt"
click node_notification "https://github.com/patrix14r/trollino/blob/main/app/src/main/java/com/coldeanx/despertroll/domain/AlarmNotificationHelper.kt"
click node_settingsvm "https://github.com/patrix14r/trollino/blob/main/app/src/main/java/com/coldeanx/despertroll/ui/settings/SettingsViewModel.kt"
click node_settings "https://github.com/patrix14r/trollino/blob/main/app/src/main/java/com/coldeanx/despertroll/ui/settings/SettingsScreen.kt"
click node_theme "https://github.com/patrix14r/trollino/blob/main/app/src/main/java/com/coldeanx/despertroll/ui/theme/Theme.kt"
click node_colors "https://github.com/patrix14r/trollino/blob/main/app/src/main/java/com/coldeanx/despertroll/ui/theme/Color.kt"

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_activity,node_home,node_homevm,node_user toneBlue
class node_alarmmodel,node_ringtones,node_scheduler toneAmber
class node_alarmreceiver,node_bootreceiver,node_notification toneMint
class node_settingsvm,node_settings,node_theme,node_colors toneRose
class node_alarmmanager,node_notificationsystem toneIndigo
```

## Components

### App interface

- [Main activity](https://github.com/patrix14r/trollino/blob/main/app/src/main/java/com/coldeanx/despertroll/MainActivity.kt): `app/src/main/java/com/coldeanx/despertroll/MainActivity.kt`
- [Alarm home](https://github.com/patrix14r/trollino/blob/main/app/src/main/java/com/coldeanx/despertroll/ui/home/HomeScreen.kt): `app/src/main/java/com/coldeanx/despertroll/ui/home/HomeScreen.kt`
- [Alarm actions](https://github.com/patrix14r/trollino/blob/main/app/src/main/java/com/coldeanx/despertroll/ui/home/HomeViewModel.kt): `app/src/main/java/com/coldeanx/despertroll/ui/home/HomeViewModel.kt`

### Alarm scheduling

- [Alarm model](https://github.com/patrix14r/trollino/blob/main/app/src/main/java/com/coldeanx/despertroll/data/Alarm.kt): `app/src/main/java/com/coldeanx/despertroll/data/Alarm.kt`
- [Ringtone choices](https://github.com/patrix14r/trollino/blob/main/app/src/main/java/com/coldeanx/despertroll/data/TrollRingtone.kt): `app/src/main/java/com/coldeanx/despertroll/data/TrollRingtone.kt`
- [Alarm scheduler](https://github.com/patrix14r/trollino/blob/main/app/src/main/java/com/coldeanx/despertroll/domain/AlarmScheduler.kt): `app/src/main/java/com/coldeanx/despertroll/domain/AlarmScheduler.kt`

### Alarm delivery

- [Alarm receiver](https://github.com/patrix14r/trollino/blob/main/app/src/main/java/com/coldeanx/despertroll/receiver/AlarmReceiver.kt): `app/src/main/java/com/coldeanx/despertroll/receiver/AlarmReceiver.kt`
- [Boot receiver](https://github.com/patrix14r/trollino/blob/main/app/src/main/java/com/coldeanx/despertroll/receiver/BootReceiver.kt): `app/src/main/java/com/coldeanx/despertroll/receiver/BootReceiver.kt`
- [Alarm notification](https://github.com/patrix14r/trollino/blob/main/app/src/main/java/com/coldeanx/despertroll/domain/AlarmNotificationHelper.kt): `app/src/main/java/com/coldeanx/despertroll/domain/AlarmNotificationHelper.kt`

### Preferences and theme

- [Display preferences](https://github.com/patrix14r/trollino/blob/main/app/src/main/java/com/coldeanx/despertroll/ui/settings/SettingsViewModel.kt): `app/src/main/java/com/coldeanx/despertroll/ui/settings/SettingsViewModel.kt`
- [Settings dialog](https://github.com/patrix14r/trollino/blob/main/app/src/main/java/com/coldeanx/despertroll/ui/settings/SettingsScreen.kt): `app/src/main/java/com/coldeanx/despertroll/ui/settings/SettingsScreen.kt`
- [Neumorphic theme](https://github.com/patrix14r/trollino/blob/main/app/src/main/java/com/coldeanx/despertroll/ui/theme/Theme.kt): `app/src/main/java/com/coldeanx/despertroll/ui/theme/Theme.kt`
- [Theme colors](https://github.com/patrix14r/trollino/blob/main/app/src/main/java/com/coldeanx/despertroll/ui/theme/Color.kt): `app/src/main/java/com/coldeanx/despertroll/ui/theme/Color.kt`

### Other components

- **User**
- **Android alarm manager**
- **Android notifications**

## Connections

- User → Alarm home: uses (evidence: `app/src/main/java/com/coldeanx/despertroll/ui/home/HomeScreen.kt`)
- Main activity → Alarm home: sets content (evidence: `app/src/main/java/com/coldeanx/despertroll/MainActivity.kt`)
- Main activity → Display preferences: creates (evidence: `app/src/main/java/com/coldeanx/despertroll/MainActivity.kt`)
- Main activity → Alarm notification: creates channel (evidence: `app/src/main/java/com/coldeanx/despertroll/MainActivity.kt`)
- Alarm home → Alarm actions: calls actions (evidence: `app/src/main/java/com/coldeanx/despertroll/ui/home/HomeScreen.kt`)
- Alarm home → Alarm model: renders alarms (evidence: `app/src/main/java/com/coldeanx/despertroll/ui/home/HomeScreen.kt`)
- Alarm home → Ringtone choices: offers choices (evidence: `app/src/main/java/com/coldeanx/despertroll/ui/home/HomeScreen.kt`)
- Alarm actions → Alarm model: creates (evidence: `app/src/main/java/com/coldeanx/despertroll/ui/home/HomeViewModel.kt`)
- Alarm actions → Alarm scheduler: schedules or cancels (evidence: `app/src/main/java/com/coldeanx/despertroll/ui/home/HomeViewModel.kt`)
- Alarm actions → Ringtone choices: selects (evidence: `app/src/main/java/com/coldeanx/despertroll/ui/home/HomeViewModel.kt`)
- Alarm scheduler → Alarm model: reads schedule (evidence: `app/src/main/java/com/coldeanx/despertroll/domain/AlarmScheduler.kt`)
- Alarm scheduler → Alarm receiver: builds broadcast (evidence: `app/src/main/java/com/coldeanx/despertroll/domain/AlarmScheduler.kt`)
- Alarm scheduler → Android alarm manager: sets or cancels (evidence: `app/src/main/java/com/coldeanx/despertroll/domain/AlarmScheduler.kt`)
- Android alarm manager → Alarm receiver: delivers alarm
- Alarm receiver → Alarm notification: shows notification (evidence: `app/src/main/java/com/coldeanx/despertroll/receiver/AlarmReceiver.kt`)
- Alarm receiver → Android alarm manager: reschedules repeats (evidence: `app/src/main/java/com/coldeanx/despertroll/receiver/AlarmReceiver.kt`)
- Alarm notification → Android notifications: posts notification (evidence: `app/src/main/java/com/coldeanx/despertroll/domain/AlarmNotificationHelper.kt`)
- Display preferences → Neumorphic theme: provides mode
- Settings dialog → Display preferences: reads preferences (evidence: `app/src/main/java/com/coldeanx/despertroll/ui/settings/SettingsScreen.kt`)
- Main activity → Neumorphic theme: applies theme (evidence: `app/src/main/java/com/coldeanx/despertroll/MainActivity.kt`)
- Neumorphic theme → Theme colors: uses palette
- Boot receiver → Alarm scheduler: may restore alarms
