# grawgo/taskplannerclient architecture

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

- Interactive diagram: https://gitdiagram.com/grawgo/taskplannerclient
- Repository: https://github.com/grawgo/taskplannerclient

## Overview

This is an Android task-planning client. Users navigate Compose screens to authenticate, browse and search tasks, edit task details, and change settings. Task operations are validated and routed through domain actions to a remote repository; the client discovers the LAN server and calls its API, while Firebase supplies authentication and encrypted session state. Search history and theme preference are local capabilities. The graph preserves these documented branches; unsampled screen and storage wiring is shown only where README or indexed references support it.

Main entry points: [`app/src/main/java/com/taskplanner/app/data/repository/FirebaseAuthRepository.kt`](https://github.com/grawgo/taskplannerclient/blob/master/app/src/main/java/com/taskplanner/app/data/repository/FirebaseAuthRepository.kt) (Firebase auth repository), [`app/src/main/java/com/taskplanner/app/presentation/MainActivity.kt`](https://github.com/grawgo/taskplannerclient/blob/master/app/src/main/java/com/taskplanner/app/presentation/MainActivity.kt) (Navigation host), [`app/src/main/java/com/taskplanner/app/presentation/TasksViewModels.kt`](https://github.com/grawgo/taskplannerclient/blob/master/app/src/main/java/com/taskplanner/app/presentation/TasksViewModels.kt) (Task view models), [`app/src/main/java/com/taskplanner/app/presentation/AuthViewModel.kt`](https://github.com/grawgo/taskplannerclient/blob/master/app/src/main/java/com/taskplanner/app/presentation/AuthViewModel.kt) (Auth view model)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_ui["Presentation"]
  node_app["Navigation host<br/>[MainActivity.kt]"]
  node_task_screens["Task screens<br/>[TasksScreens.kt]"]
  node_task_vm["Task view models<br/>[TasksViewModels.kt]"]
  node_editor_search_settings["Editor, search, settings"]
  node_task_components["Task components<br/>[TaskComponents.kt]"]
  node_auth_vm["Auth view model<br/>[AuthViewModel.kt]"]
  node_theme_ui["Theme styling<br/>[Theme.kt]"]
end

subgraph group_domain["Task domain"]
  node_task_actions["Task actions<br/>[TaskActions.kt]"]
  node_task_model["Task model<br/>[Task.kt]"]
  node_task_repo["Task repository contract<br/>[TaskRepository.kt]"]
  node_search_contract["Search history contract"]
  node_theme_repo["Theme preference contract<br/>[ThemeRepository.kt]"]
  node_auth_repo_contract["Auth contract<br/>[AuthRepository.kt]"]
  node_session_contract["Session contract<br/>[SessionProvider.kt]"]
  node_auth_vm_validator["Auth input validator"]
end

subgraph group_data["Data and networking"]
  node_remote_repo["Remote task repository"]
  node_task_api["Task HTTP API<br/>[TaskApi.kt]"]
  node_discovery["LAN discovery"]
end

subgraph group_local["Local persistence"]
  node_search_db[("Search history database")]
  node_local_repos["Local repositories"]
end

subgraph group_auth["Authentication"]
  node_firebase_repo["Firebase auth repository"]
  node_session_store[("Encrypted session store")]
  node_firebase_api["Firebase auth APIs<br/>[FirebaseAuthApi.kt]"]
end

node_user(("App user"))
node_task_server{{"TaskPlanner server"}}
node_firebase{{"Firebase Authentication"}}

node_user -->|"uses"| node_app
node_app -->|"routes to"| node_task_screens
node_app -->|"routes to"| node_editor_search_settings
node_app -->|"creates"| node_auth_vm
node_task_screens -->|"presents"| node_task_vm
node_task_screens -->|"uses"| node_task_components
node_editor_search_settings -->|"presents"| node_auth_vm
node_task_vm -->|"invokes"| node_task_actions
node_task_vm -->|"uses"| node_search_contract
node_task_vm -->|"uses"| node_theme_repo
node_task_actions -->|"calls"| node_task_repo
node_task_actions -->|"validates"| node_task_model
node_remote_repo -->|"implements"| node_task_repo
node_remote_repo -->|"calls"| node_task_api
node_remote_repo -->|"gets token"| node_session_contract
node_task_api -.->|"HTTP requests"| node_task_server
node_discovery -.->|"discovers"| node_task_server
node_local_repos -->|"implements"| node_search_contract
node_local_repos -->|"implements"| node_theme_repo
node_search_db -.->|"stores history"| node_local_repos
node_auth_vm -->|"calls"| node_auth_repo_contract
node_auth_vm -->|"validates input"| node_auth_vm_validator
node_firebase_repo -->|"implements"| node_auth_repo_contract
node_firebase_repo -->|"implements"| node_session_contract
node_firebase_repo -->|"calls"| node_firebase_api
node_firebase_repo -->|"reads/writes"| node_session_store
node_firebase_api -.->|"auth requests"| node_firebase
node_theme_ui -.->|"renders theme"| node_user

click node_app "https://github.com/grawgo/taskplannerclient/blob/master/app/src/main/java/com/taskplanner/app/presentation/MainActivity.kt"
click node_task_screens "https://github.com/grawgo/taskplannerclient/blob/master/app/src/main/java/com/taskplanner/app/presentation/TasksScreens.kt"
click node_task_vm "https://github.com/grawgo/taskplannerclient/blob/master/app/src/main/java/com/taskplanner/app/presentation/TasksViewModels.kt"
click node_editor_search_settings "https://github.com/grawgo/taskplannerclient/blob/master/app/src/main/java/com/taskplanner/app/presentation/EditorSearchSettingsScreens.kt"
click node_task_components "https://github.com/grawgo/taskplannerclient/blob/master/app/src/main/java/com/taskplanner/app/presentation/TaskComponents.kt"
click node_auth_vm "https://github.com/grawgo/taskplannerclient/blob/master/app/src/main/java/com/taskplanner/app/presentation/AuthViewModel.kt"
click node_theme_ui "https://github.com/grawgo/taskplannerclient/blob/master/app/src/main/java/com/taskplanner/app/ui/theme/Theme.kt"
click node_task_actions "https://github.com/grawgo/taskplannerclient/blob/master/app/src/main/java/com/taskplanner/app/domain/usecase/TaskActions.kt"
click node_task_model "https://github.com/grawgo/taskplannerclient/blob/master/app/src/main/java/com/taskplanner/app/domain/model/Task.kt"
click node_task_repo "https://github.com/grawgo/taskplannerclient/blob/master/app/src/main/java/com/taskplanner/app/domain/repository/TaskRepository.kt"
click node_remote_repo "https://github.com/grawgo/taskplannerclient/blob/master/app/src/main/java/com/taskplanner/app/data/repository/RemoteTaskRepository.kt"
click node_task_api "https://github.com/grawgo/taskplannerclient/blob/master/app/src/main/java/com/taskplanner/app/data/remote/TaskApi.kt"
click node_discovery "https://github.com/grawgo/taskplannerclient/blob/master/app/src/main/java/com/taskplanner/app/data/remote/LanServerDiscovery.kt"
click node_search_contract "https://github.com/grawgo/taskplannerclient/blob/master/app/src/main/java/com/taskplanner/app/domain/repository/SearchHistoryRepository.kt"
click node_search_db "https://github.com/grawgo/taskplannerclient/blob/master/app/src/main/java/com/taskplanner/app/data/local/SearchHistoryDatabase.kt"
click node_theme_repo "https://github.com/grawgo/taskplannerclient/blob/master/app/src/main/java/com/taskplanner/app/domain/repository/ThemeRepository.kt"
click node_local_repos "https://github.com/grawgo/taskplannerclient/blob/master/app/src/main/java/com/taskplanner/app/data/repository/LocalRepositories.kt"
click node_auth_repo_contract "https://github.com/grawgo/taskplannerclient/blob/master/app/src/main/java/com/taskplanner/app/domain/repository/AuthRepository.kt"
click node_session_contract "https://github.com/grawgo/taskplannerclient/blob/master/app/src/main/java/com/taskplanner/app/domain/repository/SessionProvider.kt"
click node_auth_vm_validator "https://github.com/grawgo/taskplannerclient/blob/master/app/src/main/java/com/taskplanner/app/domain/usecase/AuthInputValidator.kt"
click node_firebase_repo "https://github.com/grawgo/taskplannerclient/blob/master/app/src/main/java/com/taskplanner/app/data/repository/FirebaseAuthRepository.kt"
click node_session_store "https://github.com/grawgo/taskplannerclient/blob/master/app/src/main/java/com/taskplanner/app/data/repository/EncryptedSessionStore.kt"
click node_firebase_api "https://github.com/grawgo/taskplannerclient/blob/master/app/src/main/java/com/taskplanner/app/data/remote/FirebaseAuthApi.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_task_screens,node_task_vm,node_editor_search_settings,node_task_components,node_auth_vm,node_theme_ui,node_user toneBlue
class node_task_actions,node_task_model,node_task_repo,node_search_contract,node_theme_repo,node_auth_repo_contract,node_session_contract,node_auth_vm_validator toneAmber
class node_remote_repo,node_task_api,node_discovery toneMint
class node_search_db,node_local_repos,node_task_server toneRose
class node_firebase_repo,node_session_store,node_firebase_api,node_firebase toneIndigo
```

## Components

### Presentation

- [Navigation host](https://github.com/grawgo/taskplannerclient/blob/master/app/src/main/java/com/taskplanner/app/presentation/MainActivity.kt): `app/src/main/java/com/taskplanner/app/presentation/MainActivity.kt`
- [Task screens](https://github.com/grawgo/taskplannerclient/blob/master/app/src/main/java/com/taskplanner/app/presentation/TasksScreens.kt): `app/src/main/java/com/taskplanner/app/presentation/TasksScreens.kt`
- [Task view models](https://github.com/grawgo/taskplannerclient/blob/master/app/src/main/java/com/taskplanner/app/presentation/TasksViewModels.kt): `app/src/main/java/com/taskplanner/app/presentation/TasksViewModels.kt`
- [Editor, search, settings](https://github.com/grawgo/taskplannerclient/blob/master/app/src/main/java/com/taskplanner/app/presentation/EditorSearchSettingsScreens.kt): `app/src/main/java/com/taskplanner/app/presentation/EditorSearchSettingsScreens.kt`
- [Task components](https://github.com/grawgo/taskplannerclient/blob/master/app/src/main/java/com/taskplanner/app/presentation/TaskComponents.kt): `app/src/main/java/com/taskplanner/app/presentation/TaskComponents.kt`
- [Auth view model](https://github.com/grawgo/taskplannerclient/blob/master/app/src/main/java/com/taskplanner/app/presentation/AuthViewModel.kt): `app/src/main/java/com/taskplanner/app/presentation/AuthViewModel.kt`
- [Theme styling](https://github.com/grawgo/taskplannerclient/blob/master/app/src/main/java/com/taskplanner/app/ui/theme/Theme.kt): `app/src/main/java/com/taskplanner/app/ui/theme/Theme.kt`

### Task domain

- [Task actions](https://github.com/grawgo/taskplannerclient/blob/master/app/src/main/java/com/taskplanner/app/domain/usecase/TaskActions.kt): `app/src/main/java/com/taskplanner/app/domain/usecase/TaskActions.kt`
- [Task model](https://github.com/grawgo/taskplannerclient/blob/master/app/src/main/java/com/taskplanner/app/domain/model/Task.kt): `app/src/main/java/com/taskplanner/app/domain/model/Task.kt`
- [Task repository contract](https://github.com/grawgo/taskplannerclient/blob/master/app/src/main/java/com/taskplanner/app/domain/repository/TaskRepository.kt): `app/src/main/java/com/taskplanner/app/domain/repository/TaskRepository.kt`
- [Search history contract](https://github.com/grawgo/taskplannerclient/blob/master/app/src/main/java/com/taskplanner/app/domain/repository/SearchHistoryRepository.kt): `app/src/main/java/com/taskplanner/app/domain/repository/SearchHistoryRepository.kt`
- [Theme preference contract](https://github.com/grawgo/taskplannerclient/blob/master/app/src/main/java/com/taskplanner/app/domain/repository/ThemeRepository.kt): `app/src/main/java/com/taskplanner/app/domain/repository/ThemeRepository.kt`
- [Auth contract](https://github.com/grawgo/taskplannerclient/blob/master/app/src/main/java/com/taskplanner/app/domain/repository/AuthRepository.kt): `app/src/main/java/com/taskplanner/app/domain/repository/AuthRepository.kt`
- [Session contract](https://github.com/grawgo/taskplannerclient/blob/master/app/src/main/java/com/taskplanner/app/domain/repository/SessionProvider.kt): `app/src/main/java/com/taskplanner/app/domain/repository/SessionProvider.kt`
- [Auth input validator](https://github.com/grawgo/taskplannerclient/blob/master/app/src/main/java/com/taskplanner/app/domain/usecase/AuthInputValidator.kt): `app/src/main/java/com/taskplanner/app/domain/usecase/AuthInputValidator.kt`

### Data and networking

- [Remote task repository](https://github.com/grawgo/taskplannerclient/blob/master/app/src/main/java/com/taskplanner/app/data/repository/RemoteTaskRepository.kt): `app/src/main/java/com/taskplanner/app/data/repository/RemoteTaskRepository.kt`
- [Task HTTP API](https://github.com/grawgo/taskplannerclient/blob/master/app/src/main/java/com/taskplanner/app/data/remote/TaskApi.kt): `app/src/main/java/com/taskplanner/app/data/remote/TaskApi.kt`
- [LAN discovery](https://github.com/grawgo/taskplannerclient/blob/master/app/src/main/java/com/taskplanner/app/data/remote/LanServerDiscovery.kt): `app/src/main/java/com/taskplanner/app/data/remote/LanServerDiscovery.kt`

### Local persistence

- [Search history database](https://github.com/grawgo/taskplannerclient/blob/master/app/src/main/java/com/taskplanner/app/data/local/SearchHistoryDatabase.kt): `app/src/main/java/com/taskplanner/app/data/local/SearchHistoryDatabase.kt`
- [Local repositories](https://github.com/grawgo/taskplannerclient/blob/master/app/src/main/java/com/taskplanner/app/data/repository/LocalRepositories.kt): `app/src/main/java/com/taskplanner/app/data/repository/LocalRepositories.kt`

### Authentication

- [Firebase auth repository](https://github.com/grawgo/taskplannerclient/blob/master/app/src/main/java/com/taskplanner/app/data/repository/FirebaseAuthRepository.kt): `app/src/main/java/com/taskplanner/app/data/repository/FirebaseAuthRepository.kt`
- [Encrypted session store](https://github.com/grawgo/taskplannerclient/blob/master/app/src/main/java/com/taskplanner/app/data/repository/EncryptedSessionStore.kt): `app/src/main/java/com/taskplanner/app/data/repository/EncryptedSessionStore.kt`
- [Firebase auth APIs](https://github.com/grawgo/taskplannerclient/blob/master/app/src/main/java/com/taskplanner/app/data/remote/FirebaseAuthApi.kt): `app/src/main/java/com/taskplanner/app/data/remote/FirebaseAuthApi.kt`

### Other components

- **App user**
- **TaskPlanner server**
- **Firebase Authentication**

## Connections

- App user → Navigation host: uses (evidence: `app/src/main/java/com/taskplanner/app/presentation/MainActivity.kt`)
- Navigation host → Task screens: routes to (evidence: `app/src/main/java/com/taskplanner/app/presentation/MainActivity.kt`)
- Navigation host → Editor, search, settings: routes to (evidence: `app/src/main/java/com/taskplanner/app/presentation/MainActivity.kt`)
- Navigation host → Auth view model: creates (evidence: `app/src/main/java/com/taskplanner/app/presentation/MainActivity.kt`)
- Task screens → Task view models: presents (evidence: `app/src/main/java/com/taskplanner/app/presentation/TasksViewModels.kt`)
- Task screens → Task components: uses (evidence: `app/src/main/java/com/taskplanner/app/presentation/TaskComponents.kt`)
- Editor, search, settings → Auth view model: presents (evidence: `app/src/main/java/com/taskplanner/app/presentation/EditorSearchSettingsScreens.kt`)
- Task view models → Task actions: invokes (evidence: `app/src/main/java/com/taskplanner/app/presentation/TasksViewModels.kt`)
- Task view models → Search history contract: uses (evidence: `app/src/main/java/com/taskplanner/app/presentation/TasksViewModels.kt`)
- Task view models → Theme preference contract: uses (evidence: `app/src/main/java/com/taskplanner/app/presentation/TasksViewModels.kt`)
- Task actions → Task repository contract: calls (evidence: `app/src/main/java/com/taskplanner/app/domain/usecase/TaskActions.kt`)
- Task actions → Task model: validates (evidence: `app/src/main/java/com/taskplanner/app/domain/usecase/TaskActions.kt`)
- Remote task repository → Task repository contract: implements (evidence: `app/src/main/java/com/taskplanner/app/data/repository/RemoteTaskRepository.kt`)
- Remote task repository → Task HTTP API: calls (evidence: `app/src/main/java/com/taskplanner/app/data/repository/RemoteTaskRepository.kt`)
- Remote task repository → Session contract: gets token (evidence: `app/src/main/java/com/taskplanner/app/data/repository/RemoteTaskRepository.kt`)
- Task HTTP API → TaskPlanner server: HTTP requests (evidence: `README.md`)
- LAN discovery → TaskPlanner server: discovers (evidence: `README.md`)
- Local repositories → Search history contract: implements (evidence: `app/src/main/java/com/taskplanner/app/data/repository/LocalRepositories.kt`)
- Local repositories → Theme preference contract: implements (evidence: `app/src/main/java/com/taskplanner/app/data/repository/LocalRepositories.kt`)
- Search history database → Local repositories: stores history
- Auth view model → Auth contract: calls (evidence: `app/src/main/java/com/taskplanner/app/presentation/AuthViewModel.kt`)
- Auth view model → Auth input validator: validates input (evidence: `app/src/main/java/com/taskplanner/app/presentation/AuthViewModel.kt`)
- Firebase auth repository → Auth contract: implements (evidence: `app/src/main/java/com/taskplanner/app/data/repository/FirebaseAuthRepository.kt`)
- Firebase auth repository → Session contract: implements (evidence: `app/src/main/java/com/taskplanner/app/data/repository/FirebaseAuthRepository.kt`)
- Firebase auth repository → Firebase auth APIs: calls (evidence: `app/src/main/java/com/taskplanner/app/data/repository/FirebaseAuthRepository.kt`)
- Firebase auth repository → Encrypted session store: reads/writes (evidence: `app/src/main/java/com/taskplanner/app/data/repository/FirebaseAuthRepository.kt`)
- Firebase auth APIs → Firebase Authentication: auth requests (evidence: `README.md`)
- Theme styling → App user: renders theme
