# ziroo-cf/waha architecture

> Architecture diagram of the GitHub repository ziroo-cf/waha, 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/ziroo-cf/waha
- Repository: https://github.com/ziroo-cf/waha

## Overview

Waha is an Arabic-language Android video browsing and playback app. Users browse category-filtered videos or search the catalog, select a video, and watch it in an embedded player; the app also exposes saved videos, watch history, recent searches, and settings. The graph includes those documented-by-tree product areas, but several internal connections cannot be confirmed from the available excerpts. In particular, the home view-model, playback extraction, and preference stores are not shown wired together, so those links are omitted.

Main entry points: [`app/src/main/java/com/waha/ui/screens/Wahaapp.kt`](https://github.com/ziroo-cf/waha/blob/main/app/src/main/java/com/waha/ui/screens/Wahaapp.kt) (App navigation), [`app/src/main/java/com/waha/MainActivity.kt`](https://github.com/ziroo-cf/waha/blob/main/app/src/main/java/com/waha/MainActivity.kt) (Main activity), [`app/src/main/java/com/waha/ui/screens/WahaHomeScreen.kt`](https://github.com/ziroo-cf/waha/blob/main/app/src/main/java/com/waha/ui/screens/WahaHomeScreen.kt) (Home screen), [`app/src/main/java/com/waha/data/Videorepository.kt`](https://github.com/ziroo-cf/waha/blob/main/app/src/main/java/com/waha/data/Videorepository.kt) (Video repository)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_shell["App shell"]
  node_activity["Main activity<br/>[MainActivity.kt]"]
  node_app["App navigation<br/>[Wahaapp.kt]"]
  node_theme["Theme colors<br/>[Color.kt]"]
  node_settings["Settings screen<br/>[Settingsscreen.kt]"]
  node_window["Window layout<br/>[WahaWindow.kt]"]
end

subgraph group_discovery["Video discovery"]
  node_home["Home screen<br/>[WahaHomeScreen.kt]"]
  node_homevm["Home view-model"]
  node_search["Search overlay<br/>[Searchoverlay.kt]"]
  node_savedui["Saved screen"]
  node_historyui["History screen"]
end

subgraph group_playback["Playback"]
  node_player["Video player"]
  node_piped["Piped API<br/>[Pipedapi.kt]"]
  node_extractor["YouTube extractor"]
end

subgraph group_state["Data and preferences"]
  node_models["Video models<br/>[Videomodels.kt]"]
  node_repository["Video repository<br/>[Videorepository.kt]"]
  node_supabase["Supabase client<br/>[Supabaseclient.kt]"]
  node_savedstore["Saved-video store"]
  node_recentstore["Recent-search store"]
  node_historystore["Watch-history store"]
  node_themestore["Theme preferences"]
end

node_user(("Viewer"))
node_catalog[("Supabase catalog")]

node_user -->|"opens app"| node_activity
node_activity -->|"launches"| node_app
node_activity -->|"initializes and reads"| node_themestore
node_app -->|"shows"| node_home
node_app -->|"opens"| node_search
node_app -->|"shows"| node_savedui
node_app -->|"shows"| node_historyui
node_app -->|"shows"| node_settings
node_app -->|"opens"| node_player
node_app -->|"initializes"| node_savedstore
node_app -->|"initializes"| node_recentstore
node_app -->|"initializes"| node_historystore
node_search -->|"records searches"| node_recentstore
node_repository -->|"queries"| node_supabase
node_repository -->|"decodes rows"| node_models
node_supabase -.->|"queries approved videos"| node_catalog
node_player -->|"records playback"| node_historystore
node_home -->|"reads saved state"| node_savedstore
node_user -.->|"browses"| node_home

click node_activity "https://github.com/ziroo-cf/waha/blob/main/app/src/main/java/com/waha/MainActivity.kt"
click node_app "https://github.com/ziroo-cf/waha/blob/main/app/src/main/java/com/waha/ui/screens/Wahaapp.kt"
click node_theme "https://github.com/ziroo-cf/waha/blob/main/app/src/main/java/com/waha/ui/theme/Color.kt"
click node_home "https://github.com/ziroo-cf/waha/blob/main/app/src/main/java/com/waha/ui/screens/WahaHomeScreen.kt"
click node_homevm "https://github.com/ziroo-cf/waha/blob/main/app/src/main/java/com/waha/ui/screens/Wahahomeviewmodel.kt"
click node_search "https://github.com/ziroo-cf/waha/blob/main/app/src/main/java/com/waha/ui/screens/Searchoverlay.kt"
click node_savedui "https://github.com/ziroo-cf/waha/blob/main/app/src/main/java/com/waha/ui/screens/Savedvideosscreen.kt"
click node_historyui "https://github.com/ziroo-cf/waha/blob/main/app/src/main/java/com/waha/ui/screens/Watchhistoryscreen.kt"
click node_settings "https://github.com/ziroo-cf/waha/blob/main/app/src/main/java/com/waha/ui/screens/Settingsscreen.kt"
click node_window "https://github.com/ziroo-cf/waha/blob/main/app/src/main/java/com/waha/ui/screens/WahaWindow.kt"
click node_player "https://github.com/ziroo-cf/waha/blob/main/app/src/main/java/com/waha/ui/screens/VideoPlayerModal.kt"
click node_piped "https://github.com/ziroo-cf/waha/blob/main/app/src/main/java/com/waha/data/Pipedapi.kt"
click node_extractor "https://github.com/ziroo-cf/waha/blob/main/app/src/main/java/com/waha/data/Youtubeextractor.kt"
click node_models "https://github.com/ziroo-cf/waha/blob/main/app/src/main/java/com/waha/data/Videomodels.kt"
click node_repository "https://github.com/ziroo-cf/waha/blob/main/app/src/main/java/com/waha/data/Videorepository.kt"
click node_supabase "https://github.com/ziroo-cf/waha/blob/main/app/src/main/java/com/waha/data/Supabaseclient.kt"
click node_savedstore "https://github.com/ziroo-cf/waha/blob/main/app/src/main/java/com/waha/data/Savedvideosstore.kt"
click node_recentstore "https://github.com/ziroo-cf/waha/blob/main/app/src/main/java/com/waha/data/Recentsearchesstore.kt"
click node_historystore "https://github.com/ziroo-cf/waha/blob/main/app/src/main/java/com/waha/data/Watchhistorystore.kt"
click node_themestore "https://github.com/ziroo-cf/waha/blob/main/app/src/main/java/com/waha/data/Themepreferencestore.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_app,node_theme,node_settings,node_window,node_user toneBlue
class node_home,node_homevm,node_search,node_savedui,node_historyui,node_catalog toneAmber
class node_player,node_piped,node_extractor toneMint
class node_models,node_repository,node_supabase,node_savedstore,node_recentstore,node_historystore,node_themestore toneRose
```

## Components

### App shell

- [Main activity](https://github.com/ziroo-cf/waha/blob/main/app/src/main/java/com/waha/MainActivity.kt): `app/src/main/java/com/waha/MainActivity.kt`
- [App navigation](https://github.com/ziroo-cf/waha/blob/main/app/src/main/java/com/waha/ui/screens/Wahaapp.kt): `app/src/main/java/com/waha/ui/screens/Wahaapp.kt`
- [Theme colors](https://github.com/ziroo-cf/waha/blob/main/app/src/main/java/com/waha/ui/theme/Color.kt): `app/src/main/java/com/waha/ui/theme/Color.kt`
- [Settings screen](https://github.com/ziroo-cf/waha/blob/main/app/src/main/java/com/waha/ui/screens/Settingsscreen.kt): `app/src/main/java/com/waha/ui/screens/Settingsscreen.kt`
- [Window layout](https://github.com/ziroo-cf/waha/blob/main/app/src/main/java/com/waha/ui/screens/WahaWindow.kt): `app/src/main/java/com/waha/ui/screens/WahaWindow.kt`

### Video discovery

- [Home screen](https://github.com/ziroo-cf/waha/blob/main/app/src/main/java/com/waha/ui/screens/WahaHomeScreen.kt): `app/src/main/java/com/waha/ui/screens/WahaHomeScreen.kt`
- [Home view-model](https://github.com/ziroo-cf/waha/blob/main/app/src/main/java/com/waha/ui/screens/Wahahomeviewmodel.kt): `app/src/main/java/com/waha/ui/screens/Wahahomeviewmodel.kt`
- [Search overlay](https://github.com/ziroo-cf/waha/blob/main/app/src/main/java/com/waha/ui/screens/Searchoverlay.kt): `app/src/main/java/com/waha/ui/screens/Searchoverlay.kt`
- [Saved screen](https://github.com/ziroo-cf/waha/blob/main/app/src/main/java/com/waha/ui/screens/Savedvideosscreen.kt): `app/src/main/java/com/waha/ui/screens/Savedvideosscreen.kt`
- [History screen](https://github.com/ziroo-cf/waha/blob/main/app/src/main/java/com/waha/ui/screens/Watchhistoryscreen.kt): `app/src/main/java/com/waha/ui/screens/Watchhistoryscreen.kt`

### Playback

- [Video player](https://github.com/ziroo-cf/waha/blob/main/app/src/main/java/com/waha/ui/screens/VideoPlayerModal.kt): `app/src/main/java/com/waha/ui/screens/VideoPlayerModal.kt`
- [Piped API](https://github.com/ziroo-cf/waha/blob/main/app/src/main/java/com/waha/data/Pipedapi.kt): `app/src/main/java/com/waha/data/Pipedapi.kt`
- [YouTube extractor](https://github.com/ziroo-cf/waha/blob/main/app/src/main/java/com/waha/data/Youtubeextractor.kt): `app/src/main/java/com/waha/data/Youtubeextractor.kt`

### Data and preferences

- [Video models](https://github.com/ziroo-cf/waha/blob/main/app/src/main/java/com/waha/data/Videomodels.kt): `app/src/main/java/com/waha/data/Videomodels.kt`
- [Video repository](https://github.com/ziroo-cf/waha/blob/main/app/src/main/java/com/waha/data/Videorepository.kt): `app/src/main/java/com/waha/data/Videorepository.kt`
- [Supabase client](https://github.com/ziroo-cf/waha/blob/main/app/src/main/java/com/waha/data/Supabaseclient.kt): `app/src/main/java/com/waha/data/Supabaseclient.kt`
- [Saved-video store](https://github.com/ziroo-cf/waha/blob/main/app/src/main/java/com/waha/data/Savedvideosstore.kt): `app/src/main/java/com/waha/data/Savedvideosstore.kt`
- [Recent-search store](https://github.com/ziroo-cf/waha/blob/main/app/src/main/java/com/waha/data/Recentsearchesstore.kt): `app/src/main/java/com/waha/data/Recentsearchesstore.kt`
- [Watch-history store](https://github.com/ziroo-cf/waha/blob/main/app/src/main/java/com/waha/data/Watchhistorystore.kt): `app/src/main/java/com/waha/data/Watchhistorystore.kt`
- [Theme preferences](https://github.com/ziroo-cf/waha/blob/main/app/src/main/java/com/waha/data/Themepreferencestore.kt): `app/src/main/java/com/waha/data/Themepreferencestore.kt`

### Other components

- **Viewer**
- **Supabase catalog**

## Connections

- Viewer → Main activity: opens app (evidence: `app/src/main/java/com/waha/MainActivity.kt`)
- Main activity → App navigation: launches (evidence: `app/src/main/java/com/waha/MainActivity.kt`)
- Main activity → Theme preferences: initializes and reads (evidence: `app/src/main/java/com/waha/MainActivity.kt`)
- App navigation → Home screen: shows (evidence: `app/src/main/java/com/waha/ui/screens/Wahaapp.kt`)
- App navigation → Search overlay: opens (evidence: `app/src/main/java/com/waha/ui/screens/Wahaapp.kt`)
- App navigation → Saved screen: shows (evidence: `app/src/main/java/com/waha/ui/screens/Wahaapp.kt`)
- App navigation → History screen: shows (evidence: `app/src/main/java/com/waha/ui/screens/Wahaapp.kt`)
- App navigation → Settings screen: shows (evidence: `app/src/main/java/com/waha/ui/screens/Wahaapp.kt`)
- App navigation → Video player: opens (evidence: `app/src/main/java/com/waha/ui/screens/Wahaapp.kt`)
- App navigation → Saved-video store: initializes (evidence: `app/src/main/java/com/waha/ui/screens/Wahaapp.kt`)
- App navigation → Recent-search store: initializes (evidence: `app/src/main/java/com/waha/ui/screens/Wahaapp.kt`)
- App navigation → Watch-history store: initializes (evidence: `app/src/main/java/com/waha/ui/screens/Wahaapp.kt`)
- Search overlay → Recent-search store: records searches (evidence: `app/src/main/java/com/waha/ui/screens/Searchoverlay.kt`)
- Video repository → Supabase client: queries (evidence: `app/src/main/java/com/waha/data/Videorepository.kt`)
- Video repository → Video models: decodes rows (evidence: `app/src/main/java/com/waha/data/Videorepository.kt`)
- Supabase client → Supabase catalog: queries approved videos
- Video player → Watch-history store: records playback (evidence: `app/src/main/java/com/waha/ui/screens/VideoPlayerModal.kt`)
- Home screen → Saved-video store: reads saved state (evidence: `app/src/main/java/com/waha/ui/screens/WahaHomeScreen.kt`)
- Viewer → Home screen: browses
