# igorescodro/alkaa architecture

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

- Interactive diagram: https://gitdiagram.com/igorescodro/alkaa
- Repository: https://github.com/igorescodro/alkaa

## Overview

Alkaa is a multiplatform to-do app. Its central workflow is managing tasks and categories, with domain use cases mediating between feature presentation and repository-backed local data. Separate capabilities include task search and completion tracking, preferences, alarms/notifications, and an Android task-list widget. The tree and README establish these subsystems and the hexagonal layering; only search, navigation-event handling, and permission implementations were sampled, so other wiring is shown only where module responsibilities support it.

Main entry points: [`data/local/src/commonMain/kotlin/com/escodro/local/datasource`](https://github.com/igorescodro/alkaa/tree/main/data/local/src/commonMain/kotlin/com/escodro/local/datasource) (Local data sources), [`domain/src/commonMain/kotlin/com/escodro/domain/usecase/task`](https://github.com/igorescodro/alkaa/tree/main/domain/src/commonMain/kotlin/com/escodro/domain/usecase/task) (Task use cases), [`data/repository/src/commonMain/kotlin/com/escodro/repository/TaskRepositoryImpl.kt`](https://github.com/igorescodro/alkaa/blob/main/data/repository/src/commonMain/kotlin/com/escodro/repository/TaskRepositoryImpl.kt) (Task repositories), [`domain/src/commonMain/kotlin/com/escodro/domain/usecase/alarm`](https://github.com/igorescodro/alkaa/tree/main/domain/src/commonMain/kotlin/com/escodro/domain/usecase/alarm) (Alarm use cases)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_presentation["App and features"]
  node_app["App entry<br/>[AlkaaApp.kt]"]
  node_home["Home screen<br/>[HomeScreen.kt]"]
  node_category_ui["Category UI"]
  node_preference_ui["Preferences UI"]
  node_search_ui["Search mapping"]
end

subgraph group_domain["Domain logic"]
  node_task_domain["Task use cases"]
  node_category_domain["Category use cases"]
  node_search_domain["Search use case"]
  node_tracker_domain["Completion tracker"]
  node_alarm_domain["Alarm use cases"]
  node_glance_domain["Widget interactor"]
end

subgraph group_data["Data access"]
  node_task_repo["Task repositories"]
  node_category_repo["Category repository"]
  node_search_repo["Search repository"]
  node_local_data["Local data sources"]
  node_database[("SQLDelight database")]
  node_preferences[("Preference storage")]
end

subgraph group_platform["Platform services"]
  node_alarm_service["Alarm integration"]
  node_notifications["Notifications"]
  node_glance_widget["Android widget"]
end

subgraph group_navigation["Navigation"]
  node_nav["Navigation controller"]
  node_nav_api["Navigation contracts"]
end

node_user(("App user"))
node_notification_system{{"Platform notifications"}}

node_user -->|"opens"| node_app
node_user -->|"uses"| node_home
node_home -->|"manages tasks"| node_task_domain
node_category_ui -->|"manages categories"| node_category_domain
node_preference_ui -->|"updates settings"| node_preferences
node_search_domain -->|"searches tasks"| node_search_repo
node_search_repo -->|"queries"| node_local_data
node_search_ui -->|"presents results"| node_search_domain
node_task_domain -->|"reads and writes"| node_task_repo
node_category_domain -->|"reads and writes"| node_category_repo
node_task_repo -->|"accesses"| node_local_data
node_category_repo -->|"accesses"| node_local_data
node_local_data -->|"reads and writes"| node_database
node_tracker_domain -->|"loads completion data"| node_task_repo
node_alarm_domain -->|"schedules alarms"| node_alarm_service
node_alarm_domain -->|"dispatches reminders"| node_notifications
node_notifications -->|"sends"| node_notification_system
node_glance_domain -.->|"provides task data"| node_glance_widget
node_glance_widget -.->|"updates status"| node_task_domain
node_nav -->|"publishes destinations"| node_nav_api

click node_app "https://github.com/igorescodro/alkaa/blob/main/app/src/main/java/com/escodro/alkaa/AlkaaApp.kt"
click node_home "https://github.com/igorescodro/alkaa/blob/main/features/home/src/commonMain/kotlin/com/escodro/home/presentation/HomeScreen.kt"
click node_category_ui "https://github.com/igorescodro/alkaa/tree/main/features/category/src/commonMain/kotlin/com/escodro/category"
click node_preference_ui "https://github.com/igorescodro/alkaa/tree/main/features/preference/src/commonMain/kotlin/com/escodro/preference/presentation"
click node_search_ui "https://github.com/igorescodro/alkaa/blob/main/features/search/src/commonMain/kotlin/com/escodro/search/mapper/TaskSearchMapper.kt"
click node_task_domain "https://github.com/igorescodro/alkaa/tree/main/domain/src/commonMain/kotlin/com/escodro/domain/usecase/task"
click node_category_domain "https://github.com/igorescodro/alkaa/tree/main/domain/src/commonMain/kotlin/com/escodro/domain/usecase/category"
click node_search_domain "https://github.com/igorescodro/alkaa/tree/main/domain/src/commonMain/kotlin/com/escodro/domain/usecase/search"
click node_tracker_domain "https://github.com/igorescodro/alkaa/tree/main/domain/src/commonMain/kotlin/com/escodro/domain/usecase/tracker"
click node_alarm_domain "https://github.com/igorescodro/alkaa/tree/main/domain/src/commonMain/kotlin/com/escodro/domain/usecase/alarm"
click node_glance_domain "https://github.com/igorescodro/alkaa/blob/main/domain/src/commonMain/kotlin/com/escodro/domain/interactor/GlanceInteractor.kt"
click node_task_repo "https://github.com/igorescodro/alkaa/blob/main/data/repository/src/commonMain/kotlin/com/escodro/repository/TaskRepositoryImpl.kt"
click node_category_repo "https://github.com/igorescodro/alkaa/blob/main/data/repository/src/commonMain/kotlin/com/escodro/repository/CategoryRepositoryImpl.kt"
click node_search_repo "https://github.com/igorescodro/alkaa/blob/main/data/repository/src/commonMain/kotlin/com/escodro/repository/SearchRepositoryImpl.kt"
click node_local_data "https://github.com/igorescodro/alkaa/tree/main/data/local/src/commonMain/kotlin/com/escodro/local/datasource"
click node_database "https://github.com/igorescodro/alkaa/blob/main/data/local/src/commonMain/kotlin/com/escodro/local/provider/DatabaseProvider.kt"
click node_preferences "https://github.com/igorescodro/alkaa/blob/main/data/datastore/src/commonMain/kotlin/com/escodro/datastore/datasource/PreferencesDataSourceImpl.kt"
click node_nav "https://github.com/igorescodro/alkaa/blob/main/features/navigation/src/commonMain/kotlin/com/escodro/navigation/controller/NavEventControllerImpl.kt"
click node_nav_api "https://github.com/igorescodro/alkaa/tree/main/features/navigation-api/src/commonMain/kotlin/com/escodro/navigationapi"
click node_alarm_service "https://github.com/igorescodro/alkaa/blob/main/features/alarm/src/commonMain/kotlin/com/escodro/alarm/interactor/AlarmInteractorImpl.kt"
click node_notifications "https://github.com/igorescodro/alkaa/blob/main/features/alarm/src/commonMain/kotlin/com/escodro/alarm/interactor/NotificationInteractorImpl.kt"
click node_glance_widget "https://github.com/igorescodro/alkaa/blob/main/features/glance/src/androidMain/kotlin/com/escodro/glance/presentation/TaskListGlanceWidget.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_app,node_home,node_category_ui,node_preference_ui,node_search_ui,node_user toneBlue
class node_task_domain,node_category_domain,node_search_domain,node_tracker_domain,node_alarm_domain,node_glance_domain toneAmber
class node_task_repo,node_category_repo,node_search_repo,node_local_data,node_database,node_preferences toneMint
class node_alarm_service,node_notifications,node_glance_widget toneRose
class node_nav,node_nav_api,node_notification_system toneIndigo
```

## Components

### App and features

- [App entry](https://github.com/igorescodro/alkaa/blob/main/app/src/main/java/com/escodro/alkaa/AlkaaApp.kt): `app/src/main/java/com/escodro/alkaa/AlkaaApp.kt`
- [Home screen](https://github.com/igorescodro/alkaa/blob/main/features/home/src/commonMain/kotlin/com/escodro/home/presentation/HomeScreen.kt): `features/home/src/commonMain/kotlin/com/escodro/home/presentation/HomeScreen.kt`
- [Category UI](https://github.com/igorescodro/alkaa/tree/main/features/category/src/commonMain/kotlin/com/escodro/category): `features/category/src/commonMain/kotlin/com/escodro/category`
- [Preferences UI](https://github.com/igorescodro/alkaa/tree/main/features/preference/src/commonMain/kotlin/com/escodro/preference/presentation): `features/preference/src/commonMain/kotlin/com/escodro/preference/presentation`
- [Search mapping](https://github.com/igorescodro/alkaa/blob/main/features/search/src/commonMain/kotlin/com/escodro/search/mapper/TaskSearchMapper.kt): `features/search/src/commonMain/kotlin/com/escodro/search/mapper/TaskSearchMapper.kt`

### Domain logic

- [Task use cases](https://github.com/igorescodro/alkaa/tree/main/domain/src/commonMain/kotlin/com/escodro/domain/usecase/task): `domain/src/commonMain/kotlin/com/escodro/domain/usecase/task`
- [Category use cases](https://github.com/igorescodro/alkaa/tree/main/domain/src/commonMain/kotlin/com/escodro/domain/usecase/category): `domain/src/commonMain/kotlin/com/escodro/domain/usecase/category`
- [Search use case](https://github.com/igorescodro/alkaa/tree/main/domain/src/commonMain/kotlin/com/escodro/domain/usecase/search): `domain/src/commonMain/kotlin/com/escodro/domain/usecase/search`
- [Completion tracker](https://github.com/igorescodro/alkaa/tree/main/domain/src/commonMain/kotlin/com/escodro/domain/usecase/tracker): `domain/src/commonMain/kotlin/com/escodro/domain/usecase/tracker`
- [Alarm use cases](https://github.com/igorescodro/alkaa/tree/main/domain/src/commonMain/kotlin/com/escodro/domain/usecase/alarm): `domain/src/commonMain/kotlin/com/escodro/domain/usecase/alarm`
- [Widget interactor](https://github.com/igorescodro/alkaa/blob/main/domain/src/commonMain/kotlin/com/escodro/domain/interactor/GlanceInteractor.kt): `domain/src/commonMain/kotlin/com/escodro/domain/interactor/GlanceInteractor.kt`

### Data access

- [Task repositories](https://github.com/igorescodro/alkaa/blob/main/data/repository/src/commonMain/kotlin/com/escodro/repository/TaskRepositoryImpl.kt): `data/repository/src/commonMain/kotlin/com/escodro/repository/TaskRepositoryImpl.kt`
- [Category repository](https://github.com/igorescodro/alkaa/blob/main/data/repository/src/commonMain/kotlin/com/escodro/repository/CategoryRepositoryImpl.kt): `data/repository/src/commonMain/kotlin/com/escodro/repository/CategoryRepositoryImpl.kt`
- [Search repository](https://github.com/igorescodro/alkaa/blob/main/data/repository/src/commonMain/kotlin/com/escodro/repository/SearchRepositoryImpl.kt): `data/repository/src/commonMain/kotlin/com/escodro/repository/SearchRepositoryImpl.kt`
- [Local data sources](https://github.com/igorescodro/alkaa/tree/main/data/local/src/commonMain/kotlin/com/escodro/local/datasource): `data/local/src/commonMain/kotlin/com/escodro/local/datasource`
- [SQLDelight database](https://github.com/igorescodro/alkaa/blob/main/data/local/src/commonMain/kotlin/com/escodro/local/provider/DatabaseProvider.kt): `data/local/src/commonMain/kotlin/com/escodro/local/provider/DatabaseProvider.kt`
- [Preference storage](https://github.com/igorescodro/alkaa/blob/main/data/datastore/src/commonMain/kotlin/com/escodro/datastore/datasource/PreferencesDataSourceImpl.kt): `data/datastore/src/commonMain/kotlin/com/escodro/datastore/datasource/PreferencesDataSourceImpl.kt`

### Platform services

- [Alarm integration](https://github.com/igorescodro/alkaa/blob/main/features/alarm/src/commonMain/kotlin/com/escodro/alarm/interactor/AlarmInteractorImpl.kt): `features/alarm/src/commonMain/kotlin/com/escodro/alarm/interactor/AlarmInteractorImpl.kt`
- [Notifications](https://github.com/igorescodro/alkaa/blob/main/features/alarm/src/commonMain/kotlin/com/escodro/alarm/interactor/NotificationInteractorImpl.kt): `features/alarm/src/commonMain/kotlin/com/escodro/alarm/interactor/NotificationInteractorImpl.kt`
- [Android widget](https://github.com/igorescodro/alkaa/blob/main/features/glance/src/androidMain/kotlin/com/escodro/glance/presentation/TaskListGlanceWidget.kt): `features/glance/src/androidMain/kotlin/com/escodro/glance/presentation/TaskListGlanceWidget.kt`

### Navigation

- [Navigation controller](https://github.com/igorescodro/alkaa/blob/main/features/navigation/src/commonMain/kotlin/com/escodro/navigation/controller/NavEventControllerImpl.kt): `features/navigation/src/commonMain/kotlin/com/escodro/navigation/controller/NavEventControllerImpl.kt`
- [Navigation contracts](https://github.com/igorescodro/alkaa/tree/main/features/navigation-api/src/commonMain/kotlin/com/escodro/navigationapi): `features/navigation-api/src/commonMain/kotlin/com/escodro/navigationapi`

### Other components

- **App user**
- **Platform notifications**

## Connections

- App user → App entry: opens
- App user → Home screen: uses
- Home screen → Task use cases: manages tasks
- Category UI → Category use cases: manages categories
- Preferences UI → Preference storage: updates settings
- Search use case → Search repository: searches tasks
- Search repository → Local data sources: queries
- Search mapping → Search use case: presents results
- Task use cases → Task repositories: reads and writes
- Category use cases → Category repository: reads and writes
- Task repositories → Local data sources: accesses
- Category repository → Local data sources: accesses
- Local data sources → SQLDelight database: reads and writes
- Completion tracker → Task repositories: loads completion data
- Alarm use cases → Alarm integration: schedules alarms
- Alarm use cases → Notifications: dispatches reminders
- Notifications → Platform notifications: sends
- Widget interactor → Android widget: provides task data
- Android widget → Task use cases: updates status
- Navigation controller → Navigation contracts: publishes destinations
