# sayanthrock-developer/github-rock architecture

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

- Interactive diagram: https://gitdiagram.com/sayanthrock-developer/github-rock
- Repository: https://github.com/sayanthrock-developer/github-rock

## Overview

GitHub Rock is a native Android GitHub client. Users sign in, navigate GitHub account and repository data, inspect issues, pull requests and Actions, then manage release downloads with verification. The map includes documented product capabilities even where their implementation was not sampled; edges without direct source evidence rely on the README’s architecture and feature descriptions. Source excerpts are partial, so some feature-level connections are intentionally omitted.

Main entry points: [`app/src/main/java/com/sayanthrock/githubrock/data/repository/DownloadRepository.kt`](https://github.com/sayanthrock-developer/github-rock/blob/main/app/src/main/java/com/sayanthrock/githubrock/data/repository/DownloadRepository.kt) (Download management), [`app/src/main/java/com/sayanthrock/githubrock/data/repository/GitHubRepository.kt`](https://github.com/sayanthrock-developer/github-rock/blob/main/app/src/main/java/com/sayanthrock/githubrock/data/repository/GitHubRepository.kt) (Repository workflows), [`app/src/main/java/com/sayanthrock/githubrock/ui/GitHubRockRoot.kt`](https://github.com/sayanthrock-developer/github-rock/blob/main/app/src/main/java/com/sayanthrock/githubrock/ui/GitHubRockRoot.kt) (Compose root), [`app/src/main/java/com/sayanthrock/githubrock/data/auth/DeviceFlowAuthRepository.kt`](https://github.com/sayanthrock-developer/github-rock/blob/main/app/src/main/java/com/sayanthrock/githubrock/data/auth/DeviceFlowAuthRepository.kt) (Device-flow auth)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["App shell"]
  node_activity["Android entry<br/>[MainActivity.kt]"]
  node_root["Compose root<br/>[GitHubRockRoot.kt]"]
  node_navigation["Main navigation"]
  node_mainvm["Home state<br/>[MainViewModel.kt]"]
end

subgraph group_github["GitHub workflows"]
  node_repositories["Repository workflows"]
  node_repooptions["Repository search filters"]
  node_filemanager["Repository files"]
  node_fileui["File manager UI"]
  node_hub["Repository hub"]
end

subgraph group_downloads["Downloads and verification"]
  node_downloadrepo["Download management"]
  node_worker["Download worker<br/>[DownloadWorker.kt]"]
  node_checksum["SHA-256 verification"]
end

subgraph group_foundation["Data and security"]
  node_auth["Device-flow auth"]
  node_tokenstore[("Secure tokens")]
  node_backend["Backend gateway<br/>[BackendGateway.kt]"]
  node_githubapi["GitHub REST API<br/>[GitHubApi.kt]"]
  node_database[("Download state store<br/>[AppDatabase.kt]")]
end

node_user(("GitHub user"))
node_github{{"GitHub services"}}

node_user -->|"opens app"| node_activity
node_activity -->|"sets content"| node_root
node_root -->|"renders"| node_navigation
node_root -->|"uses state"| node_mainvm
node_root -->|"hosts sign-in"| node_auth
node_auth -->|"stores tokens"| node_tokenstore
node_auth -->|"starts OAuth"| node_backend
node_auth -.->|"requests device code"| node_github
node_navigation -.->|"opens GitHub work"| node_repositories
node_repositories -->|"calls endpoints"| node_githubapi
node_repositories -->|"applies filters"| node_repooptions
node_fileui -->|"displays state"| node_filemanager
node_filemanager -->|"browses files"| node_repositories
node_filemanager -.->|"uploads files"| node_github
node_repositories -.->|"provides repository data"| node_hub
node_user -.->|"requests artifact"| node_downloadrepo
node_downloadrepo -.->|"persists download state"| node_database
node_downloadrepo -->|"schedules downloads"| node_worker
node_worker -->|"updates progress"| node_downloadrepo
node_worker -->|"verifies digest"| node_checksum
node_downloadrepo -->|"checks files"| node_checksum
node_downloadrepo -.->|"fetches artifacts"| node_github

click node_activity "https://github.com/sayanthrock-developer/github-rock/blob/main/app/src/main/java/com/sayanthrock/githubrock/MainActivity.kt"
click node_root "https://github.com/sayanthrock-developer/github-rock/blob/main/app/src/main/java/com/sayanthrock/githubrock/ui/GitHubRockRoot.kt"
click node_navigation "https://github.com/sayanthrock-developer/github-rock/blob/main/app/src/main/java/com/sayanthrock/githubrock/ui/navigation/RockNavigationChrome.kt"
click node_mainvm "https://github.com/sayanthrock-developer/github-rock/blob/main/app/src/main/java/com/sayanthrock/githubrock/ui/MainViewModel.kt"
click node_auth "https://github.com/sayanthrock-developer/github-rock/blob/main/app/src/main/java/com/sayanthrock/githubrock/data/auth/DeviceFlowAuthRepository.kt"
click node_tokenstore "https://github.com/sayanthrock-developer/github-rock/blob/main/app/src/main/java/com/sayanthrock/githubrock/core/security/SecureTokenStore.kt"
click node_backend "https://github.com/sayanthrock-developer/github-rock/blob/main/app/src/main/java/com/sayanthrock/githubrock/data/backend/BackendGateway.kt"
click node_githubapi "https://github.com/sayanthrock-developer/github-rock/blob/main/app/src/main/java/com/sayanthrock/githubrock/core/network/GitHubApi.kt"
click node_repositories "https://github.com/sayanthrock-developer/github-rock/blob/main/app/src/main/java/com/sayanthrock/githubrock/data/repository/GitHubRepository.kt"
click node_repooptions "https://github.com/sayanthrock-developer/github-rock/blob/main/app/src/main/java/com/sayanthrock/githubrock/core/model/RepositorySearchOptions.kt"
click node_filemanager "https://github.com/sayanthrock-developer/github-rock/blob/main/app/src/main/java/com/sayanthrock/githubrock/ui/screens/RepositoryFileManagerViewModel.kt"
click node_fileui "https://github.com/sayanthrock-developer/github-rock/blob/main/app/src/main/java/com/sayanthrock/githubrock/ui/screens/RepositoryFileManagerScreen.kt"
click node_hub "https://github.com/sayanthrock-developer/github-rock/blob/main/app/src/main/java/com/sayanthrock/githubrock/ui/screens/RepositoryHubContent.kt"
click node_downloadrepo "https://github.com/sayanthrock-developer/github-rock/blob/main/app/src/main/java/com/sayanthrock/githubrock/data/repository/DownloadRepository.kt"
click node_worker "https://github.com/sayanthrock-developer/github-rock/blob/main/app/src/main/java/com/sayanthrock/githubrock/download/DownloadWorker.kt"
click node_checksum "https://github.com/sayanthrock-developer/github-rock/blob/main/app/src/main/java/com/sayanthrock/githubrock/core/util/ChecksumVerifier.kt"
click node_database "https://github.com/sayanthrock-developer/github-rock/blob/main/app/src/main/java/com/sayanthrock/githubrock/data/local/AppDatabase.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_root,node_navigation,node_mainvm,node_user toneBlue
class node_repositories,node_repooptions,node_filemanager,node_fileui,node_hub toneAmber
class node_downloadrepo,node_worker,node_checksum toneMint
class node_auth,node_tokenstore,node_backend,node_githubapi,node_database toneRose
class node_github toneIndigo
```

## Components

### App shell

- [Android entry](https://github.com/sayanthrock-developer/github-rock/blob/main/app/src/main/java/com/sayanthrock/githubrock/MainActivity.kt): `app/src/main/java/com/sayanthrock/githubrock/MainActivity.kt`
- [Compose root](https://github.com/sayanthrock-developer/github-rock/blob/main/app/src/main/java/com/sayanthrock/githubrock/ui/GitHubRockRoot.kt): `app/src/main/java/com/sayanthrock/githubrock/ui/GitHubRockRoot.kt`
- [Main navigation](https://github.com/sayanthrock-developer/github-rock/blob/main/app/src/main/java/com/sayanthrock/githubrock/ui/navigation/RockNavigationChrome.kt): `app/src/main/java/com/sayanthrock/githubrock/ui/navigation/RockNavigationChrome.kt`
- [Home state](https://github.com/sayanthrock-developer/github-rock/blob/main/app/src/main/java/com/sayanthrock/githubrock/ui/MainViewModel.kt): `app/src/main/java/com/sayanthrock/githubrock/ui/MainViewModel.kt`

### GitHub workflows

- [Repository workflows](https://github.com/sayanthrock-developer/github-rock/blob/main/app/src/main/java/com/sayanthrock/githubrock/data/repository/GitHubRepository.kt): `app/src/main/java/com/sayanthrock/githubrock/data/repository/GitHubRepository.kt`
- [Repository search filters](https://github.com/sayanthrock-developer/github-rock/blob/main/app/src/main/java/com/sayanthrock/githubrock/core/model/RepositorySearchOptions.kt): `app/src/main/java/com/sayanthrock/githubrock/core/model/RepositorySearchOptions.kt`
- [Repository files](https://github.com/sayanthrock-developer/github-rock/blob/main/app/src/main/java/com/sayanthrock/githubrock/ui/screens/RepositoryFileManagerViewModel.kt): `app/src/main/java/com/sayanthrock/githubrock/ui/screens/RepositoryFileManagerViewModel.kt`
- [File manager UI](https://github.com/sayanthrock-developer/github-rock/blob/main/app/src/main/java/com/sayanthrock/githubrock/ui/screens/RepositoryFileManagerScreen.kt): `app/src/main/java/com/sayanthrock/githubrock/ui/screens/RepositoryFileManagerScreen.kt`
- [Repository hub](https://github.com/sayanthrock-developer/github-rock/blob/main/app/src/main/java/com/sayanthrock/githubrock/ui/screens/RepositoryHubContent.kt): `app/src/main/java/com/sayanthrock/githubrock/ui/screens/RepositoryHubContent.kt`

### Downloads and verification

- [Download management](https://github.com/sayanthrock-developer/github-rock/blob/main/app/src/main/java/com/sayanthrock/githubrock/data/repository/DownloadRepository.kt): `app/src/main/java/com/sayanthrock/githubrock/data/repository/DownloadRepository.kt`
- [Download worker](https://github.com/sayanthrock-developer/github-rock/blob/main/app/src/main/java/com/sayanthrock/githubrock/download/DownloadWorker.kt): `app/src/main/java/com/sayanthrock/githubrock/download/DownloadWorker.kt`
- [SHA-256 verification](https://github.com/sayanthrock-developer/github-rock/blob/main/app/src/main/java/com/sayanthrock/githubrock/core/util/ChecksumVerifier.kt): `app/src/main/java/com/sayanthrock/githubrock/core/util/ChecksumVerifier.kt`

### Data and security

- [Device-flow auth](https://github.com/sayanthrock-developer/github-rock/blob/main/app/src/main/java/com/sayanthrock/githubrock/data/auth/DeviceFlowAuthRepository.kt): `app/src/main/java/com/sayanthrock/githubrock/data/auth/DeviceFlowAuthRepository.kt`
- [Secure tokens](https://github.com/sayanthrock-developer/github-rock/blob/main/app/src/main/java/com/sayanthrock/githubrock/core/security/SecureTokenStore.kt): `app/src/main/java/com/sayanthrock/githubrock/core/security/SecureTokenStore.kt`
- [Backend gateway](https://github.com/sayanthrock-developer/github-rock/blob/main/app/src/main/java/com/sayanthrock/githubrock/data/backend/BackendGateway.kt): `app/src/main/java/com/sayanthrock/githubrock/data/backend/BackendGateway.kt`
- [GitHub REST API](https://github.com/sayanthrock-developer/github-rock/blob/main/app/src/main/java/com/sayanthrock/githubrock/core/network/GitHubApi.kt): `app/src/main/java/com/sayanthrock/githubrock/core/network/GitHubApi.kt`
- [Download state store](https://github.com/sayanthrock-developer/github-rock/blob/main/app/src/main/java/com/sayanthrock/githubrock/data/local/AppDatabase.kt): `app/src/main/java/com/sayanthrock/githubrock/data/local/AppDatabase.kt`

### Other components

- **GitHub user**
- **GitHub services**

## Connections

- GitHub user → Android entry: opens app (evidence: `README.md`)
- Android entry → Compose root: sets content (evidence: `app/src/main/java/com/sayanthrock/githubrock/MainActivity.kt`)
- Compose root → Main navigation: renders (evidence: `app/src/main/java/com/sayanthrock/githubrock/ui/GitHubRockRoot.kt`)
- Compose root → Home state: uses state (evidence: `app/src/main/java/com/sayanthrock/githubrock/ui/GitHubRockRoot.kt`)
- Compose root → Device-flow auth: hosts sign-in (evidence: `app/src/main/java/com/sayanthrock/githubrock/ui/GitHubRockRoot.kt`)
- Device-flow auth → Secure tokens: stores tokens (evidence: `app/src/main/java/com/sayanthrock/githubrock/data/auth/DeviceFlowAuthRepository.kt`)
- Device-flow auth → Backend gateway: starts OAuth (evidence: `app/src/main/java/com/sayanthrock/githubrock/data/auth/DeviceFlowAuthRepository.kt`)
- Device-flow auth → GitHub services: requests device code
- Main navigation → Repository workflows: opens GitHub work
- Repository workflows → GitHub REST API: calls endpoints (evidence: `app/src/main/java/com/sayanthrock/githubrock/data/repository/GitHubRepository.kt`)
- Repository workflows → Repository search filters: applies filters (evidence: `app/src/main/java/com/sayanthrock/githubrock/data/repository/GitHubRepository.kt`)
- File manager UI → Repository files: displays state (evidence: `app/src/main/java/com/sayanthrock/githubrock/ui/screens/RepositoryFileManagerScreen.kt`)
- Repository files → Repository workflows: browses files (evidence: `app/src/main/java/com/sayanthrock/githubrock/ui/screens/RepositoryFileManagerViewModel.kt`)
- Repository files → GitHub services: uploads files
- Repository workflows → Repository hub: provides repository data
- GitHub user → Download management: requests artifact
- Download management → Download state store: persists download state
- Download management → Download worker: schedules downloads (evidence: `app/src/main/java/com/sayanthrock/githubrock/download/DownloadWorker.kt`)
- Download worker → Download management: updates progress (evidence: `app/src/main/java/com/sayanthrock/githubrock/download/DownloadWorker.kt`)
- Download worker → SHA-256 verification: verifies digest (evidence: `app/src/main/java/com/sayanthrock/githubrock/download/DownloadWorker.kt`)
- Download management → SHA-256 verification: checks files (evidence: `app/src/main/java/com/sayanthrock/githubrock/data/repository/DownloadRepository.kt`)
- Download management → GitHub services: fetches artifacts
