# banku27/youtube-messenger-app architecture

> Architecture diagram of the GitHub repository banku27/youtube-messenger-app, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-05-12). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/banku27/youtube-messenger-app
- Repository: https://github.com/banku27/youtube-messenger-app

## Overview

##### Project Type & Purpose
- This is a multi-platform (Android, iOS, Web, macOS, Windows, Linux) real-time chat application built in Flutter.
- It follows a “Clean Architecture” approach with distinct layers (presentation, logic, data, core/config) and uses Firebase as a backend (Auth, Firestore/Realtime DB, Messaging).
- State management is done via Cubit (Bloc library), and dependency injection via GetIt (service locator).

##### File Structure
- Top-level “android”, “ios”, “web”, “macos”, “windows”, “linux” folders contain platform-specific shell code.
- lib/ folder is your Flutter app’s core:
– config/ (themes, app-wide settings)
– core/ (shared widgets, utilities)
– data/ (models, repositories, services, service_locator.dart)
– logic/ (Cubit classes for auth, chat + observer)
– presentation/ (UI screens & widgets)
– router/ (app_router.dart for navigation)
– main.dart (app entrypoint, Firebase.initializeApp(), GetIt setup)
- README clarifies key features: authentication, real-time messaging, user status, read‐receipts, blocking, unread counts.

##### Architectural Patterns & Technologies
- Clean Architecture layers:
– Presentation Layer: Flutter Widgets, Screens, Navigation
– Business Logic Layer: Cubits & States
– Data Layer: Repositories → Services → Firebase SDK
– Core/Config Layer: Shared UI components, DI setup, theme config
- External Services: Firebase Auth, Firestore or Realtime Database, Cloud Messaging (push notifications).
- DI via GetIt: a central service locator (service_locator.dart).
- State Management: Bloc/Cubit for unidirectional data flow.

##### Main Components & Their Relationships
a. Device & Flutter Engine (Android/iOS/Web/etc.)
↳ Hosts your Flutter app, compiles to native.
b. Flutter Application
- Presentation Layer (Screens → Widgets)
- AppRouter (navigation)
- Business Logic Layer (AuthCubit, ChatCubit)
- Data Layer
– Repositories (AuthRepository, ChatRepository, ContactRepository)
– Services (BaseRepository → Firebase SDK)
- Core & Config (UI utils, theme, GetIt setup)
c. Firebase Cloud
- Firebase Auth (user login/signup)
- Firestore/Realtime DB (chat rooms, messages, user status)
- Cloud Messaging (push notifications)
d. Internet / Network
- Shows that the app communicates over HTTPS/WebSockets to Firebase services.

##### Essential Elements to Capture
- App entrypoint (main.dart) initializing Firebase & GetIt.
- Service Locator registering Repositories & Services.
- Cubit classes subscribing to UI events and emitting states.
- Repository interfaces → concrete Firebase implementations.
- Presentation screens (login, signup, home, chat).
- External Firebase modules: Auth, Firestore, Cloud Messaging.

## Diagram (Mermaid)

```mermaid
flowchart TB
    subgraph "Device & Flutter Engine"
        D1["Device / Flutter Engine"]:::external
    end

    subgraph "Flutter App"
        subgraph "Presentation Layer"
            UI1["Login Screen\n(login_screen.dart)"]:::presentation
            UI2["Signup Screen\n(signup_screen.dart)"]:::presentation
            UI3["Home Screen\n(home_screen.dart)"]:::presentation
            UI4["Chat Screen\n(chat_message_screen.dart)"]:::presentation
            UI5["Chat List Tile\n(chat_list_tile.dart)"]:::presentation
            UI6["Loading Dots\n(loading_dots.dart)"]:::presentation
        end

        subgraph "Business Logic Layer"
            L1["AuthCubit\n(auth_cubit.dart)"]:::logic
            L2["ChatCubit\n(chat_cubit.dart)"]:::logic
            L3["AppLifecycleObserver\n(app_life_cycle_observer.dart)"]:::logic
        end

        subgraph "Data Layer"
            Dmod1["ChatMessage Model\n(chat_message.dart)"]:::data
            Dmod2["ChatRoom Model\n(chat_room_model.dart)"]:::data
            Dmod3["User Model\n(user_model.dart)"]:::data
            Rep1["AuthRepository\n(auth_repository.dart)"]:::data
            Rep2["ChatRepository\n(chat_repository.dart)"]:::data
            Rep3["ContactRepository\n(contact_repository.dart)"]:::data
            Base["BaseRepository\n(base_repository.dart)"]:::data
        end

        subgraph "Core & Config"
            C1["main.dart"]:::core
            C2["service_locator.dart"]:::core
            C3["firebase_options.dart"]:::core
            C4["AppTheme\n(app_theme.dart)"]:::core
            C5["Custom Button\n(custom_button.dart)"]:::core
            C6["Custom TextField\n(custom_text_field.dart)"]:::core
            C7["UI Utils\n(ui_utils.dart)"]:::core
            C8["AppRouter\n(app_router.dart)"]:::core
        end
    end

    subgraph "Firebase Cloud"
        FAuth["Firebase Auth"]:::external
        FFirestore["Firestore/Realtime DB"]:::external
        FMsg["Cloud Messaging"]:::external
    end

    D1 --> C1
    C1 --> C2
    C1 --> C8

    UI1 --> L1
    UI2 --> L1
    UI3 --> L2
    UI4 --> L2
    UI3 --> UI5
    UI4 --> UI5
    UI3 --> UI6
    UI4 --> UI6

    L1 --> Rep1
    L2 --> Rep2

    Rep1 --> Base
    Rep2 --> Base
    Rep3 --> Base

    Base --> FAuth
    Base --> FFirestore

    C2 --> Rep1
    C2 --> Rep2
    C2 --> Rep3
    C2 --> Base

    C1 --> L3

    click C1 "https://github.com/banku27/youtube-messenger-app/blob/master/lib/main.dart"
    click C2 "https://github.com/banku27/youtube-messenger-app/blob/master/lib/data/services/service_locator.dart"
    click C3 "https://github.com/banku27/youtube-messenger-app/blob/master/lib/firebase_options.dart"
    click C4 "https://github.com/banku27/youtube-messenger-app/blob/master/lib/config/theme/app_theme.dart"
    click C5 "https://github.com/banku27/youtube-messenger-app/blob/master/lib/core/common/custom_button.dart"
    click C6 "https://github.com/banku27/youtube-messenger-app/blob/master/lib/core/common/custom_text_field.dart"
    click C7 "https://github.com/banku27/youtube-messenger-app/blob/master/lib/core/utils/ui_utils.dart"
    click C8 "https://github.com/banku27/youtube-messenger-app/blob/master/lib/router/app_router.dart"
    click UI1 "https://github.com/banku27/youtube-messenger-app/blob/master/lib/presentation/screens/auth/login_screen.dart"
    click UI2 "https://github.com/banku27/youtube-messenger-app/blob/master/lib/presentation/screens/auth/signup_screen.dart"
    click UI3 "https://github.com/banku27/youtube-messenger-app/blob/master/lib/presentation/home/home_screen.dart"
    click UI4 "https://github.com/banku27/youtube-messenger-app/blob/master/lib/presentation/chat/chat_message_screen.dart"
    click UI5 "https://github.com/banku27/youtube-messenger-app/blob/master/lib/presentation/widgets/chat_list_tile.dart"
    click UI6 "https://github.com/banku27/youtube-messenger-app/blob/master/lib/presentation/widgets/loading_dots.dart"
    click L1 "https://github.com/banku27/youtube-messenger-app/blob/master/lib/logic/cubits/auth/auth_cubit.dart"
    click L2 "https://github.com/banku27/youtube-messenger-app/blob/master/lib/logic/cubits/chat/chat_cubit.dart"
    click L3 "https://github.com/banku27/youtube-messenger-app/blob/master/lib/logic/observer/app_life_cycle_observer.dart"
    click Dmod1 "https://github.com/banku27/youtube-messenger-app/blob/master/lib/data/models/chat_message.dart"
    click Dmod2 "https://github.com/banku27/youtube-messenger-app/blob/master/lib/data/models/chat_room_model.dart"
    click Dmod3 "https://github.com/banku27/youtube-messenger-app/blob/master/lib/data/models/user_model.dart"
    click Rep1 "https://github.com/banku27/youtube-messenger-app/blob/master/lib/data/repositories/auth_repository.dart"
    click Rep2 "https://github.com/banku27/youtube-messenger-app/blob/master/lib/data/repositories/chat_repository.dart"
    click Rep3 "https://github.com/banku27/youtube-messenger-app/blob/master/lib/data/repositories/contact_repository.dart"
    click Base "https://github.com/banku27/youtube-messenger-app/blob/master/lib/data/services/base_repository.dart"

    classDef presentation fill:#E0F7FA,stroke:#006064,color:#006064
    classDef logic fill:#E8F5E9,stroke:#2E7D32,color:#2E7D32
    classDef data fill:#FFF3E0,stroke:#EF6C00,color:#E65100
    classDef core fill:#ECEFF1,stroke:#546E7A,color:#37474F
    classDef external fill:#FFEBEE,stroke:#C62828,color:#B71C1C
```
