# flixclusiveorg/flixclusive architecture

> Architecture diagram of the GitHub repository flixclusiveorg/flixclusive, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-08-29). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/flixclusiveorg/flixclusive
- Repository: https://github.com/flixclusiveorg/flixclusive

## Overview

##### Project type and purpose
- This is an Android application (mobile + TV) called “Flixclusive” using a modularized, Clean-Architecture approach.
- It uses Jetpack Compose for UI, Hilt for DI, Room for local persistence, DataStore for preferences, Retrofit/OkHttp for network, and a background update service.

##### File structure and layers
- Top-level Gradle modules:
- app – hosts the Android application, entry points (MobileActivity, TvActivity), navigation setup, Crash reporting, BuildConfig
- service – background Android Service for update notifications
- core – cross-cutting libraries (network, database, datastore, presentation, UI components, testing, navigation, drawables, strings)
- domain – business-logic use-case modules (catalog, database, provider, tmdb)
- data – repository implementations for domain (database, provider, tmdb)
- feature – UI feature modules (per-screen: mobile home, film, search, settings, etc., and TV features)
- The project follows MVVM + Clean Architecture:
UI (feature & core/presentation) → ViewModel → Domain use-cases → Data repositories → Data sources (Room, DataStore, network).

##### README insights
- Confirms it’s purely a streaming-links client (no hosting).
- CI/Quality badges indicate use of CI pipelines (GitHub Actions) and SonarCloud.

##### Final advice
- Be exhaustive: include each module and major sub-component (DI modules, network monitors, CrashHandler, updater service).
- Modules logically (e.g., all domain modules in one “Domain Layer”).

## Diagram (Mermaid)

```mermaid
flowchart TD
    %% UI Layer
    subgraph "UI Layer"
        direction TB
        subgraph "Mobile App" 
            direction TB
            MA["MobileActivity"]:::ui
            MAVM["MobileAppViewModel"]:::ui
            MH["HomeScreen (Mobile)"]:::ui
            MF["FilmScreen (Mobile)"]:::ui
        end
        subgraph "TV App"
            direction TB
            TA["TvActivity"]:::ui
            TVA["TvApp"]:::ui
            TH["HomeScreen (TV)"]:::ui
            TF["FilmScreen (TV)"]:::ui
        end
    end

    %% Presentation Layer
    subgraph "Presentation Layer"
        direction TB
        CPI["core/ui/common"]:::presentation
        CPP["core/presentation"]:::presentation
        CNV["core/navigation"]:::presentation
    end

    %% Domain Layer
    subgraph "Domain Layer"
        direction TB
        DCAT["domain/catalog use-cases"]:::domain
        DDB["domain/database use-cases"]:::domain
        DPROV["domain/provider use-cases"]:::domain
        DTMDB["domain/tmdb use-cases"]:::domain
    end

    %% Data Layer
    subgraph "Data Layer"
        direction TB
        RREP["data/database repository"]:::data
        PREP["data/provider repository"]:::data
        TREP["data/tmdb repository"]:::data
    end

    %% DataSources Layer
    subgraph "DataSources"
        direction TB
        ROOM["Room (core/database)"]:::datasource
        DS["DataStore (core/datastore)"]:::datasource
        NET["Retrofit/OkHttp (core/network)"]:::datasource
    end

    %% Service Layer
    subgraph "Service Layer"
        direction TB
        UPS["AppUpdaterService"]:::service
    end

    %% External Services
    subgraph "External Services"
        direction TB
        TMDB["TMDB API"]:::external
        GITHUB["GitHub API"]:::external
    end

    %% Connections
    MA -->|uses| MAVM
    MAVM -->|calls| DCAT
    MAVM --> DDB
    MAVM --> DPROV
    MAVM --> DTMDB

    TA -->|uses| TVA
    TVA -->|calls| DCAT
    TVA --> DDB
    TVA --> DPROV
    TVA --> DTMDB

    MH -->|updates UI| MAVM
    MF --> MAVM
    TH --> TVA
    TF --> TVA

    CPI -->|provides composables| MA
    CPP -->|provides themes| MA
    CNV -->|provides nav| MA

    DCAT -->|executes| RREP
    DDB -->|executes| RREP
    DPROV -->|executes| PREP
    DTMDB -->|executes| TREP

    RREP -->|reads/writes| ROOM
    PREP -->|reads| DS
    TREP -->|calls| NET

    ROOM -->|persist| ROOM
    DS -->|persist| DS
    NET -->|http calls| TMDB
    NET -->|http calls| GITHUB

    UPS -->|fetch updates| GITHUB
    UPS -->|sends notification| MA

    %% Click Events
    click MA "https://github.com/flixclusiveorg/flixclusive/blob/master/app/src/main/kotlin/com/flixclusive/mobile/MobileActivity.kt"
    click MAVM "https://github.com/flixclusiveorg/flixclusive/blob/master/app/src/main/kotlin/com/flixclusive/mobile/MobileAppViewModel.kt"
    click TA "https://github.com/flixclusiveorg/flixclusive/blob/master/app/src/main/kotlin/com/flixclusive/tv/TvActivity.kt"
    click TVA "https://github.com/flixclusiveorg/flixclusive/blob/master/app/src/main/kotlin/com/flixclusive/tv/TvApp.kt"
    click UPS "https://github.com/flixclusiveorg/flixclusive/blob/master/service/src/main/kotlin/com/flixclusive/service/update/AppUpdaterService.kt"
    click NET "https://github.com/flixclusiveorg/flixclusive/tree/master/core/network/src/main/kotlin/com/flixclusive/core/network"
    click ROOM "https://github.com/flixclusiveorg/flixclusive/tree/master/core/database/src/main/kotlin/com/flixclusive/core/database"
    click DS "https://github.com/flixclusiveorg/flixclusive/tree/master/core/datastore/src/main/kotlin/com/flixclusive/core/datastore"
    click CPI "https://github.com/flixclusiveorg/flixclusive/tree/master/core/ui/common/src/main/kotlin/com/flixclusive/core/ui/common"
    click CPP "https://github.com/flixclusiveorg/flixclusive/tree/master/core/presentation/src/main/kotlin/com/flixclusive/core/presentation"
    click CNV "https://github.com/flixclusiveorg/flixclusive/tree/master/core/navigation/"
    click DCAT "https://github.com/flixclusiveorg/flixclusive/tree/master/domain/catalog/src/main/kotlin/com/flixclusive/domain/catalog/usecase"
    click DDB "https://github.com/flixclusiveorg/flixclusive/tree/master/domain/database/src/main/kotlin/com/flixclusive/domain/database/usecase"
    click DPROV "https://github.com/flixclusiveorg/flixclusive/tree/master/domain/provider/src/main/kotlin/com/flixclusive/domain/provider/usecase"
    click DTMDB "https://github.com/flixclusiveorg/flixclusive/tree/master/domain/tmdb/src/main/kotlin/com/flixclusive/domain/tmdb/usecase"
    click RREP "https://github.com/flixclusiveorg/flixclusive/tree/master/data/database/src/main/kotlin/com/flixclusive/data/database/repository"
    click PREP "https://github.com/flixclusiveorg/flixclusive/tree/master/data/provider/src/main/kotlin/com/flixclusive/data/provider/repository"
    click TREP "https://github.com/flixclusiveorg/flixclusive/tree/master/data/tmdb/src/main/kotlin/com/flixclusive/data/tmdb/repository"
    click MH "https://github.com/flixclusiveorg/flixclusive/blob/master/feature/mobile/home/src/main/kotlin/com/flixclusive/feature/mobile/home/HomeScreen.kt"
    click MF "https://github.com/flixclusiveorg/flixclusive/blob/master/feature/mobile/film/src/main/kotlin/com/flixclusive/feature/mobile/film/FilmScreen.kt"
    click TH "https://github.com/flixclusiveorg/flixclusive/blob/master/feature/tv/home/src/main/kotlin/com/flixclusive/feature/tv/home/HomeScreen.kt"
    click TF "https://github.com/flixclusiveorg/flixclusive/blob/master/feature/tv/film/src/main/kotlin/com/flixclusive/feature/tv/film/FilmScreen.kt"

    %% Styles
    classDef ui fill:#D0E8FF,stroke:#0366d6;
    classDef presentation fill:#E0F7FA,stroke:#0288D1;
    classDef domain fill:#DFFFD0,stroke:#2E7D32;
    classDef data fill:#FFE0B2,stroke:#EF6C00;
    classDef datasource fill:#D7CCC8,stroke:#5D4037;
    classDef service fill:#FFF9C4,stroke:#FBC02D;
    classDef external fill:#ECEFF1,stroke:#607D8B;
```
