# iamshekhargh/todolistultimate architecture

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

- Interactive diagram: https://gitdiagram.com/iamshekhargh/todolistultimate
- Repository: https://github.com/iamshekhargh/todolistultimate

## Overview

TaskMaster is an offline-first Android task manager. Users create or edit tasks in the Compose interface, while ViewModels coordinate use cases, persistence, reminders, and widget refreshes; the home screen reflects the task list and completion state. Separate runtime branches provide a Glance widget, scheduled deadline reminders, and daily summaries with notifications. The graph follows the supplied source index and README for unsampled areas; dashed links mark relationships whose concrete calls were not shown.

Main entry points: [`app/src/main/java/com/shekhargh/todolistultimate/data/usecase`](https://github.com/iamshekhargh/todolistultimate/tree/main/app/src/main/java/com/shekhargh/todolistultimate/data/usecase) (Task use cases), [`app/src/main/java/com/shekhargh/todolistultimate/ui/viewModels/AddTaskViewModel.kt`](https://github.com/iamshekhargh/todolistultimate/blob/main/app/src/main/java/com/shekhargh/todolistultimate/ui/viewModels/AddTaskViewModel.kt) (Edit ViewModel), [`app/src/main/java/com/shekhargh/todolistultimate/ui/composables/MainScreen.kt`](https://github.com/iamshekhargh/todolistultimate/blob/main/app/src/main/java/com/shekhargh/todolistultimate/ui/composables/MainScreen.kt) (Task list screen), [`app/src/main/java/com/shekhargh/todolistultimate/ui/navigation/TopAppNavigation.kt`](https://github.com/iamshekhargh/todolistultimate/blob/main/app/src/main/java/com/shekhargh/todolistultimate/ui/navigation/TopAppNavigation.kt) (Compose navigation)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_presentation["Task interface"]
  node_activity["App entry<br/>[MainActivity.kt]"]
  node_navigation["Compose navigation"]
  node_task_list["Task list screen<br/>[MainScreen.kt]"]
  node_task_card["Task card<br/>[TodoItemCard.kt]"]
  node_main_vm["List ViewModel"]
  node_edit_screen["Add/edit screen<br/>[AddEditScreen.kt]"]
  node_edit_vm["Edit ViewModel"]
end

subgraph group_domain_data["Task rules and storage"]
  node_usecases["Task use cases"]
  node_repository["Task repository"]
  node_dao["Room DAO"]
  node_database[("Room database")]
  node_task_model["Task record<br/>[TodoTaskItem.kt]"]
end

subgraph group_widget["Home widget"]
  node_widget["Glance widget"]
  node_widget_updater["Widget updater"]
end

subgraph group_background["Background work"]
  node_scheduler["Reminder scheduler"]
  node_reminder_worker["Deadline reminder"]
  node_summary_worker["Daily summary"]
  node_notifier["Notification service"]
end

node_user(("User"))
node_external_os(("Android system"))

node_user -->|"opens app"| node_activity
node_activity -->|"starts"| node_navigation
node_navigation -->|"routes to"| node_task_list
node_navigation -->|"routes to"| node_edit_screen
node_user -.->|"manages tasks"| node_task_list
node_task_list -.->|"renders"| node_task_card
node_task_list -.->|"observes state"| node_main_vm
node_main_vm -.->|"requests tasks"| node_usecases
node_edit_screen -->|"uses"| node_edit_vm
node_edit_vm -->|"invokes"| node_usecases
node_usecases -.->|"delegates to"| node_repository
node_repository -->|"calls"| node_dao
node_database -->|"provides"| node_dao
node_dao -->|"reads and writes"| node_task_model
node_edit_vm -->|"schedules or cancels"| node_scheduler
node_scheduler -->|"enqueues"| node_reminder_worker
node_reminder_worker -->|"loads task"| node_usecases
node_reminder_worker -->|"requests alert"| node_notifier
node_summary_worker -->|"loads tasks"| node_usecases
node_summary_worker -->|"sends summary"| node_notifier
node_notifier -.->|"posts notification"| node_external_os
node_external_os -->|"hosts"| node_widget
node_widget -->|"loads task data"| node_usecases
node_edit_vm -->|"refreshes"| node_widget_updater
node_widget_updater -.->|"updates"| node_widget

click node_activity "https://github.com/iamshekhargh/todolistultimate/blob/main/app/src/main/java/com/shekhargh/todolistultimate/MainActivity.kt"
click node_navigation "https://github.com/iamshekhargh/todolistultimate/blob/main/app/src/main/java/com/shekhargh/todolistultimate/ui/navigation/TopAppNavigation.kt"
click node_task_list "https://github.com/iamshekhargh/todolistultimate/blob/main/app/src/main/java/com/shekhargh/todolistultimate/ui/composables/MainScreen.kt"
click node_task_card "https://github.com/iamshekhargh/todolistultimate/blob/main/app/src/main/java/com/shekhargh/todolistultimate/ui/composables/TodoItemCard.kt"
click node_main_vm "https://github.com/iamshekhargh/todolistultimate/blob/main/app/src/main/java/com/shekhargh/todolistultimate/ui/viewModels/MainTodoListViewModel.kt"
click node_edit_screen "https://github.com/iamshekhargh/todolistultimate/blob/main/app/src/main/java/com/shekhargh/todolistultimate/ui/composables/AddEditScreen.kt"
click node_edit_vm "https://github.com/iamshekhargh/todolistultimate/blob/main/app/src/main/java/com/shekhargh/todolistultimate/ui/viewModels/AddTaskViewModel.kt"
click node_usecases "https://github.com/iamshekhargh/todolistultimate/tree/main/app/src/main/java/com/shekhargh/todolistultimate/data/usecase"
click node_repository "https://github.com/iamshekhargh/todolistultimate/blob/main/app/src/main/java/com/shekhargh/todolistultimate/data/repository/TodoListUltimateRepositoryImpl.kt"
click node_dao "https://github.com/iamshekhargh/todolistultimate/blob/main/app/src/main/java/com/shekhargh/todolistultimate/data/TodoListUltimateDao.kt"
click node_database "https://github.com/iamshekhargh/todolistultimate/blob/main/app/src/main/java/com/shekhargh/todolistultimate/data/TodoListUltimateDatabase.kt"
click node_task_model "https://github.com/iamshekhargh/todolistultimate/blob/main/app/src/main/java/com/shekhargh/todolistultimate/data/TodoTaskItem.kt"
click node_scheduler "https://github.com/iamshekhargh/todolistultimate/blob/main/app/src/main/java/com/shekhargh/todolistultimate/data/WorkManagerTaskSchedular.kt"
click node_reminder_worker "https://github.com/iamshekhargh/todolistultimate/blob/main/app/src/main/java/com/shekhargh/todolistultimate/worker/TaskReminderWorker.kt"
click node_summary_worker "https://github.com/iamshekhargh/todolistultimate/blob/main/app/src/main/java/com/shekhargh/todolistultimate/worker/DailySummaryWorker.kt"
click node_notifier "https://github.com/iamshekhargh/todolistultimate/blob/main/app/src/main/java/com/shekhargh/todolistultimate/worker/notification/TaskNotifierImpl.kt"
click node_widget "https://github.com/iamshekhargh/todolistultimate/blob/main/app/src/main/java/com/shekhargh/todolistultimate/widget/TodoListUltimateWidget.kt"
click node_widget_updater "https://github.com/iamshekhargh/todolistultimate/blob/main/app/src/main/java/com/shekhargh/todolistultimate/widget/WidgetUpdaterImpl.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_activity,node_navigation,node_task_list,node_task_card,node_main_vm,node_edit_screen,node_edit_vm,node_user toneBlue
class node_usecases,node_repository,node_dao,node_database,node_task_model toneAmber
class node_widget,node_widget_updater toneMint
class node_scheduler,node_reminder_worker,node_summary_worker,node_notifier toneRose
class node_external_os toneIndigo
```

## Components

### Task interface

- [App entry](https://github.com/iamshekhargh/todolistultimate/blob/main/app/src/main/java/com/shekhargh/todolistultimate/MainActivity.kt): `app/src/main/java/com/shekhargh/todolistultimate/MainActivity.kt`
- [Compose navigation](https://github.com/iamshekhargh/todolistultimate/blob/main/app/src/main/java/com/shekhargh/todolistultimate/ui/navigation/TopAppNavigation.kt): `app/src/main/java/com/shekhargh/todolistultimate/ui/navigation/TopAppNavigation.kt`
- [Task list screen](https://github.com/iamshekhargh/todolistultimate/blob/main/app/src/main/java/com/shekhargh/todolistultimate/ui/composables/MainScreen.kt): `app/src/main/java/com/shekhargh/todolistultimate/ui/composables/MainScreen.kt`
- [Task card](https://github.com/iamshekhargh/todolistultimate/blob/main/app/src/main/java/com/shekhargh/todolistultimate/ui/composables/TodoItemCard.kt): `app/src/main/java/com/shekhargh/todolistultimate/ui/composables/TodoItemCard.kt`
- [List ViewModel](https://github.com/iamshekhargh/todolistultimate/blob/main/app/src/main/java/com/shekhargh/todolistultimate/ui/viewModels/MainTodoListViewModel.kt): `app/src/main/java/com/shekhargh/todolistultimate/ui/viewModels/MainTodoListViewModel.kt`
- [Add/edit screen](https://github.com/iamshekhargh/todolistultimate/blob/main/app/src/main/java/com/shekhargh/todolistultimate/ui/composables/AddEditScreen.kt): `app/src/main/java/com/shekhargh/todolistultimate/ui/composables/AddEditScreen.kt`
- [Edit ViewModel](https://github.com/iamshekhargh/todolistultimate/blob/main/app/src/main/java/com/shekhargh/todolistultimate/ui/viewModels/AddTaskViewModel.kt): `app/src/main/java/com/shekhargh/todolistultimate/ui/viewModels/AddTaskViewModel.kt`

### Task rules and storage

- [Task use cases](https://github.com/iamshekhargh/todolistultimate/tree/main/app/src/main/java/com/shekhargh/todolistultimate/data/usecase): `app/src/main/java/com/shekhargh/todolistultimate/data/usecase`
- [Task repository](https://github.com/iamshekhargh/todolistultimate/blob/main/app/src/main/java/com/shekhargh/todolistultimate/data/repository/TodoListUltimateRepositoryImpl.kt): `app/src/main/java/com/shekhargh/todolistultimate/data/repository/TodoListUltimateRepositoryImpl.kt`
- [Room DAO](https://github.com/iamshekhargh/todolistultimate/blob/main/app/src/main/java/com/shekhargh/todolistultimate/data/TodoListUltimateDao.kt): `app/src/main/java/com/shekhargh/todolistultimate/data/TodoListUltimateDao.kt`
- [Room database](https://github.com/iamshekhargh/todolistultimate/blob/main/app/src/main/java/com/shekhargh/todolistultimate/data/TodoListUltimateDatabase.kt): `app/src/main/java/com/shekhargh/todolistultimate/data/TodoListUltimateDatabase.kt`
- [Task record](https://github.com/iamshekhargh/todolistultimate/blob/main/app/src/main/java/com/shekhargh/todolistultimate/data/TodoTaskItem.kt): `app/src/main/java/com/shekhargh/todolistultimate/data/TodoTaskItem.kt`

### Home widget

- [Glance widget](https://github.com/iamshekhargh/todolistultimate/blob/main/app/src/main/java/com/shekhargh/todolistultimate/widget/TodoListUltimateWidget.kt): `app/src/main/java/com/shekhargh/todolistultimate/widget/TodoListUltimateWidget.kt`
- [Widget updater](https://github.com/iamshekhargh/todolistultimate/blob/main/app/src/main/java/com/shekhargh/todolistultimate/widget/WidgetUpdaterImpl.kt): `app/src/main/java/com/shekhargh/todolistultimate/widget/WidgetUpdaterImpl.kt`

### Background work

- [Reminder scheduler](https://github.com/iamshekhargh/todolistultimate/blob/main/app/src/main/java/com/shekhargh/todolistultimate/data/WorkManagerTaskSchedular.kt): `app/src/main/java/com/shekhargh/todolistultimate/data/WorkManagerTaskSchedular.kt`
- [Deadline reminder](https://github.com/iamshekhargh/todolistultimate/blob/main/app/src/main/java/com/shekhargh/todolistultimate/worker/TaskReminderWorker.kt): `app/src/main/java/com/shekhargh/todolistultimate/worker/TaskReminderWorker.kt`
- [Daily summary](https://github.com/iamshekhargh/todolistultimate/blob/main/app/src/main/java/com/shekhargh/todolistultimate/worker/DailySummaryWorker.kt): `app/src/main/java/com/shekhargh/todolistultimate/worker/DailySummaryWorker.kt`
- [Notification service](https://github.com/iamshekhargh/todolistultimate/blob/main/app/src/main/java/com/shekhargh/todolistultimate/worker/notification/TaskNotifierImpl.kt): `app/src/main/java/com/shekhargh/todolistultimate/worker/notification/TaskNotifierImpl.kt`

### Other components

- **User**
- **Android system**

## Connections

- User → App entry: opens app
- App entry → Compose navigation: starts (evidence: `app/src/main/java/com/shekhargh/todolistultimate/MainActivity.kt`)
- Compose navigation → Task list screen: routes to (evidence: `app/src/main/java/com/shekhargh/todolistultimate/ui/navigation/TopAppNavigation.kt`)
- Compose navigation → Add/edit screen: routes to (evidence: `app/src/main/java/com/shekhargh/todolistultimate/ui/navigation/TopAppNavigation.kt`)
- User → Task list screen: manages tasks
- Task list screen → Task card: renders (evidence: `app/src/main/java/com/shekhargh/todolistultimate/ui/composables/MainScreen.kt`)
- Task list screen → List ViewModel: observes state (evidence: `app/src/main/java/com/shekhargh/todolistultimate/ui/composables/MainScreen.kt`)
- List ViewModel → Task use cases: requests tasks (evidence: `app/src/main/java/com/shekhargh/todolistultimate/ui/viewModels/MainTodoListViewModel.kt`)
- Add/edit screen → Edit ViewModel: uses (evidence: `app/src/main/java/com/shekhargh/todolistultimate/ui/composables/AddEditScreen.kt`)
- Edit ViewModel → Task use cases: invokes (evidence: `app/src/main/java/com/shekhargh/todolistultimate/ui/viewModels/AddTaskViewModel.kt`)
- Task use cases → Task repository: delegates to
- Task repository → Room DAO: calls (evidence: `app/src/main/java/com/shekhargh/todolistultimate/data/repository/TodoListUltimateRepositoryImpl.kt`)
- Room database → Room DAO: provides (evidence: `app/src/main/java/com/shekhargh/todolistultimate/data/TodoListUltimateDatabase.kt`)
- Room DAO → Task record: reads and writes (evidence: `app/src/main/java/com/shekhargh/todolistultimate/data/TodoListUltimateDao.kt`)
- Edit ViewModel → Reminder scheduler: schedules or cancels (evidence: `app/src/main/java/com/shekhargh/todolistultimate/ui/viewModels/AddTaskViewModel.kt`)
- Reminder scheduler → Deadline reminder: enqueues (evidence: `app/src/main/java/com/shekhargh/todolistultimate/data/WorkManagerTaskSchedular.kt`)
- Deadline reminder → Task use cases: loads task (evidence: `app/src/main/java/com/shekhargh/todolistultimate/worker/TaskReminderWorker.kt`)
- Deadline reminder → Notification service: requests alert (evidence: `app/src/main/java/com/shekhargh/todolistultimate/worker/TaskReminderWorker.kt`)
- Daily summary → Task use cases: loads tasks (evidence: `app/src/main/java/com/shekhargh/todolistultimate/worker/DailySummaryWorker.kt`)
- Daily summary → Notification service: sends summary (evidence: `app/src/main/java/com/shekhargh/todolistultimate/worker/DailySummaryWorker.kt`)
- Notification service → Android system: posts notification
- Android system → Glance widget: hosts
- Glance widget → Task use cases: loads task data (evidence: `app/src/main/java/com/shekhargh/todolistultimate/widget/TodoListUltimateWidget.kt`)
- Edit ViewModel → Widget updater: refreshes (evidence: `app/src/main/java/com/shekhargh/todolistultimate/ui/viewModels/AddTaskViewModel.kt`)
- Widget updater → Glance widget: updates (evidence: `app/src/main/java/com/shekhargh/todolistultimate/widget/WidgetUpdaterImpl.kt`)
