# samyak2403/repostore architecture

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

- Interactive diagram: https://gitdiagram.com/samyak2403/repostore
- Repository: https://github.com/samyak2403/repostore

## Overview

RepoStore is an Android marketplace for GitHub repositories that publish installable APKs. Its main journey is discovery and filtering, APK-backed release validation, browsing release details, downloading and installing, then tracking installed versions and notifying about updates. The graph also captures GitHub authentication, developer browsing, VirusTotal scanning, and persistent favorites/install mappings. README statements support several product capabilities whose wiring is not present in the sampled excerpts, so those links are limited to documented runtime relationships.

Main entry points: [`app/src/main/java/com/samyak/repostore/data/repository/GitHubRepository.kt`](https://github.com/samyak2403/repostore/blob/main/app/src/main/java/com/samyak/repostore/data/repository/GitHubRepository.kt) (GitHub repository), [`app/src/main/java/com/samyak/repostore/data/api/GitHubApi.kt`](https://github.com/samyak2403/repostore/blob/main/app/src/main/java/com/samyak/repostore/data/api/GitHubApi.kt) (GitHub API), [`app/src/main/java/com/samyak/repostore/ui/activity/DetailActivity.kt`](https://github.com/samyak2403/repostore/blob/main/app/src/main/java/com/samyak/repostore/ui/activity/DetailActivity.kt) (Release details), [`app/src/main/java/com/samyak/repostore/worker/UpdateCheckWorker.kt`](https://github.com/samyak2403/repostore/blob/main/app/src/main/java/com/samyak/repostore/worker/UpdateCheckWorker.kt) (Update checks)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_discovery["Discovery &amp; browsing"]
  node_main["Main navigation<br/>[MainActivity.kt]"]
  node_home["Home discovery<br/>[HomeFragment.kt]"]
  node_search["Search &amp; filters<br/>[SearchFragment.kt]"]
  node_trending["Trending view"]
  node_viewmodels["Discovery viewmodels"]
  node_detail["Release details<br/>[DetailActivity.kt]"]
  node_developer["Developer profiles"]
end

subgraph group_github["GitHub data &amp; auth"]
  node_repository["GitHub repository"]
  node_retrofit["GitHub client<br/>[RetrofitClient.kt]"]
  node_githubapi["GitHub API<br/>[GitHubApi.kt]"]
  node_auth["OAuth sign-in<br/>[GitHubAuth.kt]"]
  node_tokens["Secure token storage"]
  node_database[("Local Room database<br/>[AppDatabase.kt]")]
end

subgraph group_install["Install &amp; updates"]
  node_download["APK downloader"]
  node_installer["Package installer<br/>[AppInstaller.kt]"]
  node_worker["Update checks"]
  node_mappingdao["Installed app mappings"]
end

subgraph group_support["Safety &amp; preferences"]
  node_virustotal["VirusTotal scan API<br/>[VirusTotalApi.kt]"]
  node_vtclient["VirusTotal client"]
  node_vtkeys["VirusTotal key rotation"]
  node_security["APK security checks<br/>[SecurityChecker.kt]"]
  node_preferences["Appearance &amp; downloads"]
end

node_user(("App user"))
node_github{{"GitHub"}}
node_android{{"Android package installer"}}
node_vtservice{{"VirusTotal service"}}

node_user -->|"opens"| node_main
node_main -->|"shows"| node_home
node_main -->|"shows"| node_search
node_main -->|"shows"| node_trending
node_home -->|"observes"| node_viewmodels
node_search -->|"filters"| node_viewmodels
node_trending -->|"observes"| node_viewmodels
node_viewmodels -->|"requests data"| node_repository
node_detail -->|"loads release"| node_repository
node_developer -->|"loads profile"| node_githubapi
node_repository -->|"uses client"| node_retrofit
node_retrofit -->|"creates API"| node_githubapi
node_githubapi -->|"requests repositories"| node_github
node_githubapi -->|"fetches releases"| node_github
node_github -->|"returns data"| node_githubapi
node_auth -->|"stores credentials"| node_tokens
node_retrofit -->|"reads token"| node_auth
node_repository -->|"caches repositories"| node_database
node_detail -->|"downloads APK"| node_download
node_download -->|"provides APK"| node_installer
node_installer -->|"launches install"| node_android
node_detail -->|"records install"| node_mappingdao
node_worker -->|"reads mappings"| node_mappingdao
node_worker -->|"checks installed version"| node_installer
node_worker -->|"fetches latest release"| node_repository
node_worker -->|"notifies updates"| node_user
node_detail -.->|"checks APK"| node_security
node_security -.->|"requests scan"| node_vtclient
node_vtclient -->|"gets API key"| node_vtkeys
node_vtclient -.->|"submits scan"| node_virustotal
node_virustotal -.->|"queries"| node_vtservice
node_preferences -->|"configures experience"| node_user

click node_main "https://github.com/samyak2403/repostore/blob/main/app/src/main/java/com/samyak/repostore/MainActivity.kt"
click node_home "https://github.com/samyak2403/repostore/blob/main/app/src/main/java/com/samyak/repostore/ui/fragment/HomeFragment.kt"
click node_search "https://github.com/samyak2403/repostore/blob/main/app/src/main/java/com/samyak/repostore/ui/fragment/SearchFragment.kt"
click node_trending "https://github.com/samyak2403/repostore/blob/main/app/src/main/java/com/samyak/repostore/ui/fragment/TrendingFragment.kt"
click node_viewmodels "https://github.com/samyak2403/repostore/tree/main/app/src/main/java/com/samyak/repostore/ui/viewmodel"
click node_detail "https://github.com/samyak2403/repostore/blob/main/app/src/main/java/com/samyak/repostore/ui/activity/DetailActivity.kt"
click node_developer "https://github.com/samyak2403/repostore/blob/main/app/src/main/java/com/samyak/repostore/ui/activity/AppDeveloperActivity.kt"
click node_repository "https://github.com/samyak2403/repostore/blob/main/app/src/main/java/com/samyak/repostore/data/repository/GitHubRepository.kt"
click node_retrofit "https://github.com/samyak2403/repostore/blob/main/app/src/main/java/com/samyak/repostore/data/api/RetrofitClient.kt"
click node_githubapi "https://github.com/samyak2403/repostore/blob/main/app/src/main/java/com/samyak/repostore/data/api/GitHubApi.kt"
click node_auth "https://github.com/samyak2403/repostore/blob/main/app/src/main/java/com/samyak/repostore/data/auth/GitHubAuth.kt"
click node_tokens "https://github.com/samyak2403/repostore/blob/main/app/src/main/java/com/samyak/repostore/data/auth/SecureTokenStorage.kt"
click node_database "https://github.com/samyak2403/repostore/blob/main/app/src/main/java/com/samyak/repostore/data/db/AppDatabase.kt"
click node_download "https://github.com/samyak2403/repostore/blob/main/app/src/main/java/com/samyak/repostore/util/MultiPartDownloader.kt"
click node_installer "https://github.com/samyak2403/repostore/blob/main/app/src/main/java/com/samyak/repostore/util/AppInstaller.kt"
click node_worker "https://github.com/samyak2403/repostore/blob/main/app/src/main/java/com/samyak/repostore/worker/UpdateCheckWorker.kt"
click node_mappingdao "https://github.com/samyak2403/repostore/blob/main/app/src/main/java/com/samyak/repostore/data/db/InstalledAppMappingDao.kt"
click node_virustotal "https://github.com/samyak2403/repostore/blob/main/app/src/main/java/com/samyak/repostore/data/api/VirusTotalApi.kt"
click node_vtclient "https://github.com/samyak2403/repostore/blob/main/app/src/main/java/com/samyak/repostore/data/api/VirusTotalClient.kt"
click node_vtkeys "https://github.com/samyak2403/repostore/blob/main/app/src/main/java/com/samyak/repostore/data/api/VirusTotalKeyManager.kt"
click node_security "https://github.com/samyak2403/repostore/blob/main/app/src/main/java/com/samyak/repostore/util/SecurityChecker.kt"
click node_preferences "https://github.com/samyak2403/repostore/blob/main/app/src/main/java/com/samyak/repostore/data/prefs/ThemePreferences.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_main,node_home,node_search,node_trending,node_viewmodels,node_detail,node_developer,node_user toneBlue
class node_repository,node_retrofit,node_githubapi,node_auth,node_tokens,node_database toneAmber
class node_download,node_installer,node_worker,node_mappingdao toneMint
class node_virustotal,node_vtclient,node_vtkeys,node_security,node_preferences toneRose
class node_github,node_android,node_vtservice toneIndigo
```

## Components

### Discovery & browsing

- [Main navigation](https://github.com/samyak2403/repostore/blob/main/app/src/main/java/com/samyak/repostore/MainActivity.kt): `app/src/main/java/com/samyak/repostore/MainActivity.kt`
- [Home discovery](https://github.com/samyak2403/repostore/blob/main/app/src/main/java/com/samyak/repostore/ui/fragment/HomeFragment.kt): `app/src/main/java/com/samyak/repostore/ui/fragment/HomeFragment.kt`
- [Search & filters](https://github.com/samyak2403/repostore/blob/main/app/src/main/java/com/samyak/repostore/ui/fragment/SearchFragment.kt): `app/src/main/java/com/samyak/repostore/ui/fragment/SearchFragment.kt`
- [Trending view](https://github.com/samyak2403/repostore/blob/main/app/src/main/java/com/samyak/repostore/ui/fragment/TrendingFragment.kt): `app/src/main/java/com/samyak/repostore/ui/fragment/TrendingFragment.kt`
- [Discovery viewmodels](https://github.com/samyak2403/repostore/tree/main/app/src/main/java/com/samyak/repostore/ui/viewmodel): `app/src/main/java/com/samyak/repostore/ui/viewmodel`
- [Release details](https://github.com/samyak2403/repostore/blob/main/app/src/main/java/com/samyak/repostore/ui/activity/DetailActivity.kt): `app/src/main/java/com/samyak/repostore/ui/activity/DetailActivity.kt`
- [Developer profiles](https://github.com/samyak2403/repostore/blob/main/app/src/main/java/com/samyak/repostore/ui/activity/AppDeveloperActivity.kt): `app/src/main/java/com/samyak/repostore/ui/activity/AppDeveloperActivity.kt`

### GitHub data & auth

- [GitHub repository](https://github.com/samyak2403/repostore/blob/main/app/src/main/java/com/samyak/repostore/data/repository/GitHubRepository.kt): `app/src/main/java/com/samyak/repostore/data/repository/GitHubRepository.kt`
- [GitHub client](https://github.com/samyak2403/repostore/blob/main/app/src/main/java/com/samyak/repostore/data/api/RetrofitClient.kt): `app/src/main/java/com/samyak/repostore/data/api/RetrofitClient.kt`
- [GitHub API](https://github.com/samyak2403/repostore/blob/main/app/src/main/java/com/samyak/repostore/data/api/GitHubApi.kt): `app/src/main/java/com/samyak/repostore/data/api/GitHubApi.kt`
- [OAuth sign-in](https://github.com/samyak2403/repostore/blob/main/app/src/main/java/com/samyak/repostore/data/auth/GitHubAuth.kt): `app/src/main/java/com/samyak/repostore/data/auth/GitHubAuth.kt`
- [Secure token storage](https://github.com/samyak2403/repostore/blob/main/app/src/main/java/com/samyak/repostore/data/auth/SecureTokenStorage.kt): `app/src/main/java/com/samyak/repostore/data/auth/SecureTokenStorage.kt`
- [Local Room database](https://github.com/samyak2403/repostore/blob/main/app/src/main/java/com/samyak/repostore/data/db/AppDatabase.kt): `app/src/main/java/com/samyak/repostore/data/db/AppDatabase.kt`

### Install & updates

- [APK downloader](https://github.com/samyak2403/repostore/blob/main/app/src/main/java/com/samyak/repostore/util/MultiPartDownloader.kt): `app/src/main/java/com/samyak/repostore/util/MultiPartDownloader.kt`
- [Package installer](https://github.com/samyak2403/repostore/blob/main/app/src/main/java/com/samyak/repostore/util/AppInstaller.kt): `app/src/main/java/com/samyak/repostore/util/AppInstaller.kt`
- [Update checks](https://github.com/samyak2403/repostore/blob/main/app/src/main/java/com/samyak/repostore/worker/UpdateCheckWorker.kt): `app/src/main/java/com/samyak/repostore/worker/UpdateCheckWorker.kt`
- [Installed app mappings](https://github.com/samyak2403/repostore/blob/main/app/src/main/java/com/samyak/repostore/data/db/InstalledAppMappingDao.kt): `app/src/main/java/com/samyak/repostore/data/db/InstalledAppMappingDao.kt`

### Safety & preferences

- [VirusTotal scan API](https://github.com/samyak2403/repostore/blob/main/app/src/main/java/com/samyak/repostore/data/api/VirusTotalApi.kt): `app/src/main/java/com/samyak/repostore/data/api/VirusTotalApi.kt`
- [VirusTotal client](https://github.com/samyak2403/repostore/blob/main/app/src/main/java/com/samyak/repostore/data/api/VirusTotalClient.kt): `app/src/main/java/com/samyak/repostore/data/api/VirusTotalClient.kt`
- [VirusTotal key rotation](https://github.com/samyak2403/repostore/blob/main/app/src/main/java/com/samyak/repostore/data/api/VirusTotalKeyManager.kt): `app/src/main/java/com/samyak/repostore/data/api/VirusTotalKeyManager.kt`
- [APK security checks](https://github.com/samyak2403/repostore/blob/main/app/src/main/java/com/samyak/repostore/util/SecurityChecker.kt): `app/src/main/java/com/samyak/repostore/util/SecurityChecker.kt`
- [Appearance & downloads](https://github.com/samyak2403/repostore/blob/main/app/src/main/java/com/samyak/repostore/data/prefs/ThemePreferences.kt): `app/src/main/java/com/samyak/repostore/data/prefs/ThemePreferences.kt`

### Other components

- **App user**
- **GitHub**
- **Android package installer**
- **VirusTotal service**

## Connections

- App user → Main navigation: opens
- Main navigation → Home discovery: shows
- Main navigation → Search & filters: shows
- Main navigation → Trending view: shows
- Home discovery → Discovery viewmodels: observes
- Search & filters → Discovery viewmodels: filters
- Trending view → Discovery viewmodels: observes
- Discovery viewmodels → GitHub repository: requests data
- Release details → GitHub repository: loads release
- Developer profiles → GitHub API: loads profile
- GitHub repository → GitHub client: uses client
- GitHub client → GitHub API: creates API
- GitHub API → GitHub: requests repositories
- GitHub API → GitHub: fetches releases
- GitHub → GitHub API: returns data
- OAuth sign-in → Secure token storage: stores credentials
- GitHub client → OAuth sign-in: reads token
- GitHub repository → Local Room database: caches repositories
- Release details → APK downloader: downloads APK
- APK downloader → Package installer: provides APK
- Package installer → Android package installer: launches install
- Release details → Installed app mappings: records install
- Update checks → Installed app mappings: reads mappings
- Update checks → Package installer: checks installed version
- Update checks → GitHub repository: fetches latest release
- Update checks → App user: notifies updates
- Release details → APK security checks: checks APK
- APK security checks → VirusTotal client: requests scan
- VirusTotal client → VirusTotal key rotation: gets API key
- VirusTotal client → VirusTotal scan API: submits scan
- VirusTotal scan API → VirusTotal service: queries
- Appearance & downloads → App user: configures experience
