# android/architecture-samples architecture

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

- Interactive diagram: https://gitdiagram.com/android/architecture-samples
- Repository: https://github.com/android/architecture-samples

## Overview

This repository is an Android TODO-app architecture sample. A user enters through its single-activity app shell, navigates to task-list, task-detail, task-edit, or statistics screens, and uses those features to view or change tasks. The README describes Compose screens with per-screen ViewModels, reactive Flow/coroutine operations, a repository, local Room storage, a fake remote source, and Hilt injection. The tree identifies the corresponding modules, but no runtime source excerpts were provided; therefore feature-level calls and data transfers are shown only as unverified dashed links.

Main entry points: [`app/src/main/java/com/example/android/architecture/blueprints/todoapp/data/DefaultTaskRepository.kt`](https://github.com/android/architecture-samples/blob/main/app/src/main/java/com/example/android/architecture/blueprints/todoapp/data/DefaultTaskRepository.kt) (Task repository), [`app/src/main/java/com/example/android/architecture/blueprints/todoapp/TodoNavGraph.kt`](https://github.com/android/architecture-samples/blob/main/app/src/main/java/com/example/android/architecture/blueprints/todoapp/TodoNavGraph.kt) (Navigation), [`app/src/main/java/com/example/android/architecture/blueprints/todoapp/TodoActivity.kt`](https://github.com/android/architecture-samples/blob/main/app/src/main/java/com/example/android/architecture/blueprints/todoapp/TodoActivity.kt) (Activity), [`app/src/main/java/com/example/android/architecture/blueprints/todoapp/tasks/TasksScreen.kt`](https://github.com/android/architecture-samples/blob/main/app/src/main/java/com/example/android/architecture/blueprints/todoapp/tasks/TasksScreen.kt) (Task list)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_shell["App shell"]
  node_activity["Activity<br/>[TodoActivity.kt]"]
  node_navigation["Navigation<br/>[TodoNavGraph.kt]"]
  node_theme["Compose theme<br/>[TodoTheme.kt]"]
end

subgraph group_features["Task features"]
  node_tasklist["Task list<br/>[TasksScreen.kt]"]
  node_liststate["List ViewModel<br/>[TasksViewModel.kt]"]
  node_taskdetail["Task detail"]
  node_detailstate["Detail ViewModel"]
  node_taskedit["Task editor"]
  node_editstate["Edit ViewModel"]
  node_statistics["Statistics"]
  node_statsstate["Statistics ViewModel"]
end

subgraph group_data["Task data"]
  node_repository["Task repository"]
  node_taskmodel["Task model<br/>[Task.kt]"]
  node_room[("Room database<br/>[ToDoDatabase.kt]")]
  node_taskdao["Task DAO<br/>[TaskDao.kt]"]
  node_networksource["Fake remote source"]
end

subgraph group_support["App support"]
  node_di["Dependency injection<br/>[DataModules.kt]"]
  node_coroutines["Coroutine setup"]
end

node_user(("User"))

node_user -.->|"opens app"| node_activity
node_activity -.->|"hosts navigation"| node_navigation
node_navigation -.->|"routes to"| node_tasklist
node_navigation -.->|"routes to"| node_taskdetail
node_navigation -.->|"routes to"| node_taskedit
node_navigation -.->|"routes to"| node_statistics
node_activity -.->|"applies theme"| node_theme
node_tasklist -.->|"uses state"| node_liststate
node_taskdetail -.->|"uses state"| node_detailstate
node_taskedit -.->|"uses state"| node_editstate
node_statistics -.->|"uses state"| node_statsstate
node_liststate -.->|"requests tasks"| node_repository
node_detailstate -.->|"requests task"| node_repository
node_editstate -.->|"changes task"| node_repository
node_statsstate -.->|"requests totals"| node_repository
node_repository -.->|"uses local storage"| node_room
node_room -.->|"provides DAO"| node_taskdao
node_repository -.->|"uses fake remote"| node_networksource
node_repository -.->|"exposes tasks"| node_taskmodel
node_di -.->|"provides dependencies"| node_repository
node_coroutines -.->|"configures dispatchers"| node_repository

click node_activity "https://github.com/android/architecture-samples/blob/main/app/src/main/java/com/example/android/architecture/blueprints/todoapp/TodoActivity.kt"
click node_navigation "https://github.com/android/architecture-samples/blob/main/app/src/main/java/com/example/android/architecture/blueprints/todoapp/TodoNavGraph.kt"
click node_theme "https://github.com/android/architecture-samples/blob/main/app/src/main/java/com/example/android/architecture/blueprints/todoapp/TodoTheme.kt"
click node_tasklist "https://github.com/android/architecture-samples/blob/main/app/src/main/java/com/example/android/architecture/blueprints/todoapp/tasks/TasksScreen.kt"
click node_liststate "https://github.com/android/architecture-samples/blob/main/app/src/main/java/com/example/android/architecture/blueprints/todoapp/tasks/TasksViewModel.kt"
click node_taskdetail "https://github.com/android/architecture-samples/blob/main/app/src/main/java/com/example/android/architecture/blueprints/todoapp/taskdetail/TaskDetailScreen.kt"
click node_detailstate "https://github.com/android/architecture-samples/blob/main/app/src/main/java/com/example/android/architecture/blueprints/todoapp/taskdetail/TaskDetailViewModel.kt"
click node_taskedit "https://github.com/android/architecture-samples/blob/main/app/src/main/java/com/example/android/architecture/blueprints/todoapp/addedittask/AddEditTaskScreen.kt"
click node_editstate "https://github.com/android/architecture-samples/blob/main/app/src/main/java/com/example/android/architecture/blueprints/todoapp/addedittask/AddEditTaskViewModel.kt"
click node_statistics "https://github.com/android/architecture-samples/blob/main/app/src/main/java/com/example/android/architecture/blueprints/todoapp/statistics/StatisticsScreen.kt"
click node_statsstate "https://github.com/android/architecture-samples/blob/main/app/src/main/java/com/example/android/architecture/blueprints/todoapp/statistics/StatisticsViewModel.kt"
click node_repository "https://github.com/android/architecture-samples/blob/main/app/src/main/java/com/example/android/architecture/blueprints/todoapp/data/DefaultTaskRepository.kt"
click node_taskmodel "https://github.com/android/architecture-samples/blob/main/app/src/main/java/com/example/android/architecture/blueprints/todoapp/data/Task.kt"
click node_room "https://github.com/android/architecture-samples/blob/main/app/src/main/java/com/example/android/architecture/blueprints/todoapp/data/source/local/ToDoDatabase.kt"
click node_taskdao "https://github.com/android/architecture-samples/blob/main/app/src/main/java/com/example/android/architecture/blueprints/todoapp/data/source/local/TaskDao.kt"
click node_networksource "https://github.com/android/architecture-samples/blob/main/app/src/main/java/com/example/android/architecture/blueprints/todoapp/data/source/network/TaskNetworkDataSource.kt"
click node_di "https://github.com/android/architecture-samples/blob/main/app/src/main/java/com/example/android/architecture/blueprints/todoapp/di/DataModules.kt"
click node_coroutines "https://github.com/android/architecture-samples/blob/main/app/src/main/java/com/example/android/architecture/blueprints/todoapp/di/CoroutinesModule.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_theme,node_user toneBlue
class node_tasklist,node_liststate,node_taskdetail,node_detailstate,node_taskedit,node_editstate,node_statistics,node_statsstate toneAmber
class node_repository,node_taskmodel,node_room,node_taskdao,node_networksource toneMint
class node_di,node_coroutines toneRose
```

## Components

### App shell

- [Activity](https://github.com/android/architecture-samples/blob/main/app/src/main/java/com/example/android/architecture/blueprints/todoapp/TodoActivity.kt): `app/src/main/java/com/example/android/architecture/blueprints/todoapp/TodoActivity.kt`
- [Navigation](https://github.com/android/architecture-samples/blob/main/app/src/main/java/com/example/android/architecture/blueprints/todoapp/TodoNavGraph.kt): `app/src/main/java/com/example/android/architecture/blueprints/todoapp/TodoNavGraph.kt`
- [Compose theme](https://github.com/android/architecture-samples/blob/main/app/src/main/java/com/example/android/architecture/blueprints/todoapp/TodoTheme.kt): `app/src/main/java/com/example/android/architecture/blueprints/todoapp/TodoTheme.kt`

### Task features

- [Task list](https://github.com/android/architecture-samples/blob/main/app/src/main/java/com/example/android/architecture/blueprints/todoapp/tasks/TasksScreen.kt): `app/src/main/java/com/example/android/architecture/blueprints/todoapp/tasks/TasksScreen.kt`
- [List ViewModel](https://github.com/android/architecture-samples/blob/main/app/src/main/java/com/example/android/architecture/blueprints/todoapp/tasks/TasksViewModel.kt): `app/src/main/java/com/example/android/architecture/blueprints/todoapp/tasks/TasksViewModel.kt`
- [Task detail](https://github.com/android/architecture-samples/blob/main/app/src/main/java/com/example/android/architecture/blueprints/todoapp/taskdetail/TaskDetailScreen.kt): `app/src/main/java/com/example/android/architecture/blueprints/todoapp/taskdetail/TaskDetailScreen.kt`
- [Detail ViewModel](https://github.com/android/architecture-samples/blob/main/app/src/main/java/com/example/android/architecture/blueprints/todoapp/taskdetail/TaskDetailViewModel.kt): `app/src/main/java/com/example/android/architecture/blueprints/todoapp/taskdetail/TaskDetailViewModel.kt`
- [Task editor](https://github.com/android/architecture-samples/blob/main/app/src/main/java/com/example/android/architecture/blueprints/todoapp/addedittask/AddEditTaskScreen.kt): `app/src/main/java/com/example/android/architecture/blueprints/todoapp/addedittask/AddEditTaskScreen.kt`
- [Edit ViewModel](https://github.com/android/architecture-samples/blob/main/app/src/main/java/com/example/android/architecture/blueprints/todoapp/addedittask/AddEditTaskViewModel.kt): `app/src/main/java/com/example/android/architecture/blueprints/todoapp/addedittask/AddEditTaskViewModel.kt`
- [Statistics](https://github.com/android/architecture-samples/blob/main/app/src/main/java/com/example/android/architecture/blueprints/todoapp/statistics/StatisticsScreen.kt): `app/src/main/java/com/example/android/architecture/blueprints/todoapp/statistics/StatisticsScreen.kt`
- [Statistics ViewModel](https://github.com/android/architecture-samples/blob/main/app/src/main/java/com/example/android/architecture/blueprints/todoapp/statistics/StatisticsViewModel.kt): `app/src/main/java/com/example/android/architecture/blueprints/todoapp/statistics/StatisticsViewModel.kt`

### Task data

- [Task repository](https://github.com/android/architecture-samples/blob/main/app/src/main/java/com/example/android/architecture/blueprints/todoapp/data/DefaultTaskRepository.kt): `app/src/main/java/com/example/android/architecture/blueprints/todoapp/data/DefaultTaskRepository.kt`
- [Task model](https://github.com/android/architecture-samples/blob/main/app/src/main/java/com/example/android/architecture/blueprints/todoapp/data/Task.kt): `app/src/main/java/com/example/android/architecture/blueprints/todoapp/data/Task.kt`
- [Room database](https://github.com/android/architecture-samples/blob/main/app/src/main/java/com/example/android/architecture/blueprints/todoapp/data/source/local/ToDoDatabase.kt): `app/src/main/java/com/example/android/architecture/blueprints/todoapp/data/source/local/ToDoDatabase.kt`
- [Task DAO](https://github.com/android/architecture-samples/blob/main/app/src/main/java/com/example/android/architecture/blueprints/todoapp/data/source/local/TaskDao.kt): `app/src/main/java/com/example/android/architecture/blueprints/todoapp/data/source/local/TaskDao.kt`
- [Fake remote source](https://github.com/android/architecture-samples/blob/main/app/src/main/java/com/example/android/architecture/blueprints/todoapp/data/source/network/TaskNetworkDataSource.kt): `app/src/main/java/com/example/android/architecture/blueprints/todoapp/data/source/network/TaskNetworkDataSource.kt`

### App support

- [Dependency injection](https://github.com/android/architecture-samples/blob/main/app/src/main/java/com/example/android/architecture/blueprints/todoapp/di/DataModules.kt): `app/src/main/java/com/example/android/architecture/blueprints/todoapp/di/DataModules.kt`
- [Coroutine setup](https://github.com/android/architecture-samples/blob/main/app/src/main/java/com/example/android/architecture/blueprints/todoapp/di/CoroutinesModule.kt): `app/src/main/java/com/example/android/architecture/blueprints/todoapp/di/CoroutinesModule.kt`

### Other components

- **User**

## Connections

- User → Activity: opens app
- Activity → Navigation: hosts navigation
- Navigation → Task list: routes to
- Navigation → Task detail: routes to
- Navigation → Task editor: routes to
- Navigation → Statistics: routes to
- Activity → Compose theme: applies theme
- Task list → List ViewModel: uses state
- Task detail → Detail ViewModel: uses state
- Task editor → Edit ViewModel: uses state
- Statistics → Statistics ViewModel: uses state
- List ViewModel → Task repository: requests tasks
- Detail ViewModel → Task repository: requests task
- Edit ViewModel → Task repository: changes task
- Statistics ViewModel → Task repository: requests totals
- Task repository → Room database: uses local storage
- Room database → Task DAO: provides DAO
- Task repository → Fake remote source: uses fake remote
- Task repository → Task model: exposes tasks
- Dependency injection → Task repository: provides dependencies
- Coroutine setup → Task repository: configures dispatchers
