# pankaj1662005/streamer_movie_app architecture

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

- Interactive diagram: https://gitdiagram.com/pankaj1662005/streamer_movie_app
- Repository: https://github.com/pankaj1662005/streamer_movie_app

## Overview

##### Project type and purpose
- StreamIt is a cross-platform, Flutter-based front-end application (mobile, desktop, web) that lets users browse and stream movies.
- It has no custom backend code in this repo, relying instead on third-party services (Firebase for auth, TMDB-style Movie APIs for data, AdMob for ads).

##### File structure
- Top-level platform folders: android, ios, linux, macos, windows, web – each contains the native embedding code for Flutter.
- lib/ – all Dart source:
- main.dart — application entry point
- splash_screen.dart, splash_screen2.dart — launch logic
- home_page.dart, streamer_home.dart — core UI screens
- admob/admob_manager.dart — ad service integration
- assets/animations – Lottie JSON files used in UI
- release/ – sample gifs/photos (documentation/demo)
- config files: pubspec.yaml, analysis_options.yaml, platform build scripts (Gradle, Xcode, CMake)

##### README for additional insights
- Describes features: browse trending movies, watch trailers, signup/login, save favorites
- Tech stack called out: Flutter/Dart, Firebase Auth, Movie APIs, Google Drive (APK distribution)

a. Main Components
- Flutter UI Layer – Widgets managing visual presentation (Splash, Home, Stream).
- Business/Service Layer – ad manager, authentication service, movie-API client.
- Data Layer – REST/HTTP client calls to Movie API; Firebase Auth SDK.
- Flutter Engine & Platform Channels – mediates between Dart code and native functionality.
- Native Embedders – Android, iOS, Linux, macOS, Windows, Web host apps.
- External Services – TMDB-style Movie API endpoint; Firebase Auth backend; AdMob network.
b. Relationships & Data Flow
1. User taps UI widget → Widget calls Service Layer API
2. Service Layer issues HTTP/Firebase requests via Dart packages
3. Requests go through Flutter Engine → Platform Channels → Native OS networking SDK
4. Responses bubble back: Native → Engine → Dart → Business Layer → UI updates
c. Architectural patterns & principles
- Layered architecture: presentation (Widgets) → domain/services → data providers
- Plugin-based extension: AdMob, Firebase, networking via pub packages
- Platform independence: single codebase, multiple native embedders
d. Key technologies & frameworks
- Flutter/Dart
- firebase_auth Flutter plugin
- http or dio for REST calls
- google_mobile_ads plugin for AdMob
- Lottie for animations

## Diagram (Mermaid)

```mermaid
flowchart TD
    %% UI Layer
    subgraph "UI Layer"
        direction TB
        EntryPoint["main.dart"]:::ui
        Splash1["splash_screen.dart"]:::ui
        Splash2["splash_screen2.dart"]:::ui
        HomePage["home_page.dart"]:::ui
        StreamerHome["streamer_home.dart"]:::ui
    end

    %% Service Layer
    subgraph "Business & Service Layer"
        direction TB
        AuthService["Firebase Auth Service"]:::service
        MovieApiClient["Movie API Client"]:::service
        AdMobManager["admob_manager.dart"]:::service
    end

    %% Data Transport Layer
    subgraph "Data Transport / Engine"
        direction TB
        FlutterEngine["Flutter Engine"]:::transport
        PlatformChannels["Platform Channels"]:::transport
    end

    %% Native Hosts
    subgraph "Native Hosts"
        direction TB
        AndroidHost["Android Host"]:::host
        iOSHost["iOS Host"]:::host
        macOSHost["macOS Host"]:::host
        LinuxHost["Linux Host"]:::host
        WindowsHost["Windows Host"]:::host
        WebHost["Web Host"]:::host
    end

    %% External Services
    subgraph "External Services"
        direction TB
        MovieAPI["Movie API Endpoint"]:::external
        FirebaseAuth["Firebase Auth Backend"]:::external
        AdMobNetwork["AdMob Network"]:::external
    end

    %% Connections: UI to Services
    EntryPoint -->|"init & navigate"| Splash1
    Splash1 -->|"flow logic"| Splash2
    Splash2 -->|"show home"| HomePage
    HomePage -->|"stream nav"| StreamerHome
    StreamerHome -->|"request auth"| AuthService
    StreamerHome -->|"request movies"| MovieApiClient
    StreamerHome -->|"request ads"| AdMobManager

    %% Services to Transport
    AuthService -->|"Firebase signIn() call"| FlutterEngine
    MovieApiClient -->|"GET /movies/popular"| FlutterEngine
    AdMobManager -->|"loadAd()"| FlutterEngine

    %% Transport to Native
    FlutterEngine -->|"invokeChannel()"| PlatformChannels
    PlatformChannels -->|"platform network"| AndroidHost
    PlatformChannels -->|"platform network"| iOSHost
    PlatformChannels -->|"platform network"| macOSHost
    PlatformChannels -->|"platform network"| LinuxHost
    PlatformChannels -->|"platform network"| WindowsHost
    PlatformChannels -->|"platform network"| WebHost

    %% Native to External
    AndroidHost -->|"HTTP/Firebase SDK"| MovieAPI
    AndroidHost -->|"Firebase SDK"| FirebaseAuth
    AndroidHost -->|"AdMob SDK"| AdMobNetwork
    iOSHost -->|"HTTP/Firebase SDK"| MovieAPI
    iOSHost -->|"Firebase SDK"| FirebaseAuth
    iOSHost -->|"AdMob SDK"| AdMobNetwork
    macOSHost -->|"HTTP/Firebase SDK"| MovieAPI
    macOSHost -->|"Firebase SDK"| FirebaseAuth
    macOSHost -->|"AdMob SDK"| AdMobNetwork
    LinuxHost -->|"HTTP SDK"| MovieAPI
    LinuxHost -->|"Auth SDK"| FirebaseAuth
    LinuxHost -->|"Ads SDK"| AdMobNetwork
    WindowsHost -->|"HTTP SDK"| MovieAPI
    WindowsHost -->|"Auth SDK"| FirebaseAuth
    WindowsHost -->|"Ads SDK"| AdMobNetwork
    WebHost -->|"Fetch API"| MovieAPI
    WebHost -->|"Auth JS SDK"| FirebaseAuth
    WebHost -->|"Ads JS SDK"| AdMobNetwork

    %% Response Flows
    MovieAPI -->|"response"| AndroidHost
    FirebaseAuth -->|"response"| AndroidHost
    AdMobNetwork -->|"response"| AndroidHost
    AndroidHost --> PlatformChannels --> FlutterEngine --> AuthService
    PlatformChannels --> FlutterEngine --> MovieApiClient
    PlatformChannels --> FlutterEngine --> AdMobManager
    AuthService --> StreamerHome --> HomePage
    MovieApiClient --> StreamerHome --> HomePage
    AdMobManager --> StreamerHome --> HomePage

    %% Click Events
    click EntryPoint "https://github.com/pankaj1662005/streamer_movie_app/blob/main/lib/main.dart"
    click Splash1 "https://github.com/pankaj1662005/streamer_movie_app/blob/main/lib/splash_screen.dart"
    click Splash2 "https://github.com/pankaj1662005/streamer_movie_app/blob/main/lib/splash_screen2.dart"
    click HomePage "https://github.com/pankaj1662005/streamer_movie_app/blob/main/lib/home_page.dart"
    click StreamerHome "https://github.com/pankaj1662005/streamer_movie_app/blob/main/lib/streamer_home.dart"
    click AdMobManager "https://github.com/pankaj1662005/streamer_movie_app/blob/main/lib/admob/admob_manager.dart"
    click AndroidHost "https://github.com/pankaj1662005/streamer_movie_app/blob/main/android/app/src/main/kotlin/com/example/movie_stream/MainActivity.kt"
    click iOSHost "https://github.com/pankaj1662005/streamer_movie_app/blob/main/ios/Runner/AppDelegate.swift"
    click macOSHost "https://github.com/pankaj1662005/streamer_movie_app/blob/main/macos/Runner/AppDelegate.swift"
    click LinuxHost "https://github.com/pankaj1662005/streamer_movie_app/blob/main/linux/main.cc"
    click WindowsHost "https://github.com/pankaj1662005/streamer_movie_app/blob/main/windows/runner/main.cpp"
    click WebHost "https://github.com/pankaj1662005/streamer_movie_app/blob/main/web/index.html"

    %% Styles
    classDef ui fill:#D0E8FF,stroke:#0288D1,stroke-width:2px
    classDef service fill:#D0F0C0,stroke:#388E3C,stroke-width:2px
    classDef transport fill:#FFE0B2,stroke:#F57C00,stroke-width:2px
    classDef host fill:#EEEEEE,stroke:#757575,stroke-width:2px
    classDef external fill:#FFF9C4,stroke:#FBC02D,stroke-width:2px
```
