# nasstyfox/trackflow architecture

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

- Interactive diagram: https://gitdiagram.com/nasstyfox/trackflow
- Repository: https://github.com/nasstyfox/trackflow

## Overview

TrackFlow appears to be an Android menstrual-cycle and period-tracking app: users can view a home screen, calendar and history, log daily information, and inspect statistics. Its apparent internal structure separates Compose screens, a ViewModel, a repository and Room persistence for period, symptom, mood and note records. These capabilities are inferred from filenames only; no application source or README was provided, so relationships are shown as unverified rather than asserted.

Main entry points: [`Trackflow-master/app/src/main/java/com/example/trackflow/ui/PeriodViewModel.kt`](https://github.com/nasstyfox/trackflow/blob/master/Trackflow-master/app/src/main/java/com/example/trackflow/ui/PeriodViewModel.kt) (Period ViewModel), [`Trackflow-master/app/src/main/java/com/example/trackflow/data/PeriodDatabase.kt`](https://github.com/nasstyfox/trackflow/blob/master/Trackflow-master/app/src/main/java/com/example/trackflow/data/PeriodDatabase.kt) (Room database), [`Trackflow-master/app/src/main/java/com/example/trackflow/data/PeriodDao.kt`](https://github.com/nasstyfox/trackflow/blob/master/Trackflow-master/app/src/main/java/com/example/trackflow/data/PeriodDao.kt) (Period access), [`Trackflow-master/app/src/main/java/com/example/trackflow/MainActivity.kt`](https://github.com/nasstyfox/trackflow/blob/master/Trackflow-master/app/src/main/java/com/example/trackflow/MainActivity.kt) (App entry)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_experience["Tracking screens"]
  node_main_activity["App entry<br/>[MainActivity.kt]"]
  node_home["Home screen<br/>[HomeScreen.kt]"]
  node_calendar["Calendar screen<br/>[CalendarScreen.kt]"]
  node_daily_log["Daily log<br/>[DailyLogScreen.kt]"]
  node_history["History screen<br/>[HistoryScreen.kt]"]
  node_statistics["Statistics screen"]
  node_period_dialog["Period editor"]
end

subgraph group_app_logic["Application logic"]
  node_view_model["Period ViewModel<br/>[PeriodViewModel.kt]"]
  node_view_model_factory["ViewModel factory"]
  node_repository["Period repository"]
end

subgraph group_storage["Local persistence"]
  node_database[("Room database<br/>[PeriodDatabase.kt]")]
  node_period_dao["Period access<br/>[PeriodDao.kt]"]
  node_symptom_dao["Symptom access<br/>[SymptomDao.kt]"]
  node_mood_dao["Mood access<br/>[MoodDao.kt]"]
  node_note_dao["Note access<br/>[NoteDao.kt]"]
  node_converters["Room converters<br/>[Converters.kt]"]
end

subgraph group_records["Tracking records"]
  node_period_entry["Period record<br/>[PeriodEntry.kt]"]
  node_symptom_entry["Symptom record<br/>[SymptomEntry.kt]"]
  node_mood_entry["Mood record<br/>[MoodEntry.kt]"]
  node_note_entry["Note record<br/>[NoteEntry.kt]"]
end

node_user(("User"))

node_user -.->|"opens"| node_main_activity
node_main_activity -.->|"shows"| node_home
node_home -.->|"uses"| node_view_model
node_calendar -.->|"uses"| node_view_model
node_daily_log -.->|"uses"| node_view_model
node_history -.->|"uses"| node_view_model
node_statistics -.->|"uses"| node_view_model
node_period_dialog -.->|"uses"| node_view_model
node_view_model_factory -.->|"creates"| node_view_model
node_view_model -.->|"delegates"| node_repository
node_repository -.->|"accesses"| node_period_dao
node_database -.->|"provides"| node_period_dao
node_database -.->|"provides"| node_symptom_dao
node_database -.->|"provides"| node_mood_dao
node_database -.->|"provides"| node_note_dao
node_period_dao -.->|"stores"| node_period_entry
node_symptom_dao -.->|"stores"| node_symptom_entry
node_mood_dao -.->|"stores"| node_mood_entry
node_note_dao -.->|"stores"| node_note_entry
node_database -.->|"uses"| node_converters

click node_main_activity "https://github.com/nasstyfox/trackflow/blob/master/Trackflow-master/app/src/main/java/com/example/trackflow/MainActivity.kt"
click node_home "https://github.com/nasstyfox/trackflow/blob/master/Trackflow-master/app/src/main/java/com/example/trackflow/ui/HomeScreen.kt"
click node_calendar "https://github.com/nasstyfox/trackflow/blob/master/Trackflow-master/app/src/main/java/com/example/trackflow/ui/CalendarScreen.kt"
click node_daily_log "https://github.com/nasstyfox/trackflow/blob/master/Trackflow-master/app/src/main/java/com/example/trackflow/ui/DailyLogScreen.kt"
click node_history "https://github.com/nasstyfox/trackflow/blob/master/Trackflow-master/app/src/main/java/com/example/trackflow/ui/HistoryScreen.kt"
click node_statistics "https://github.com/nasstyfox/trackflow/blob/master/Trackflow-master/app/src/main/java/com/example/trackflow/ui/StatisticsScreen.kt"
click node_period_dialog "https://github.com/nasstyfox/trackflow/blob/master/Trackflow-master/app/src/main/java/com/example/trackflow/ui/AddEditPeriodDialog.kt"
click node_view_model "https://github.com/nasstyfox/trackflow/blob/master/Trackflow-master/app/src/main/java/com/example/trackflow/ui/PeriodViewModel.kt"
click node_view_model_factory "https://github.com/nasstyfox/trackflow/blob/master/Trackflow-master/app/src/main/java/com/example/trackflow/ui/PeriodViewModelFactory.kt"
click node_repository "https://github.com/nasstyfox/trackflow/blob/master/Trackflow-master/app/src/main/java/com/example/trackflow/data/PeriodRepository.kt"
click node_database "https://github.com/nasstyfox/trackflow/blob/master/Trackflow-master/app/src/main/java/com/example/trackflow/data/PeriodDatabase.kt"
click node_period_dao "https://github.com/nasstyfox/trackflow/blob/master/Trackflow-master/app/src/main/java/com/example/trackflow/data/PeriodDao.kt"
click node_symptom_dao "https://github.com/nasstyfox/trackflow/blob/master/Trackflow-master/app/src/main/java/com/example/trackflow/data/SymptomDao.kt"
click node_mood_dao "https://github.com/nasstyfox/trackflow/blob/master/Trackflow-master/app/src/main/java/com/example/trackflow/data/MoodDao.kt"
click node_note_dao "https://github.com/nasstyfox/trackflow/blob/master/Trackflow-master/app/src/main/java/com/example/trackflow/data/NoteDao.kt"
click node_period_entry "https://github.com/nasstyfox/trackflow/blob/master/Trackflow-master/app/src/main/java/com/example/trackflow/data/PeriodEntry.kt"
click node_symptom_entry "https://github.com/nasstyfox/trackflow/blob/master/Trackflow-master/app/src/main/java/com/example/trackflow/data/SymptomEntry.kt"
click node_mood_entry "https://github.com/nasstyfox/trackflow/blob/master/Trackflow-master/app/src/main/java/com/example/trackflow/data/MoodEntry.kt"
click node_note_entry "https://github.com/nasstyfox/trackflow/blob/master/Trackflow-master/app/src/main/java/com/example/trackflow/data/NoteEntry.kt"
click node_converters "https://github.com/nasstyfox/trackflow/blob/master/Trackflow-master/app/src/main/java/com/example/trackflow/data/Converters.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_activity,node_home,node_calendar,node_daily_log,node_history,node_statistics,node_period_dialog,node_user toneBlue
class node_view_model,node_view_model_factory,node_repository toneAmber
class node_database,node_period_dao,node_symptom_dao,node_mood_dao,node_note_dao,node_converters toneMint
class node_period_entry,node_symptom_entry,node_mood_entry,node_note_entry toneRose
```

## Components

### Tracking screens

- [App entry](https://github.com/nasstyfox/trackflow/blob/master/Trackflow-master/app/src/main/java/com/example/trackflow/MainActivity.kt): `Trackflow-master/app/src/main/java/com/example/trackflow/MainActivity.kt`
- [Home screen](https://github.com/nasstyfox/trackflow/blob/master/Trackflow-master/app/src/main/java/com/example/trackflow/ui/HomeScreen.kt): `Trackflow-master/app/src/main/java/com/example/trackflow/ui/HomeScreen.kt`
- [Calendar screen](https://github.com/nasstyfox/trackflow/blob/master/Trackflow-master/app/src/main/java/com/example/trackflow/ui/CalendarScreen.kt): `Trackflow-master/app/src/main/java/com/example/trackflow/ui/CalendarScreen.kt`
- [Daily log](https://github.com/nasstyfox/trackflow/blob/master/Trackflow-master/app/src/main/java/com/example/trackflow/ui/DailyLogScreen.kt): `Trackflow-master/app/src/main/java/com/example/trackflow/ui/DailyLogScreen.kt`
- [History screen](https://github.com/nasstyfox/trackflow/blob/master/Trackflow-master/app/src/main/java/com/example/trackflow/ui/HistoryScreen.kt): `Trackflow-master/app/src/main/java/com/example/trackflow/ui/HistoryScreen.kt`
- [Statistics screen](https://github.com/nasstyfox/trackflow/blob/master/Trackflow-master/app/src/main/java/com/example/trackflow/ui/StatisticsScreen.kt): `Trackflow-master/app/src/main/java/com/example/trackflow/ui/StatisticsScreen.kt`
- [Period editor](https://github.com/nasstyfox/trackflow/blob/master/Trackflow-master/app/src/main/java/com/example/trackflow/ui/AddEditPeriodDialog.kt): `Trackflow-master/app/src/main/java/com/example/trackflow/ui/AddEditPeriodDialog.kt`

### Application logic

- [Period ViewModel](https://github.com/nasstyfox/trackflow/blob/master/Trackflow-master/app/src/main/java/com/example/trackflow/ui/PeriodViewModel.kt): `Trackflow-master/app/src/main/java/com/example/trackflow/ui/PeriodViewModel.kt`
- [ViewModel factory](https://github.com/nasstyfox/trackflow/blob/master/Trackflow-master/app/src/main/java/com/example/trackflow/ui/PeriodViewModelFactory.kt): `Trackflow-master/app/src/main/java/com/example/trackflow/ui/PeriodViewModelFactory.kt`
- [Period repository](https://github.com/nasstyfox/trackflow/blob/master/Trackflow-master/app/src/main/java/com/example/trackflow/data/PeriodRepository.kt): `Trackflow-master/app/src/main/java/com/example/trackflow/data/PeriodRepository.kt`

### Local persistence

- [Room database](https://github.com/nasstyfox/trackflow/blob/master/Trackflow-master/app/src/main/java/com/example/trackflow/data/PeriodDatabase.kt): `Trackflow-master/app/src/main/java/com/example/trackflow/data/PeriodDatabase.kt`
- [Period access](https://github.com/nasstyfox/trackflow/blob/master/Trackflow-master/app/src/main/java/com/example/trackflow/data/PeriodDao.kt): `Trackflow-master/app/src/main/java/com/example/trackflow/data/PeriodDao.kt`
- [Symptom access](https://github.com/nasstyfox/trackflow/blob/master/Trackflow-master/app/src/main/java/com/example/trackflow/data/SymptomDao.kt): `Trackflow-master/app/src/main/java/com/example/trackflow/data/SymptomDao.kt`
- [Mood access](https://github.com/nasstyfox/trackflow/blob/master/Trackflow-master/app/src/main/java/com/example/trackflow/data/MoodDao.kt): `Trackflow-master/app/src/main/java/com/example/trackflow/data/MoodDao.kt`
- [Note access](https://github.com/nasstyfox/trackflow/blob/master/Trackflow-master/app/src/main/java/com/example/trackflow/data/NoteDao.kt): `Trackflow-master/app/src/main/java/com/example/trackflow/data/NoteDao.kt`
- [Room converters](https://github.com/nasstyfox/trackflow/blob/master/Trackflow-master/app/src/main/java/com/example/trackflow/data/Converters.kt): `Trackflow-master/app/src/main/java/com/example/trackflow/data/Converters.kt`

### Tracking records

- [Period record](https://github.com/nasstyfox/trackflow/blob/master/Trackflow-master/app/src/main/java/com/example/trackflow/data/PeriodEntry.kt): `Trackflow-master/app/src/main/java/com/example/trackflow/data/PeriodEntry.kt`
- [Symptom record](https://github.com/nasstyfox/trackflow/blob/master/Trackflow-master/app/src/main/java/com/example/trackflow/data/SymptomEntry.kt): `Trackflow-master/app/src/main/java/com/example/trackflow/data/SymptomEntry.kt`
- [Mood record](https://github.com/nasstyfox/trackflow/blob/master/Trackflow-master/app/src/main/java/com/example/trackflow/data/MoodEntry.kt): `Trackflow-master/app/src/main/java/com/example/trackflow/data/MoodEntry.kt`
- [Note record](https://github.com/nasstyfox/trackflow/blob/master/Trackflow-master/app/src/main/java/com/example/trackflow/data/NoteEntry.kt): `Trackflow-master/app/src/main/java/com/example/trackflow/data/NoteEntry.kt`

### Other components

- **User**

## Connections

- User → App entry: opens
- App entry → Home screen: shows
- Home screen → Period ViewModel: uses
- Calendar screen → Period ViewModel: uses
- Daily log → Period ViewModel: uses
- History screen → Period ViewModel: uses
- Statistics screen → Period ViewModel: uses
- Period editor → Period ViewModel: uses
- ViewModel factory → Period ViewModel: creates
- Period ViewModel → Period repository: delegates
- Period repository → Period access: accesses
- Room database → Period access: provides
- Room database → Symptom access: provides
- Room database → Mood access: provides
- Room database → Note access: provides
- Period access → Period record: stores
- Symptom access → Symptom record: stores
- Mood access → Mood record: stores
- Note access → Note record: stores
- Room database → Room converters: uses
