# horatiumol/ayuno architecture

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

- Interactive diagram: https://gitdiagram.com/horatiumol/ayuno
- Repository: https://github.com/horatiumol/ayuno

## Overview

Ayuno is an Android intermittent-fasting tracker. The main user workflow starts in the Compose app: choose a fasting plan or start a free fast, track the active session and phase, then end it and review history and progress. The app also provides hydration and weight logs, achievements, backup/share, notifications, and a home-screen widget. Source excerpts support the session, notification, widget, and some storage relationships; links for unsampled features are omitted rather than inferred.

Main entry points: [`app/src/main/java/com/moldovan/ayuno/MainActivity.kt`](https://github.com/horatiumol/ayuno/blob/master/app/src/main/java/com/moldovan/ayuno/MainActivity.kt) (App screens), [`app/src/main/java/com/moldovan/ayuno/data/FastingStorage.kt`](https://github.com/horatiumol/ayuno/blob/master/app/src/main/java/com/moldovan/ayuno/data/FastingStorage.kt) (Session history), [`app/src/main/java/com/moldovan/ayuno/data/BackupHelper.kt`](https://github.com/horatiumol/ayuno/blob/master/app/src/main/java/com/moldovan/ayuno/data/BackupHelper.kt) (Backup export), [`app/src/main/java/com/moldovan/ayuno/Components.kt`](https://github.com/horatiumol/ayuno/blob/master/app/src/main/java/com/moldovan/ayuno/Components.kt) (UI components)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["App experience"]
  node_main["App screens<br/>[MainActivity.kt]"]
  node_components["UI components<br/>[Components.kt]"]
  node_theme["Theme settings<br/>[ThemePreference.kt]"]
  node_language["Language preference"]
end

subgraph group_fasting["Fasting domain"]
  node_phase["Fasting phases<br/>[FastingPhase.kt]"]
  node_plans["Fasting plans<br/>[FastingPlan.kt]"]
  node_faststore[("Session history<br/>[FastingStorage.kt]")]
  node_messages["Contextual messages"]
  node_achievements["Achievements<br/>[Achievement.kt]"]
end

subgraph group_tracking["Personal tracking"]
  node_hydration[("Hydration log")]
  node_weight[("Weight log<br/>[WeightStorage.kt]")]
  node_backup["Backup export<br/>[BackupHelper.kt]"]
  node_sharing["Fast sharing<br/>[ShareHelper.kt]"]
end

subgraph group_platform["Android integrations"]
  node_notifications["Phase notifications"]
  node_phaseworker["Notification worker"]
  node_widget["Fasting widget"]
  node_tick["Widget refresh"]
end

node_user(("User"))
node_preferences[("Android preferences")]

node_user -->|"uses"| node_main
node_main -->|"renders"| node_components
node_main -->|"manages sessions"| node_faststore
node_main -->|"starts planned fast"| node_plans
node_main -->|"provides log"| node_weight
node_main -->|"provides log"| node_hydration
node_main -->|"loads preference"| node_theme
node_main -->|"sets up channel"| node_notifications
node_main -->|"exports backup"| node_backup
node_main -->|"shares session"| node_sharing
node_components -->|"reads session data"| node_faststore
node_components -->|"shows phase data"| node_phase
node_components -->|"shows plan choices"| node_plans
node_faststore -->|"schedules phases"| node_phaseworker
node_phaseworker -->|"checks active fast"| node_faststore
node_phaseworker -->|"shows alert"| node_notifications
node_faststore -->|"starts refresh"| node_tick
node_tick -->|"checks active fast"| node_faststore
node_tick -->|"refreshes widget"| node_widget
node_widget -->|"reads and ends fast"| node_faststore
node_widget -->|"adds water"| node_hydration
node_widget -->|"opens app"| node_main
node_backup -->|"backs up sessions"| node_faststore
node_backup -->|"backs up weights"| node_weight
node_backup -->|"backs up hydration"| node_hydration
node_backup -->|"backs up theme"| node_theme
node_faststore -->|"persists sessions"| node_preferences
node_hydration -->|"persists entries"| node_preferences
node_weight -->|"persists entries"| node_preferences

click node_main "https://github.com/horatiumol/ayuno/blob/master/app/src/main/java/com/moldovan/ayuno/MainActivity.kt"
click node_components "https://github.com/horatiumol/ayuno/blob/master/app/src/main/java/com/moldovan/ayuno/Components.kt"
click node_theme "https://github.com/horatiumol/ayuno/blob/master/app/src/main/java/com/moldovan/ayuno/data/ThemePreference.kt"
click node_language "https://github.com/horatiumol/ayuno/blob/master/app/src/main/java/com/moldovan/ayuno/data/LanguagePreference.kt"
click node_phase "https://github.com/horatiumol/ayuno/blob/master/app/src/main/java/com/moldovan/ayuno/data/FastingPhase.kt"
click node_plans "https://github.com/horatiumol/ayuno/blob/master/app/src/main/java/com/moldovan/ayuno/data/FastingPlan.kt"
click node_faststore "https://github.com/horatiumol/ayuno/blob/master/app/src/main/java/com/moldovan/ayuno/data/FastingStorage.kt"
click node_messages "https://github.com/horatiumol/ayuno/blob/master/app/src/main/java/com/moldovan/ayuno/data/ContextualMessages.kt"
click node_achievements "https://github.com/horatiumol/ayuno/blob/master/app/src/main/java/com/moldovan/ayuno/data/Achievement.kt"
click node_hydration "https://github.com/horatiumol/ayuno/blob/master/app/src/main/java/com/moldovan/ayuno/data/HydrationStorage.kt"
click node_weight "https://github.com/horatiumol/ayuno/blob/master/app/src/main/java/com/moldovan/ayuno/data/WeightStorage.kt"
click node_backup "https://github.com/horatiumol/ayuno/blob/master/app/src/main/java/com/moldovan/ayuno/data/BackupHelper.kt"
click node_sharing "https://github.com/horatiumol/ayuno/blob/master/app/src/main/java/com/moldovan/ayuno/data/ShareHelper.kt"
click node_notifications "https://github.com/horatiumol/ayuno/blob/master/app/src/main/java/com/moldovan/ayuno/data/NotificationHelper.kt"
click node_phaseworker "https://github.com/horatiumol/ayuno/blob/master/app/src/main/java/com/moldovan/ayuno/data/PhaseNotificationWorker.kt"
click node_widget "https://github.com/horatiumol/ayuno/blob/master/app/src/main/java/com/moldovan/ayuno/widget/FastingWidgetProvider.kt"
click node_tick "https://github.com/horatiumol/ayuno/blob/master/app/src/main/java/com/moldovan/ayuno/widget/WidgetTickWorker.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_main,node_components,node_theme,node_language,node_user toneBlue
class node_phase,node_plans,node_faststore,node_messages,node_achievements,node_preferences toneAmber
class node_hydration,node_weight,node_backup,node_sharing toneMint
class node_notifications,node_phaseworker,node_widget,node_tick toneRose
```

## Components

### App experience

- [App screens](https://github.com/horatiumol/ayuno/blob/master/app/src/main/java/com/moldovan/ayuno/MainActivity.kt): `app/src/main/java/com/moldovan/ayuno/MainActivity.kt`
- [UI components](https://github.com/horatiumol/ayuno/blob/master/app/src/main/java/com/moldovan/ayuno/Components.kt): `app/src/main/java/com/moldovan/ayuno/Components.kt`
- [Theme settings](https://github.com/horatiumol/ayuno/blob/master/app/src/main/java/com/moldovan/ayuno/data/ThemePreference.kt): `app/src/main/java/com/moldovan/ayuno/data/ThemePreference.kt`
- [Language preference](https://github.com/horatiumol/ayuno/blob/master/app/src/main/java/com/moldovan/ayuno/data/LanguagePreference.kt): `app/src/main/java/com/moldovan/ayuno/data/LanguagePreference.kt`

### Fasting domain

- [Fasting phases](https://github.com/horatiumol/ayuno/blob/master/app/src/main/java/com/moldovan/ayuno/data/FastingPhase.kt): `app/src/main/java/com/moldovan/ayuno/data/FastingPhase.kt`
- [Fasting plans](https://github.com/horatiumol/ayuno/blob/master/app/src/main/java/com/moldovan/ayuno/data/FastingPlan.kt): `app/src/main/java/com/moldovan/ayuno/data/FastingPlan.kt`
- [Session history](https://github.com/horatiumol/ayuno/blob/master/app/src/main/java/com/moldovan/ayuno/data/FastingStorage.kt): `app/src/main/java/com/moldovan/ayuno/data/FastingStorage.kt`
- [Contextual messages](https://github.com/horatiumol/ayuno/blob/master/app/src/main/java/com/moldovan/ayuno/data/ContextualMessages.kt): `app/src/main/java/com/moldovan/ayuno/data/ContextualMessages.kt`
- [Achievements](https://github.com/horatiumol/ayuno/blob/master/app/src/main/java/com/moldovan/ayuno/data/Achievement.kt): `app/src/main/java/com/moldovan/ayuno/data/Achievement.kt`

### Personal tracking

- [Hydration log](https://github.com/horatiumol/ayuno/blob/master/app/src/main/java/com/moldovan/ayuno/data/HydrationStorage.kt): `app/src/main/java/com/moldovan/ayuno/data/HydrationStorage.kt`
- [Weight log](https://github.com/horatiumol/ayuno/blob/master/app/src/main/java/com/moldovan/ayuno/data/WeightStorage.kt): `app/src/main/java/com/moldovan/ayuno/data/WeightStorage.kt`
- [Backup export](https://github.com/horatiumol/ayuno/blob/master/app/src/main/java/com/moldovan/ayuno/data/BackupHelper.kt): `app/src/main/java/com/moldovan/ayuno/data/BackupHelper.kt`
- [Fast sharing](https://github.com/horatiumol/ayuno/blob/master/app/src/main/java/com/moldovan/ayuno/data/ShareHelper.kt): `app/src/main/java/com/moldovan/ayuno/data/ShareHelper.kt`

### Android integrations

- [Phase notifications](https://github.com/horatiumol/ayuno/blob/master/app/src/main/java/com/moldovan/ayuno/data/NotificationHelper.kt): `app/src/main/java/com/moldovan/ayuno/data/NotificationHelper.kt`
- [Notification worker](https://github.com/horatiumol/ayuno/blob/master/app/src/main/java/com/moldovan/ayuno/data/PhaseNotificationWorker.kt): `app/src/main/java/com/moldovan/ayuno/data/PhaseNotificationWorker.kt`
- [Fasting widget](https://github.com/horatiumol/ayuno/blob/master/app/src/main/java/com/moldovan/ayuno/widget/FastingWidgetProvider.kt): `app/src/main/java/com/moldovan/ayuno/widget/FastingWidgetProvider.kt`
- [Widget refresh](https://github.com/horatiumol/ayuno/blob/master/app/src/main/java/com/moldovan/ayuno/widget/WidgetTickWorker.kt): `app/src/main/java/com/moldovan/ayuno/widget/WidgetTickWorker.kt`

### Other components

- **User**
- **Android preferences**

## Connections

- User → App screens: uses
- App screens → UI components: renders (evidence: `app/src/main/java/com/moldovan/ayuno/MainActivity.kt`)
- App screens → Session history: manages sessions (evidence: `app/src/main/java/com/moldovan/ayuno/MainActivity.kt`)
- App screens → Fasting plans: starts planned fast (evidence: `app/src/main/java/com/moldovan/ayuno/MainActivity.kt`)
- App screens → Weight log: provides log (evidence: `app/src/main/java/com/moldovan/ayuno/MainActivity.kt`)
- App screens → Hydration log: provides log (evidence: `app/src/main/java/com/moldovan/ayuno/MainActivity.kt`)
- App screens → Theme settings: loads preference (evidence: `app/src/main/java/com/moldovan/ayuno/MainActivity.kt`)
- App screens → Phase notifications: sets up channel (evidence: `app/src/main/java/com/moldovan/ayuno/MainActivity.kt`)
- App screens → Backup export: exports backup (evidence: `app/src/main/java/com/moldovan/ayuno/MainActivity.kt`)
- App screens → Fast sharing: shares session (evidence: `app/src/main/java/com/moldovan/ayuno/MainActivity.kt`)
- UI components → Session history: reads session data (evidence: `app/src/main/java/com/moldovan/ayuno/Components.kt`)
- UI components → Fasting phases: shows phase data (evidence: `app/src/main/java/com/moldovan/ayuno/Components.kt`)
- UI components → Fasting plans: shows plan choices (evidence: `app/src/main/java/com/moldovan/ayuno/Components.kt`)
- Session history → Notification worker: schedules phases (evidence: `app/src/main/java/com/moldovan/ayuno/data/FastingStorage.kt`)
- Notification worker → Session history: checks active fast (evidence: `app/src/main/java/com/moldovan/ayuno/data/PhaseNotificationWorker.kt`)
- Notification worker → Phase notifications: shows alert (evidence: `app/src/main/java/com/moldovan/ayuno/data/PhaseNotificationWorker.kt`)
- Session history → Widget refresh: starts refresh (evidence: `app/src/main/java/com/moldovan/ayuno/data/FastingStorage.kt`)
- Widget refresh → Session history: checks active fast (evidence: `app/src/main/java/com/moldovan/ayuno/widget/WidgetTickWorker.kt`)
- Widget refresh → Fasting widget: refreshes widget (evidence: `app/src/main/java/com/moldovan/ayuno/widget/WidgetTickWorker.kt`)
- Fasting widget → Session history: reads and ends fast (evidence: `app/src/main/java/com/moldovan/ayuno/widget/FastingWidgetProvider.kt`)
- Fasting widget → Hydration log: adds water (evidence: `app/src/main/java/com/moldovan/ayuno/widget/FastingWidgetProvider.kt`)
- Fasting widget → App screens: opens app (evidence: `app/src/main/java/com/moldovan/ayuno/widget/FastingWidgetProvider.kt`)
- Backup export → Session history: backs up sessions (evidence: `app/src/main/java/com/moldovan/ayuno/data/BackupHelper.kt`)
- Backup export → Weight log: backs up weights (evidence: `app/src/main/java/com/moldovan/ayuno/data/BackupHelper.kt`)
- Backup export → Hydration log: backs up hydration (evidence: `app/src/main/java/com/moldovan/ayuno/data/BackupHelper.kt`)
- Backup export → Theme settings: backs up theme (evidence: `app/src/main/java/com/moldovan/ayuno/data/BackupHelper.kt`)
- Session history → Android preferences: persists sessions (evidence: `app/src/main/java/com/moldovan/ayuno/data/FastingStorage.kt`)
- Hydration log → Android preferences: persists entries (evidence: `app/src/main/java/com/moldovan/ayuno/data/HydrationStorage.kt`)
- Weight log → Android preferences: persists entries (evidence: `app/src/main/java/com/moldovan/ayuno/data/WeightStorage.kt`)
