# arisguimera/firebaselogin architecture

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

## Overview

##### Project Type and Purpose
- This is an Android mobile application module (“app”) following Clean-Architecture and MVVM.
- Purpose: four-screen flow for user introduction, login, sign-up, and email-verification, backed by Firebase Auth & Realtime Database, with reactive data streams (LiveData, Flow/StateFlow), DI (Hilt), Coroutines, and reusable UI components.

##### File-Structure Analysis
- Top-level: single Android module (“app”) with Gradle scripts, Google services, proguard, resources, manifests.
- Source packages under app/src/main/java/com/aristidevs/nuwelogin:
- core: application-wide utilities (Event, delegates, dialog launchers, extensions).
- data: network layer (AuthenticationService, FirebaseClient, UserService) + response models.
- domain: business-logic UseCase classes (Login, CreateAccount, SendEmailVerification, VerifyEmail).
- ui: screen Activities + ViewModels + ViewState + UI models, grouped by feature (introduction, login, signin, verification).
- Resources: layouts, drawables, fonts, styles for UI (ConstraintLayout-based, Lottie animations).

##### README Insights
- Architecture: Clean Architecture + MVVM + SOLID.
- Tech STACK: Kotlin Coroutines, LiveData, Flow/StateFlow, Dagger Hilt for DI, Firebase Auth & Realtime DB, Lottie.
- Activities vs. Fragments: four independent Activities for separation of concerns.
- Reusable UI components under core/dialog and core/delegate.

## Diagram (Mermaid)

```mermaid
flowchart TB
    subgraph "UI Layer"
        direction TB
        App["NuweLoginApp"]:::ui
        IntroAct["IntroductionActivity"]:::ui
        LoginAct["LoginActivity"]:::ui
        SignInAct["SignInActivity"]:::ui
        VerifAct["VerificationActivity"]:::ui
        IntroLayout[(activity_introduction.xml)]:::ui
        LoginLayout[(activity_login.xml)]:::ui
        SignInLayout[(activity_sign_in.xml)]:::ui
        VerifLayout[(activity_verification.xml)]:::ui
    end

    subgraph "Presentation Layer"
        direction TB
        IntroVM["IntroductionViewModel"]:::presentation
        LoginVM["LoginViewModel"]:::presentation
        LoginVS["LoginViewState"]:::presentation
        SignVM["SignInViewModel"]:::presentation
        SignVS["SignInViewState"]:::presentation
        VerifVM["VerificationViewModel"]:::presentation
        ULModel["UserLogin"]:::presentation
        USModel["UserSignIn"]:::presentation
    end

    subgraph "Domain Layer"
        direction TB
        LoginUC["LoginUseCase"]:::domain
        CreateUC["CreateAccountUseCase"]:::domain
        SendUC["SendEmailVerificationUseCase"]:::domain
        VerifyUC["VerifyEmailUseCase"]:::domain
    end

    subgraph "Data Layer"
        direction TB
        AuthSvc["AuthenticationService"]:::data
        FireClient["FirebaseClient"]:::data
        UserSvc["UserService"]:::data
        Resp["LoginResponse"]:::data
    end

    subgraph "Core Utilities"
        direction TB
        Event["Event"]:::core
        WeakDel["WeakReferenceDelegate"]:::core
        DialogLaunch["DialogFragmentLauncher"]:::core
        ErrorDlg["ErrorDialog"]:::core
        SuccessDlg["LoginSuccessDialog"]:::core
        ActEx["ActivityEx"]:::core
        DlgEx["DialogEx"]:::core
        EditEx["EditTextEx"]:::core
        ViewEx["ViewEx"]:::core
    end

    subgraph "External Services"
        direction TB
        Auth["Firebase Auth"]:::external
        DB["Firebase Realtime DB"]:::external
    end

    Hilt["Dagger Hilt DI"]:::di

    App -->|launches| IntroAct
    IntroAct -->|uses Layout| IntroLayout
    LoginAct -->|uses Layout| LoginLayout
    SignInAct -->|uses Layout| SignInLayout
    VerifAct -->|uses Layout| VerifLayout

    IntroAct -->|binds to| IntroVM
    LoginAct -->|binds to| LoginVM
    SignInAct -->|binds to| SignVM
    VerifAct -->|binds to| VerifVM

    LoginVM -->|emits| LoginVS
    SignVM -->|emits| SignVS
    LoginVM -->|uses model| ULModel
    SignVM -->|uses model| USModel

    IntroVM -->|invokes| LoginUC
    LoginVM -->|invokes| LoginUC
    SignVM -->|invokes| CreateUC
    VerifVM -->|invokes| SendUC
    VerifVM -->|invokes| VerifyUC

    LoginUC -->|calls| AuthSvc
    CreateUC -->|calls| UserSvc
    SendUC -->|calls| AuthSvc
    VerifyUC -->|calls| AuthSvc

    AuthSvc -->|via| FireClient
    UserSvc -->|via| FireClient

    AuthSvc -->|auth ops| Auth
    UserSvc -->|db ops| DB

    Hilt --> App
    Hilt --> IntroAct
    Hilt --> LoginAct
    Hilt --> SignInAct
    Hilt --> VerifAct
    Hilt --> IntroVM
    Hilt --> LoginVM
    Hilt --> SignVM
    Hilt --> VerifVM
    Hilt --> LoginUC
    Hilt --> CreateUC
    Hilt --> SendUC
    Hilt --> VerifyUC
    Hilt --> AuthSvc
    Hilt --> UserSvc
    Hilt --> FireClient
    Hilt --> Event
    Hilt --> WeakDel
    Hilt --> DialogLaunch
    Hilt --> ErrorDlg
    Hilt --> SuccessDlg
    Hilt --> ActEx
    Hilt --> DlgEx
    Hilt --> EditEx
    Hilt --> ViewEx

    classDef ui fill:#D0E8FF,stroke:#0366d6
    classDef presentation fill:#DFFFE0,stroke:#228B22
    classDef domain fill:#FFEFD5,stroke:#FF8C00
    classDef data fill:#FFE4E1,stroke:#DC143C
    classDef core fill:#F3E6FF,stroke:#9370DB
    classDef external fill:#F0F0F0,stroke:#696969
    classDef di fill:#FFFACD,stroke:#DAA520

    click App "https://github.com/arisguimera/firebaselogin/blob/master/app/src/main/java/com/aristidevs/nuwelogin/NuweLoginApp.kt"
    click IntroAct "https://github.com/arisguimera/firebaselogin/blob/master/app/src/main/java/com/aristidevs/nuwelogin/ui/introduction/IntroductionActivity.kt"
    click LoginAct "https://github.com/arisguimera/firebaselogin/blob/master/app/src/main/java/com/aristidevs/nuwelogin/ui/login/LoginActivity.kt"
    click SignInAct "https://github.com/arisguimera/firebaselogin/blob/master/app/src/main/java/com/aristidevs/nuwelogin/ui/signin/SignInActivity.kt"
    click VerifAct "https://github.com/arisguimera/firebaselogin/blob/master/app/src/main/java/com/aristidevs/nuwelogin/ui/verification/VerificationActivity.kt"
    click IntroLayout "https://github.com/arisguimera/firebaselogin/blob/master/app/src/main/res/layout/activity_introduction.xml"
    click LoginLayout "https://github.com/arisguimera/firebaselogin/blob/master/app/src/main/res/layout/activity_login.xml"
    click SignInLayout "https://github.com/arisguimera/firebaselogin/blob/master/app/src/main/res/layout/activity_sign_in.xml"
    click VerifLayout "https://github.com/arisguimera/firebaselogin/blob/master/app/src/main/res/layout/activity_verification.xml"
    click IntroVM "https://github.com/arisguimera/firebaselogin/blob/master/app/src/main/java/com/aristidevs/nuwelogin/ui/introduction/IntroductionViewModel.kt"
    click LoginVM "https://github.com/arisguimera/firebaselogin/blob/master/app/src/main/java/com/aristidevs/nuwelogin/ui/login/LoginViewModel.kt"
    click LoginVS "https://github.com/arisguimera/firebaselogin/blob/master/app/src/main/java/com/aristidevs/nuwelogin/ui/login/LoginViewState.kt"
    click SignVM "https://github.com/arisguimera/firebaselogin/blob/master/app/src/main/java/com/aristidevs/nuwelogin/ui/signin/SignInViewModel.kt"
    click SignVS "https://github.com/arisguimera/firebaselogin/blob/master/app/src/main/java/com/aristidevs/nuwelogin/ui/signin/SignInViewState.kt"
    click VerifVM "https://github.com/arisguimera/firebaselogin/blob/master/app/src/main/java/com/aristidevs/nuwelogin/ui/verification/VerificationViewModel.kt"
    click ULModel "https://github.com/arisguimera/firebaselogin/blob/master/app/src/main/java/com/aristidevs/nuwelogin/ui/login/model/UserLogin.kt"
    click USModel "https://github.com/arisguimera/firebaselogin/blob/master/app/src/main/java/com/aristidevs/nuwelogin/ui/signin/model/UserSignIn.kt"
    click LoginUC "https://github.com/arisguimera/firebaselogin/blob/master/app/src/main/java/com/aristidevs/nuwelogin/domain/LoginUseCase.kt"
    click CreateUC "https://github.com/arisguimera/firebaselogin/blob/master/app/src/main/java/com/aristidevs/nuwelogin/domain/CreateAccountUseCase.kt"
    click SendUC "https://github.com/arisguimera/firebaselogin/blob/master/app/src/main/java/com/aristidevs/nuwelogin/domain/SendEmailVerificationUseCase.kt"
    click VerifyUC "https://github.com/arisguimera/firebaselogin/blob/master/app/src/main/java/com/aristidevs/nuwelogin/domain/VerifyEmailUseCase.kt"
    click AuthSvc "https://github.com/arisguimera/firebaselogin/blob/master/app/src/main/java/com/aristidevs/nuwelogin/data/network/AuthenticationService.kt"
    click FireClient "https://github.com/arisguimera/firebaselogin/blob/master/app/src/main/java/com/aristidevs/nuwelogin/data/network/FirebaseClient.kt"
    click UserSvc "https://github.com/arisguimera/firebaselogin/blob/master/app/src/main/java/com/aristidevs/nuwelogin/data/network/UserService.kt"
    click Resp "https://github.com/arisguimera/firebaselogin/blob/master/app/src/main/java/com/aristidevs/nuwelogin/data/response/LoginResponse.kt"
    click Event "https://github.com/arisguimera/firebaselogin/blob/master/app/src/main/java/com/aristidevs/nuwelogin/core/Event.kt"
    click WeakDel "https://github.com/arisguimera/firebaselogin/blob/master/app/src/main/java/com/aristidevs/nuwelogin/core/delegate/WeakReferenceDelegate.kt"
    click DialogLaunch "https://github.com/arisguimera/firebaselogin/blob/master/app/src/main/java/com/aristidevs/nuwelogin/core/dialog/DialogFragmentLauncher.kt"
    click ErrorDlg "https://github.com/arisguimera/firebaselogin/blob/master/app/src/main/java/com/aristidevs/nuwelogin/core/dialog/ErrorDialog.kt"
    click SuccessDlg "https://github.com/arisguimera/firebaselogin/blob/master/app/src/main/java/com/aristidevs/nuwelogin/core/dialog/LoginSuccessDialog.kt"
    click ActEx "https://github.com/arisguimera/firebaselogin/blob/master/app/src/main/java/com/aristidevs/nuwelogin/core/ex/ActivityEx.kt"
    click DlgEx "https://github.com/arisguimera/firebaselogin/blob/master/app/src/main/java/com/aristidevs/nuwelogin/core/ex/DialogEx.kt"
    click EditEx "https://github.com/arisguimera/firebaselogin/blob/master/app/src/main/java/com/aristidevs/nuwelogin/core/ex/EditTextEx.kt"
    click ViewEx "https://github.com/arisguimera/firebaselogin/blob/master/app/src/main/java/com/aristidevs/nuwelogin/core/ex/ViewEx.kt"
```
