How igorescodro/alkaa works
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: datasource Local data sources · task Task use cases · TaskRepositoryImpl.kt Task repositories · alarm Alarm use cases
Components 24
App and features
- App entry
app/src/main/java/com/escodro/alkaa/AlkaaApp.kt - Home screen
features/home/src/commonMain/kotlin/com/escodro/home/presentation/HomeScreen.kt - Category UI
features/category/src/commonMain/kotlin/com/escodro/category - Preferences UI
features/preference/src/commonMain/kotlin/com/escodro/preference/presentation - Search mapping
features/search/src/commonMain/kotlin/com/escodro/search/mapper/TaskSearchMapper.kt
Domain logic
- Task use cases
domain/src/commonMain/kotlin/com/escodro/domain/usecase/task - Category use cases
domain/src/commonMain/kotlin/com/escodro/domain/usecase/category - Search use case
domain/src/commonMain/kotlin/com/escodro/domain/usecase/search - Completion tracker
domain/src/commonMain/kotlin/com/escodro/domain/usecase/tracker - Alarm use cases
domain/src/commonMain/kotlin/com/escodro/domain/usecase/alarm - Widget interactor
domain/src/commonMain/kotlin/com/escodro/domain/interactor/GlanceInteractor.kt
Data access
- Task repositories
data/repository/src/commonMain/kotlin/com/escodro/repository/TaskRepositoryImpl.kt - Category repository
data/repository/src/commonMain/kotlin/com/escodro/repository/CategoryRepositoryImpl.kt - Search repository
data/repository/src/commonMain/kotlin/com/escodro/repository/SearchRepositoryImpl.kt - Local data sources
data/local/src/commonMain/kotlin/com/escodro/local/datasource - SQLDelight database
data/local/src/commonMain/kotlin/com/escodro/local/provider/DatabaseProvider.kt - Preference storage
data/datastore/src/commonMain/kotlin/com/escodro/datastore/datasource/PreferencesDataSourceImpl.kt
Platform services
- Alarm integration
features/alarm/src/commonMain/kotlin/com/escodro/alarm/interactor/AlarmInteractorImpl.kt - Notifications
features/alarm/src/commonMain/kotlin/com/escodro/alarm/interactor/NotificationInteractorImpl.kt - Android widget
features/glance/src/androidMain/kotlin/com/escodro/glance/presentation/TaskListGlanceWidget.kt
Navigation
- Navigation controller
features/navigation/src/commonMain/kotlin/com/escodro/navigation/controller/NavEventControllerImpl.kt - Navigation contracts
features/navigation-api/src/commonMain/kotlin/com/escodro/navigationapi
Other components
- App user
- Platform notifications
Connections 20
- 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