# faraujop/glykos architecture

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

- Interactive diagram: https://gitdiagram.com/faraujop/glykos
- Repository: https://github.com/faraujop/glykos

## Overview

Glykos is an Android companion app for runners: it polls glucose from a LibreLinkUp follower account, decides when readings or alarms should be announced, and delivers them by Spanish voice, watch-forwarded notifications, or both. The app also configures credentials and output preferences and retains an in-memory session summary. README capabilities guide the workflow; sampled source confirms key service, output, settings, and session paths. Some UI wiring and unsampled implementation details are represented only where the README or source index supports them.

Main entry points: [`feature/monitor/src/main/kotlin/com/glykos/feature/monitor/MonitorService.kt`](https://github.com/faraujop/glykos/blob/main/feature/monitor/src/main/kotlin/com/glykos/feature/monitor/MonitorService.kt) (Foreground monitor), [`app/src/main/kotlin/com/glykos/app/MainActivity.kt`](https://github.com/faraujop/glykos/blob/main/app/src/main/kotlin/com/glykos/app/MainActivity.kt) (Android app UI), [`feature/output/src/main/kotlin/com/glykos/feature/output/NotificationWatchOutput.kt`](https://github.com/faraujop/glykos/blob/main/feature/output/src/main/kotlin/com/glykos/feature/output/NotificationWatchOutput.kt) (Watch notification output), [`app/src/main/kotlin/com/glykos/app/HomeViewModel.kt`](https://github.com/faraujop/glykos/blob/main/app/src/main/kotlin/com/glykos/app/HomeViewModel.kt) (Home state)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["App experience"]
  node_androidui["Android app UI<br/>[MainActivity.kt]"]
  node_viewmodel["Home state<br/>[HomeViewModel.kt]"]
  node_summaryui["Session summary UI"]
end

subgraph group_monitoring["Monitoring"]
  node_service["Foreground monitor<br/>[MonitorService.kt]"]
  node_controller["Monitor controller"]
end

subgraph group_domain["Glucose domain"]
  node_glucosemonitor["Polling monitor<br/>[GlucoseMonitor.kt]"]
  node_policy["Announcement policy"]
  node_sessionrecorder["Session recorder<br/>[SessionRecorder.kt]"]
  node_sessiondata["Session summary logic<br/>[SessionSummary.kt]"]
  node_formatter["Notification formatter"]
end

subgraph group_delivery["Data and delivery"]
  node_settings[("Settings store")]
  node_datasource["Glucose source interface<br/>[GlucoseSource.kt]"]
  node_libre["LibreLinkUp source"]
  node_demodata["Demo glucose source"]
  node_datadi["Data bindings<br/>[DataModule.kt]"]
  node_voice["Voice output<br/>[VoiceOutput.kt]"]
  node_watch["Watch notification output"]
end

node_runner(("Runner"))
node_cloud{{"LibreLinkUp cloud"}}
node_garmin{{"Garmin Connect and watch"}}

node_runner -->|"configures and starts"| node_androidui
node_androidui -->|"observes app state"| node_viewmodel
node_viewmodel -->|"reads and saves settings"| node_settings
node_viewmodel -->|"starts and observes"| node_controller
node_androidui -->|"sends test announcements"| node_voice
node_androidui -->|"sends test announcements"| node_watch
node_androidui -->|"shows session summary"| node_summaryui
node_summaryui -->|"summarizes readings"| node_sessiondata
node_datadi -->|"binds implementation"| node_libre
node_datadi -->|"binds implementation"| node_demodata
node_libre -->|"implements"| node_datasource
node_demodata -.->|"implements"| node_datasource
node_libre -->|"polls glucose"| node_cloud
node_service -->|"observes configuration"| node_settings
node_service -->|"fetches readings"| node_datasource
node_service -->|"runs polling monitor"| node_glucosemonitor
node_glucosemonitor -->|"decides announcements"| node_policy
node_service -->|"delivers announcements"| node_voice
node_service -->|"delivers announcements"| node_watch
node_service -->|"reports monitor state"| node_controller
node_controller -->|"records readings"| node_sessionrecorder
node_sessionrecorder -->|"finishes session data"| node_sessiondata
node_voice -->|"speaks through headphones"| node_garmin
node_watch -->|"formats notification"| node_formatter
node_watch -->|"forwards notification"| node_garmin

click node_androidui "https://github.com/faraujop/glykos/blob/main/app/src/main/kotlin/com/glykos/app/MainActivity.kt"
click node_viewmodel "https://github.com/faraujop/glykos/blob/main/app/src/main/kotlin/com/glykos/app/HomeViewModel.kt"
click node_summaryui "https://github.com/faraujop/glykos/blob/main/app/src/main/kotlin/com/glykos/app/SessionSummaryScreen.kt"
click node_settings "https://github.com/faraujop/glykos/blob/main/core/data/src/main/kotlin/com/glykos/core/data/settings/SettingsRepository.kt"
click node_datasource "https://github.com/faraujop/glykos/blob/main/core/data/src/main/kotlin/com/glykos/core/data/source/GlucoseSource.kt"
click node_libre "https://github.com/faraujop/glykos/blob/main/core/data/src/main/kotlin/com/glykos/core/data/librelinkup/LibreLinkUpSource.kt"
click node_demodata "https://github.com/faraujop/glykos/blob/main/core/data/src/main/kotlin/com/glykos/core/data/demo/DemoGlucoseSource.kt"
click node_datadi "https://github.com/faraujop/glykos/blob/main/core/data/src/main/kotlin/com/glykos/core/data/di/DataModule.kt"
click node_service "https://github.com/faraujop/glykos/blob/main/feature/monitor/src/main/kotlin/com/glykos/feature/monitor/MonitorService.kt"
click node_controller "https://github.com/faraujop/glykos/blob/main/feature/monitor/src/main/kotlin/com/glykos/feature/monitor/MonitorController.kt"
click node_glucosemonitor "https://github.com/faraujop/glykos/blob/main/core/domain/src/main/kotlin/com/glykos/core/domain/monitor/GlucoseMonitor.kt"
click node_policy "https://github.com/faraujop/glykos/blob/main/core/domain/src/main/kotlin/com/glykos/core/domain/announce/AnnouncementPolicy.kt"
click node_sessionrecorder "https://github.com/faraujop/glykos/blob/main/core/domain/src/main/kotlin/com/glykos/core/domain/session/SessionRecorder.kt"
click node_sessiondata "https://github.com/faraujop/glykos/blob/main/core/domain/src/main/kotlin/com/glykos/core/domain/session/SessionSummary.kt"
click node_voice "https://github.com/faraujop/glykos/blob/main/feature/output/src/main/kotlin/com/glykos/feature/output/VoiceOutput.kt"
click node_watch "https://github.com/faraujop/glykos/blob/main/feature/output/src/main/kotlin/com/glykos/feature/output/NotificationWatchOutput.kt"
click node_formatter "https://github.com/faraujop/glykos/blob/main/core/domain/src/main/kotlin/com/glykos/core/domain/format/NotificationMessageFormatter.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_androidui,node_viewmodel,node_summaryui toneBlue
class node_service,node_controller toneAmber
class node_glucosemonitor,node_policy,node_sessionrecorder,node_sessiondata,node_formatter toneMint
class node_settings,node_datasource,node_libre,node_demodata,node_datadi,node_voice,node_watch toneRose
class node_runner,node_cloud,node_garmin toneIndigo
```

## Components

### App experience

- [Android app UI](https://github.com/faraujop/glykos/blob/main/app/src/main/kotlin/com/glykos/app/MainActivity.kt): `app/src/main/kotlin/com/glykos/app/MainActivity.kt`
- [Home state](https://github.com/faraujop/glykos/blob/main/app/src/main/kotlin/com/glykos/app/HomeViewModel.kt): `app/src/main/kotlin/com/glykos/app/HomeViewModel.kt`
- [Session summary UI](https://github.com/faraujop/glykos/blob/main/app/src/main/kotlin/com/glykos/app/SessionSummaryScreen.kt): `app/src/main/kotlin/com/glykos/app/SessionSummaryScreen.kt`

### Monitoring

- [Foreground monitor](https://github.com/faraujop/glykos/blob/main/feature/monitor/src/main/kotlin/com/glykos/feature/monitor/MonitorService.kt): `feature/monitor/src/main/kotlin/com/glykos/feature/monitor/MonitorService.kt`
- [Monitor controller](https://github.com/faraujop/glykos/blob/main/feature/monitor/src/main/kotlin/com/glykos/feature/monitor/MonitorController.kt): `feature/monitor/src/main/kotlin/com/glykos/feature/monitor/MonitorController.kt`

### Glucose domain

- [Polling monitor](https://github.com/faraujop/glykos/blob/main/core/domain/src/main/kotlin/com/glykos/core/domain/monitor/GlucoseMonitor.kt): `core/domain/src/main/kotlin/com/glykos/core/domain/monitor/GlucoseMonitor.kt`
- [Announcement policy](https://github.com/faraujop/glykos/blob/main/core/domain/src/main/kotlin/com/glykos/core/domain/announce/AnnouncementPolicy.kt): `core/domain/src/main/kotlin/com/glykos/core/domain/announce/AnnouncementPolicy.kt`
- [Session recorder](https://github.com/faraujop/glykos/blob/main/core/domain/src/main/kotlin/com/glykos/core/domain/session/SessionRecorder.kt): `core/domain/src/main/kotlin/com/glykos/core/domain/session/SessionRecorder.kt`
- [Session summary logic](https://github.com/faraujop/glykos/blob/main/core/domain/src/main/kotlin/com/glykos/core/domain/session/SessionSummary.kt): `core/domain/src/main/kotlin/com/glykos/core/domain/session/SessionSummary.kt`
- [Notification formatter](https://github.com/faraujop/glykos/blob/main/core/domain/src/main/kotlin/com/glykos/core/domain/format/NotificationMessageFormatter.kt): `core/domain/src/main/kotlin/com/glykos/core/domain/format/NotificationMessageFormatter.kt`

### Data and delivery

- [Settings store](https://github.com/faraujop/glykos/blob/main/core/data/src/main/kotlin/com/glykos/core/data/settings/SettingsRepository.kt): `core/data/src/main/kotlin/com/glykos/core/data/settings/SettingsRepository.kt`
- [Glucose source interface](https://github.com/faraujop/glykos/blob/main/core/data/src/main/kotlin/com/glykos/core/data/source/GlucoseSource.kt): `core/data/src/main/kotlin/com/glykos/core/data/source/GlucoseSource.kt`
- [LibreLinkUp source](https://github.com/faraujop/glykos/blob/main/core/data/src/main/kotlin/com/glykos/core/data/librelinkup/LibreLinkUpSource.kt): `core/data/src/main/kotlin/com/glykos/core/data/librelinkup/LibreLinkUpSource.kt`
- [Demo glucose source](https://github.com/faraujop/glykos/blob/main/core/data/src/main/kotlin/com/glykos/core/data/demo/DemoGlucoseSource.kt): `core/data/src/main/kotlin/com/glykos/core/data/demo/DemoGlucoseSource.kt`
- [Data bindings](https://github.com/faraujop/glykos/blob/main/core/data/src/main/kotlin/com/glykos/core/data/di/DataModule.kt): `core/data/src/main/kotlin/com/glykos/core/data/di/DataModule.kt`
- [Voice output](https://github.com/faraujop/glykos/blob/main/feature/output/src/main/kotlin/com/glykos/feature/output/VoiceOutput.kt): `feature/output/src/main/kotlin/com/glykos/feature/output/VoiceOutput.kt`
- [Watch notification output](https://github.com/faraujop/glykos/blob/main/feature/output/src/main/kotlin/com/glykos/feature/output/NotificationWatchOutput.kt): `feature/output/src/main/kotlin/com/glykos/feature/output/NotificationWatchOutput.kt`

### Other components

- **Runner**
- **LibreLinkUp cloud**
- **Garmin Connect and watch**

## Connections

- Runner → Android app UI: configures and starts (evidence: `README.md`)
- Android app UI → Home state: observes app state (evidence: `app/src/main/kotlin/com/glykos/app/MainActivity.kt`)
- Home state → Settings store: reads and saves settings (evidence: `app/src/main/kotlin/com/glykos/app/HomeViewModel.kt`)
- Home state → Monitor controller: starts and observes (evidence: `app/src/main/kotlin/com/glykos/app/HomeViewModel.kt`)
- Android app UI → Voice output: sends test announcements (evidence: `app/src/main/kotlin/com/glykos/app/MainActivity.kt`)
- Android app UI → Watch notification output: sends test announcements (evidence: `app/src/main/kotlin/com/glykos/app/MainActivity.kt`)
- Android app UI → Session summary UI: shows session summary (evidence: `app/src/main/kotlin/com/glykos/app/MainActivity.kt`)
- Session summary UI → Session summary logic: summarizes readings (evidence: `app/src/main/kotlin/com/glykos/app/SessionSummaryScreen.kt`)
- Data bindings → LibreLinkUp source: binds implementation (evidence: `core/data/src/main/kotlin/com/glykos/core/data/di/DataModule.kt`)
- Data bindings → Demo glucose source: binds implementation (evidence: `core/data/src/main/kotlin/com/glykos/core/data/di/DataModule.kt`)
- LibreLinkUp source → Glucose source interface: implements (evidence: `core/data/src/main/kotlin/com/glykos/core/data/librelinkup/LibreLinkUpSource.kt`)
- Demo glucose source → Glucose source interface: implements
- LibreLinkUp source → LibreLinkUp cloud: polls glucose (evidence: `README.md`)
- Foreground monitor → Settings store: observes configuration (evidence: `feature/monitor/src/main/kotlin/com/glykos/feature/monitor/MonitorService.kt`)
- Foreground monitor → Glucose source interface: fetches readings (evidence: `feature/monitor/src/main/kotlin/com/glykos/feature/monitor/MonitorService.kt`)
- Foreground monitor → Polling monitor: runs polling monitor (evidence: `feature/monitor/src/main/kotlin/com/glykos/feature/monitor/MonitorService.kt`)
- Polling monitor → Announcement policy: decides announcements (evidence: `core/domain/src/main/kotlin/com/glykos/core/domain/monitor/GlucoseMonitor.kt`)
- Foreground monitor → Voice output: delivers announcements (evidence: `feature/monitor/src/main/kotlin/com/glykos/feature/monitor/MonitorService.kt`)
- Foreground monitor → Watch notification output: delivers announcements (evidence: `feature/monitor/src/main/kotlin/com/glykos/feature/monitor/MonitorService.kt`)
- Foreground monitor → Monitor controller: reports monitor state (evidence: `feature/monitor/src/main/kotlin/com/glykos/feature/monitor/MonitorService.kt`)
- Monitor controller → Session recorder: records readings (evidence: `feature/monitor/src/main/kotlin/com/glykos/feature/monitor/MonitorController.kt`)
- Session recorder → Session summary logic: finishes session data (evidence: `core/domain/src/main/kotlin/com/glykos/core/domain/session/SessionRecorder.kt`)
- Voice output → Garmin Connect and watch: speaks through headphones (evidence: `README.md`)
- Watch notification output → Notification formatter: formats notification (evidence: `feature/output/src/main/kotlin/com/glykos/feature/output/NotificationWatchOutput.kt`)
- Watch notification output → Garmin Connect and watch: forwards notification (evidence: `README.md`)
