# mattjhagen/movieboxpro-vega_firetv architecture

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

- Interactive diagram: https://gitdiagram.com/mattjhagen/movieboxpro-vega_firetv
- Repository: https://github.com/mattjhagen/movieboxpro-vega_firetv

## Overview

MovieBoxPro Vega is a partially implemented React Native Fire TV client. Users enter through the menu, choose a screen, browse home rows or search, and can reach a player component; home and search currently receive mock data from the API service. Settings expose local UI toggles and selections. The README lists Cast, downloads, subtitles, TV channels, and picture-in-picture as original-app capabilities, but the sampled Vega code does not establish their implementation. Decompiled Android files are reference material; the excerpts do not show their app-level runtime flow.

Main entry points: [`vega-app/src/App.tsx`](https://github.com/mattjhagen/movieboxpro-vega_firetv/blob/main/vega-app/src/App.tsx) (App shell), [`vega-app/src/services/api.ts`](https://github.com/mattjhagen/movieboxpro-vega_firetv/blob/main/vega-app/src/services/api.ts) (API service), [`vega-app/src/types/index.ts`](https://github.com/mattjhagen/movieboxpro-vega_firetv/blob/main/vega-app/src/types/index.ts) (Media types), [`vega-app/src/screens/HomeScreen.tsx`](https://github.com/mattjhagen/movieboxpro-vega_firetv/blob/main/vega-app/src/screens/HomeScreen.tsx) (Home screen)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_navigation["TV Navigation"]
  node_app["App shell<br/>[App.tsx]"]
  node_tiles["Menu tile data<br/>[tiles.tsx]"]
  node_tile["Focus tile<br/>[Tile.tsx]"]
end

subgraph group_discovery["Content Discovery"]
  node_home["Home screen<br/>[HomeScreen.tsx]"]
  node_search["Search screen<br/>[SearchScreen.tsx]"]
  node_contentrow["Content rows<br/>[ContentRow.tsx]"]
  node_api["API service<br/>[api.ts]"]
  node_types["Media types<br/>[index.ts]"]
end

subgraph group_playback["Playback and Settings"]
  node_player["Player screen<br/>[PlayerScreen.tsx]"]
  node_settings["Settings screen<br/>[SettingsScreen.tsx]"]
end

node_viewer(("TV viewer"))

node_viewer -->|"uses"| node_app
node_app -->|"reads"| node_tiles
node_app -->|"renders"| node_tile
node_app -->|"routes to"| node_home
node_app -->|"routes to"| node_search
node_app -->|"routes to"| node_settings
node_home -->|"requests content"| node_api
node_home -->|"renders"| node_contentrow
node_search -->|"searches"| node_api
node_player -->|"gets sources"| node_api
node_contentrow -->|"uses"| node_types
node_home -->|"uses"| node_types
node_search -->|"uses"| node_types
node_player -->|"uses"| node_types
node_api -->|"returns media"| node_types
node_api -.->|"may query backend"| node_viewer

click node_app "https://github.com/mattjhagen/movieboxpro-vega_firetv/blob/main/vega-app/src/App.tsx"
click node_tiles "https://github.com/mattjhagen/movieboxpro-vega_firetv/blob/main/vega-app/src/data/tiles.tsx"
click node_tile "https://github.com/mattjhagen/movieboxpro-vega_firetv/blob/main/vega-app/src/components/Tile.tsx"
click node_home "https://github.com/mattjhagen/movieboxpro-vega_firetv/blob/main/vega-app/src/screens/HomeScreen.tsx"
click node_search "https://github.com/mattjhagen/movieboxpro-vega_firetv/blob/main/vega-app/src/screens/SearchScreen.tsx"
click node_contentrow "https://github.com/mattjhagen/movieboxpro-vega_firetv/blob/main/vega-app/src/components/ContentRow.tsx"
click node_api "https://github.com/mattjhagen/movieboxpro-vega_firetv/blob/main/vega-app/src/services/api.ts"
click node_types "https://github.com/mattjhagen/movieboxpro-vega_firetv/blob/main/vega-app/src/types/index.ts"
click node_player "https://github.com/mattjhagen/movieboxpro-vega_firetv/blob/main/vega-app/src/screens/PlayerScreen.tsx"
click node_settings "https://github.com/mattjhagen/movieboxpro-vega_firetv/blob/main/vega-app/src/screens/SettingsScreen.tsx"

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_tiles,node_tile,node_viewer toneBlue
class node_home,node_search,node_contentrow,node_api,node_types toneAmber
class node_player,node_settings toneMint
```

## Components

### TV Navigation

- [App shell](https://github.com/mattjhagen/movieboxpro-vega_firetv/blob/main/vega-app/src/App.tsx): `vega-app/src/App.tsx`
- [Menu tile data](https://github.com/mattjhagen/movieboxpro-vega_firetv/blob/main/vega-app/src/data/tiles.tsx): `vega-app/src/data/tiles.tsx`
- [Focus tile](https://github.com/mattjhagen/movieboxpro-vega_firetv/blob/main/vega-app/src/components/Tile.tsx): `vega-app/src/components/Tile.tsx`

### Content Discovery

- [Home screen](https://github.com/mattjhagen/movieboxpro-vega_firetv/blob/main/vega-app/src/screens/HomeScreen.tsx): `vega-app/src/screens/HomeScreen.tsx`
- [Search screen](https://github.com/mattjhagen/movieboxpro-vega_firetv/blob/main/vega-app/src/screens/SearchScreen.tsx): `vega-app/src/screens/SearchScreen.tsx`
- [Content rows](https://github.com/mattjhagen/movieboxpro-vega_firetv/blob/main/vega-app/src/components/ContentRow.tsx): `vega-app/src/components/ContentRow.tsx`
- [API service](https://github.com/mattjhagen/movieboxpro-vega_firetv/blob/main/vega-app/src/services/api.ts): `vega-app/src/services/api.ts`
- [Media types](https://github.com/mattjhagen/movieboxpro-vega_firetv/blob/main/vega-app/src/types/index.ts): `vega-app/src/types/index.ts`

### Playback and Settings

- [Player screen](https://github.com/mattjhagen/movieboxpro-vega_firetv/blob/main/vega-app/src/screens/PlayerScreen.tsx): `vega-app/src/screens/PlayerScreen.tsx`
- [Settings screen](https://github.com/mattjhagen/movieboxpro-vega_firetv/blob/main/vega-app/src/screens/SettingsScreen.tsx): `vega-app/src/screens/SettingsScreen.tsx`

### Other components

- **TV viewer**

## Connections

- TV viewer → App shell: uses (evidence: `README.md`)
- App shell → Menu tile data: reads (evidence: `vega-app/src/App.tsx`)
- App shell → Focus tile: renders (evidence: `vega-app/src/App.tsx`)
- App shell → Home screen: routes to (evidence: `vega-app/src/App.tsx`)
- App shell → Search screen: routes to (evidence: `vega-app/src/App.tsx`)
- App shell → Settings screen: routes to (evidence: `vega-app/src/App.tsx`)
- Home screen → API service: requests content (evidence: `vega-app/src/screens/HomeScreen.tsx`)
- Home screen → Content rows: renders (evidence: `vega-app/src/screens/HomeScreen.tsx`)
- Search screen → API service: searches (evidence: `vega-app/src/screens/SearchScreen.tsx`)
- Player screen → API service: gets sources (evidence: `vega-app/src/screens/PlayerScreen.tsx`)
- Content rows → Media types: uses (evidence: `vega-app/src/components/ContentRow.tsx`)
- Home screen → Media types: uses (evidence: `vega-app/src/screens/HomeScreen.tsx`)
- Search screen → Media types: uses (evidence: `vega-app/src/screens/SearchScreen.tsx`)
- Player screen → Media types: uses (evidence: `vega-app/src/screens/PlayerScreen.tsx`)
- API service → Media types: returns media (evidence: `vega-app/src/services/api.ts`)
- API service → TV viewer: may query backend
