# vega-org/vega-app architecture

> Architecture diagram of the GitHub repository vega-org/vega-app, 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/vega-org/vega-app
- Repository: https://github.com/vega-org/vega-app

## Overview

Vega is an Android media-streaming and casting app. The main user journey is to browse or search provider-sourced media, open a title, and stream it locally or cast it; users can also download media and manage a watchlist. The app additionally supports custom provider plugins, external players/downloaders, and desktop sync. The graph combines documented capabilities with relationships visible in the supplied excerpts and SOURCE INDEX; unsampled implementation details are represented at subsystem level, without asserting unverified call paths.

Main entry points: [`src/screens/home/Player.tsx`](https://github.com/vega-org/vega-app/blob/main/src/screens/home/Player.tsx) (Local player), [`src/App.tsx`](https://github.com/vega-org/vega-app/blob/main/src/App.tsx) (App navigation), [`src/screens/SearchResults.tsx`](https://github.com/vega-org/vega-app/blob/main/src/screens/SearchResults.tsx) (Search results), [`src/lib/services/ProviderManager.ts`](https://github.com/vega-org/vega-app/blob/main/src/lib/services/ProviderManager.ts) (Provider manager)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["App and discovery"]
  node_app["App navigation<br/>[App.tsx]"]
  node_search["Search<br/>[Search.tsx]"]
  node_results["Search results<br/>[SearchResults.tsx]"]
  node_title["Title details<br/>[Info.tsx]"]
end

subgraph group_providers["Providers and persistence"]
  node_provider_sources["Provider sources"]
  node_provider_manager["Provider manager<br/>[ProviderManager.ts]"]
  node_extension_manager["Plugin manager"]
  node_provider_storage[("Provider storage")]
  node_storage[("App storage<br/>[StorageService.ts]")]
end

subgraph group_playback["Playback and casting"]
  node_player["Local player<br/>[Player.tsx]"]
  node_stream["Stream selection<br/>[useStream.ts]"]
  node_video_controls["Video controls<br/>[VideoPlayer.tsx]"]
  node_remote_manager["Remote playback"]
  node_remote_delivery["Remote delivery"]
  node_native_delivery["Android delivery"]
  node_remote_device(("Cast or DLNA device"))
end

subgraph group_library["Downloads and sync"]
  node_watchlist[("Watchlist")]
  node_downloads["Download manager<br/>[downloadManager.ts]"]
  node_download_backends["Download backends<br/>[registry.ts]"]
  node_download_storage[("Download records")]
  node_sync["Desktop sync<br/>[syncService.ts]"]
end

node_user(("Viewer"))
node_desktop(("Desktop app"))

node_user -->|"opens"| node_app
node_app -->|"routes to"| node_search
node_search -->|"submits query"| node_results
node_results -->|"requests providers"| node_provider_manager
node_provider_manager -->|"uses plugins"| node_extension_manager
node_provider_manager -->|"reads provider data"| node_provider_storage
node_provider_sources -->|"updates sources"| node_provider_storage
node_provider_storage -->|"persists data"| node_storage
node_results -->|"opens title"| node_title
node_title -->|"starts playback"| node_player
node_player -->|"selects stream"| node_stream
node_player -->|"renders controls"| node_video_controls
node_player -.->|"starts casting"| node_remote_manager
node_remote_manager -->|"prepares delivery"| node_remote_delivery
node_remote_delivery -.->|"uses native module"| node_native_delivery
node_remote_manager -->|"casts media"| node_remote_device
node_user -->|"manages titles"| node_watchlist
node_user -->|"requests download"| node_downloads
node_downloads -->|"selects backend"| node_download_backends
node_downloads -->|"updates records"| node_download_storage
node_download_storage -->|"persists data"| node_storage
node_app -->|"starts sync"| node_sync
node_sync -->|"syncs with"| node_desktop

click node_app "https://github.com/vega-org/vega-app/blob/main/src/App.tsx"
click node_search "https://github.com/vega-org/vega-app/blob/main/src/screens/Search.tsx"
click node_results "https://github.com/vega-org/vega-app/blob/main/src/screens/SearchResults.tsx"
click node_title "https://github.com/vega-org/vega-app/blob/main/src/screens/home/Info.tsx"
click node_provider_sources "https://github.com/vega-org/vega-app/blob/main/src/screens/settings/components/ProviderSourceManager.tsx"
click node_provider_manager "https://github.com/vega-org/vega-app/blob/main/src/lib/services/ProviderManager.ts"
click node_extension_manager "https://github.com/vega-org/vega-app/blob/main/src/lib/services/ExtensionManager.ts"
click node_provider_storage "https://github.com/vega-org/vega-app/blob/main/src/lib/storage/extensionStorage.ts"
click node_storage "https://github.com/vega-org/vega-app/blob/main/src/lib/storage/StorageService.ts"
click node_player "https://github.com/vega-org/vega-app/blob/main/src/screens/home/Player.tsx"
click node_stream "https://github.com/vega-org/vega-app/blob/main/src/lib/hooks/useStream.ts"
click node_video_controls "https://github.com/vega-org/vega-app/blob/main/src/components/media-console/VideoPlayer.tsx"
click node_remote_manager "https://github.com/vega-org/vega-app/blob/main/src/lib/remote/remotePlaybackManager.ts"
click node_remote_delivery "https://github.com/vega-org/vega-app/blob/main/src/lib/remote/remoteDeliveryService.ts"
click node_native_delivery "https://github.com/vega-org/vega-app/blob/main/native-src/android/com/vega/RemoteDeliveryModule.kt"
click node_watchlist "https://github.com/vega-org/vega-app/blob/main/src/lib/storage/WatchListStorage.ts"
click node_downloads "https://github.com/vega-org/vega-app/blob/main/src/lib/downloadManager.ts"
click node_download_backends "https://github.com/vega-org/vega-app/blob/main/src/lib/downloadBackends/registry.ts"
click node_download_storage "https://github.com/vega-org/vega-app/blob/main/src/lib/storage/DownloadsStorage.ts"
click node_sync "https://github.com/vega-org/vega-app/blob/main/src/lib/sync/syncService.ts"

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_search,node_results,node_title,node_user toneBlue
class node_provider_sources,node_provider_manager,node_extension_manager,node_provider_storage,node_storage toneAmber
class node_player,node_stream,node_video_controls,node_remote_manager,node_remote_delivery,node_native_delivery,node_remote_device toneMint
class node_watchlist,node_downloads,node_download_backends,node_download_storage,node_sync toneRose
class node_desktop toneIndigo
```

## Components

### App and discovery

- [App navigation](https://github.com/vega-org/vega-app/blob/main/src/App.tsx): `src/App.tsx`
- [Search](https://github.com/vega-org/vega-app/blob/main/src/screens/Search.tsx): `src/screens/Search.tsx`
- [Search results](https://github.com/vega-org/vega-app/blob/main/src/screens/SearchResults.tsx): `src/screens/SearchResults.tsx`
- [Title details](https://github.com/vega-org/vega-app/blob/main/src/screens/home/Info.tsx): `src/screens/home/Info.tsx`

### Providers and persistence

- [Provider sources](https://github.com/vega-org/vega-app/blob/main/src/screens/settings/components/ProviderSourceManager.tsx): `src/screens/settings/components/ProviderSourceManager.tsx`
- [Provider manager](https://github.com/vega-org/vega-app/blob/main/src/lib/services/ProviderManager.ts): `src/lib/services/ProviderManager.ts`
- [Plugin manager](https://github.com/vega-org/vega-app/blob/main/src/lib/services/ExtensionManager.ts): `src/lib/services/ExtensionManager.ts`
- [Provider storage](https://github.com/vega-org/vega-app/blob/main/src/lib/storage/extensionStorage.ts): `src/lib/storage/extensionStorage.ts`
- [App storage](https://github.com/vega-org/vega-app/blob/main/src/lib/storage/StorageService.ts): `src/lib/storage/StorageService.ts`

### Playback and casting

- [Local player](https://github.com/vega-org/vega-app/blob/main/src/screens/home/Player.tsx): `src/screens/home/Player.tsx`
- [Stream selection](https://github.com/vega-org/vega-app/blob/main/src/lib/hooks/useStream.ts): `src/lib/hooks/useStream.ts`
- [Video controls](https://github.com/vega-org/vega-app/blob/main/src/components/media-console/VideoPlayer.tsx): `src/components/media-console/VideoPlayer.tsx`
- [Remote playback](https://github.com/vega-org/vega-app/blob/main/src/lib/remote/remotePlaybackManager.ts): `src/lib/remote/remotePlaybackManager.ts`
- [Remote delivery](https://github.com/vega-org/vega-app/blob/main/src/lib/remote/remoteDeliveryService.ts): `src/lib/remote/remoteDeliveryService.ts`
- [Android delivery](https://github.com/vega-org/vega-app/blob/main/native-src/android/com/vega/RemoteDeliveryModule.kt): `native-src/android/com/vega/RemoteDeliveryModule.kt`
- **Cast or DLNA device**

### Downloads and sync

- [Watchlist](https://github.com/vega-org/vega-app/blob/main/src/lib/storage/WatchListStorage.ts): `src/lib/storage/WatchListStorage.ts`
- [Download manager](https://github.com/vega-org/vega-app/blob/main/src/lib/downloadManager.ts): `src/lib/downloadManager.ts`
- [Download backends](https://github.com/vega-org/vega-app/blob/main/src/lib/downloadBackends/registry.ts): `src/lib/downloadBackends/registry.ts`
- [Download records](https://github.com/vega-org/vega-app/blob/main/src/lib/storage/DownloadsStorage.ts): `src/lib/storage/DownloadsStorage.ts`
- [Desktop sync](https://github.com/vega-org/vega-app/blob/main/src/lib/sync/syncService.ts): `src/lib/sync/syncService.ts`

### Other components

- **Viewer**
- **Desktop app**

## Connections

- Viewer → App navigation: opens (evidence: `README.md`)
- App navigation → Search: routes to (evidence: `src/App.tsx`)
- Search → Search results: submits query (evidence: `README.md`)
- Search results → Provider manager: requests providers (evidence: `src/screens/SearchResults.tsx`)
- Provider manager → Plugin manager: uses plugins (evidence: `src/lib/services/ProviderManager.ts`)
- Provider manager → Provider storage: reads provider data (evidence: `src/lib/services/ProviderManager.ts`)
- Provider sources → Provider storage: updates sources (evidence: `src/screens/settings/components/ProviderSourceManager.tsx`)
- Provider storage → App storage: persists data (evidence: `src/lib/storage/extensionStorage.ts`)
- Search results → Title details: opens title (evidence: `README.md`)
- Title details → Local player: starts playback (evidence: `README.md`)
- Local player → Stream selection: selects stream (evidence: `src/screens/home/Player.tsx`)
- Local player → Video controls: renders controls (evidence: `src/screens/home/Player.tsx`)
- Local player → Remote playback: starts casting (evidence: `src/screens/home/Player.tsx`)
- Remote playback → Remote delivery: prepares delivery (evidence: `src/lib/remote/remotePlaybackManager.ts`)
- Remote delivery → Android delivery: uses native module
- Remote playback → Cast or DLNA device: casts media (evidence: `README.md`)
- Viewer → Watchlist: manages titles (evidence: `README.md`)
- Viewer → Download manager: requests download (evidence: `README.md`)
- Download manager → Download backends: selects backend (evidence: `src/lib/downloadManager.ts`)
- Download manager → Download records: updates records (evidence: `src/lib/downloadManager.ts`)
- Download records → App storage: persists data (evidence: `src/lib/storage/index.ts`)
- App navigation → Desktop sync: starts sync (evidence: `src/App.tsx`)
- Desktop sync → Desktop app: syncs with (evidence: `README.md`)
