# luannluna/animeverse architecture

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

- Interactive diagram: https://gitdiagram.com/luannluna/animeverse
- Repository: https://github.com/luannluna/animeverse

## Overview

##### Project type and purpose
- AnimeVerse is a native iOS mobile application built with SwiftUI.
- It serves as a front-end for discovering, searching, and managing anime, consuming the AniList GraphQL API, caching images with Kingfisher, and persisting favorites locally (SwiftData) and via Firebase.

##### File structure
- Top-level modules:
- AnimeVerse/ — the main SwiftUI app target
- AnilistAPI/ — generated Apollo GraphQL client code
- AnimeVerseTests/ & AnimeVerseUITests/ — test targets
- Inside AnimeVerse/:
- Components/ — reusable SwiftUI views
- Scene/ — feature-organized screens (Home, Search, Details, Favorites, Profile, SavedList) each with a View and ViewModel
- Navigation/ — global Router and AppRoute definitions
- Services/ —
– AnilistService (networking, cache)
– FirebaseService (auth, user, watching list)
– LocalUserStore, UserSession
- Models/ — domain data structures and DTOs
- GraphQL/ — .graphql query files (source of generated code)
- Extensions/, Helper/, Utilities/ — supporting code
- Config & schema at root: SwiftLint, Apollo config, GraphQL schema files.

##### Insights from README
- Confirms tech stack: SwiftUI, Apollo iOS, Kingfisher, SwiftData, AniList API, Firebase.
- Mentions offline support (favorites stored locally).
- Emphasizes smooth UI and fast GraphQL queries.

a. Main components
1. SwiftUI App Layer
- Scenes & Components (UI Views)
2. Presentation Layer
- ViewModels (one per Scene)
3. Domain/Service Layer
- AnilistService (ApolloClient wrapper, cache service)
- FirebaseService (Auth, Firestore user and list)
- LocalUserStore & SwiftData persistence
4. Data Layer
- AnilistAPI module (generated GraphQL types & operations)
5. External Services
- AniList GraphQL API endpoint
- Firebase Authentication & Firestore
b. Relationships & dataflow
- User taps UI → View (ViewModel) → calls Service
- Service issues GraphQL query via ApolloClient (AnilistAPI) → AniList API → JSON response → decoded to Swift models
- Service updates local SwiftData store for favorites or calls FirebaseService for remote sync
- Kingfisher image loader fetches & caches cover images from AniList CDN
- Navigation flows managed by Router, transitioning between Scenes
c. Architectural patterns & principles
- MVVM: Views bind to ViewModels, which orchestrate Services
- Clean layering: UI → Presentation → Domain → Data
- Dependency injection via Router and Service singletons/UserSession
- Offline‐first design for favorites
- Modularity: separate GraphQL codegen (AnilistAPI) from app code
d. Key technologies
- SwiftUI (UI layer)
- Apollo iOS & generated AnilistAPI (GraphQL client)
- Kingfisher (image caching)
- SwiftData (local persistence)
- Firebase Auth & Firestore (user identity & list sync)

## Diagram (Mermaid)

```mermaid
flowchart TD
    %% UI Layer
    subgraph "UI Layer" 
        direction TB
        AnimeVerseApp["AnimeVerseApp\n(SwiftUI)"]:::ui
        Components["Components"]:::ui
        RootView["RootView"]:::ui
        AnimeListView["AnimesView"]:::ui
        AnimeDetailsView["AnimeDetailsView"]:::ui
        SearchView["SearchView"]:::ui
        FavoritesView["FavoritesView"]:::ui
        SavedListView["SavedListView"]:::ui
        ProfileView["ProfileView"]:::ui
        LoginView["LoginView"]:::ui
        SignUpView["SignUpView"]:::ui
        MangaListView["MangaView"]:::ui
        MangaDetailView["MangaDetailView"]:::ui
    end

    %% Presentation Layer
    subgraph "Presentation Layer" 
        direction TB
        AnimeListVM["AnimesViewModel"]:::presentation
        AnimeDetailsVM["AnimeDetailsViewModel"]:::presentation
        SearchVM["SearchViewModel"]:::presentation
        SavedListVM["SavedListViewModel"]:::presentation
        ProfileVM["ProfileViewModel"]:::presentation
        MangaListVM["MangaViewModel"]:::presentation
        MangaDetailVM["MangaDetailViewModel"]:::presentation
    end

    %% Service Layer
    subgraph "Service Layer" 
        direction TB
        AnilistService["AnilistService"]:::service
        FirebaseService["FirebaseService"]:::service
        LocalStore["LocalUserStore\n& UserSession"]:::service
        SearchService["SearchService"]:::service
    end

    %% Data Layer
    subgraph "Data Layer" 
        direction TB
        AnilistAPI["AnilistAPI Module"]:::data
        GraphQLQueries["GraphQL Queries"]:::data
    end

    %% Storage & Caches
    SwiftData[(SwiftData Store)]:::storage
    Kingfisher[(Kingfisher Cache)]:::storage
    Firestore[(Firestore)]:::storage

    %% External Endpoints
    AniListAPI((AniList GraphQL API)):::external
    FirebaseAuth((Firebase Auth API)):::external
    CDN((AniList CDN)):::external

    %% Connections UI -> Presentation
    AnimeVerseApp -->|loads| RootView
    AnimeVerseApp -->|uses| Components
    RootView -->|navigates| AnimeListView
    RootView -->|navigates| AnimeDetailsView
    RootView -->|navigates| SearchView
    RootView -->|navigates| FavoritesView
    RootView -->|navigates| SavedListView
    RootView -->|navigates| ProfileView
    RootView -->|navigates| LoginView
    RootView -->|navigates| SignUpView
    RootView -->|navigates| MangaListView
    RootView -->|navigates| MangaDetailView

    AnimeListView -->|binds to| AnimeListVM
    AnimeDetailsView -->|binds to| AnimeDetailsVM
    SearchView -->|binds to| SearchVM
    SavedListView -->|binds to| SavedListVM
    ProfileView -->|binds to| ProfileVM
    MangaListView -->|binds to| MangaListVM
    MangaDetailView -->|binds to| MangaDetailVM

    %% Presentation -> Service
    AnimeListVM -->|calls| AnilistService
    AnimeDetailsVM -->|calls| AnilistService
    SearchVM -->|calls| SearchService
    SavedListVM -->|calls| LocalStore
    ProfileVM -->|calls| FirebaseService
    MangaListVM -->|calls| AnilistService
    MangaDetailVM -->|calls| AnilistService

    %% Service -> Data Layer & external
    AnilistService -->|uses| AnilistAPI
    AnilistService -->|stores favorites| SwiftData
    AnilistService -->|sync| FirebaseService
    FirebaseService -->|auth| FirebaseAuth
    FirebaseService -->|db| Firestore
    SearchService -->|uses| AnilistService

    AnilistAPI -->|queries| AniListAPI
    GraphQLQueries -->|codegen| AnilistAPI

    %% UI -> Cache & CDN
    AnimeListView -->|loads images| Kingfisher
    AnimeDetailsView -->|loads images| Kingfisher
    Kingfisher -->|fetches| CDN

    %% Click Events
    click AnimeVerseApp "https://github.com/luannluna/animeverse/blob/main/AnimeVerse/AnimeVerse/AnimeVerseApp.swift"
    click Components "https://github.com/luannluna/animeverse/tree/main/AnimeVerse/AnimeVerse/Components"
    click RootView "https://github.com/luannluna/animeverse/blob/main/AnimeVerse/AnimeVerse/Scene/RootView.swift"
    click AnimeListView "https://github.com/luannluna/animeverse/blob/main/AnimeVerse/AnimeVerse/Scene/Animes/AnimesView.swift"
    click AnimeListVM "https://github.com/luannluna/animeverse/blob/main/AnimeVerse/AnimeVerse/Scene/Animes/AnimesViewModel.swift"
    click AnimeDetailsView "https://github.com/luannluna/animeverse/blob/main/AnimeVerse/AnimeVerse/Scene/AnimeDetails/AnimeDetailsView.swift"
    click AnimeDetailsVM "https://github.com/luannluna/animeverse/blob/main/AnimeVerse/AnimeVerse/Scene/AnimeDetails/AnimeDetailsViewModel.swift"
    click SearchService "https://github.com/luannluna/animeverse/blob/main/AnimeVerse/AnimeVerse/Scene/Search/SearchService.swift"
    click SearchView "https://github.com/luannluna/animeverse/blob/main/AnimeVerse/AnimeVerse/Scene/Search/SearchView.swift"
    click SearchVM "https://github.com/luannluna/animeverse/blob/main/AnimeVerse/AnimeVerse/Scene/Search/SearchViewModel.swift"
    click FavoritesView "https://github.com/luannluna/animeverse/blob/main/AnimeVerse/AnimeVerse/Scene/Favorites/FavoritesView.swift"
    click SavedListView "https://github.com/luannluna/animeverse/blob/main/AnimeVerse/AnimeVerse/Scene/SavedList/SavedListView.swift"
    click SavedListVM "https://github.com/luannluna/animeverse/blob/main/AnimeVerse/AnimeVerse/Scene/SavedList/SavedListViewModel.swift"
    click ProfileView "https://github.com/luannluna/animeverse/blob/main/AnimeVerse/AnimeVerse/Scene/Profile/ProfileView.swift"
    click ProfileVM "https://github.com/luannluna/animeverse/blob/main/AnimeVerse/AnimeVerse/Scene/Profile/ProfileViewModel.swift"
    click LoginView "https://github.com/luannluna/animeverse/blob/main/AnimeVerse/AnimeVerse/Scene/Auth/LoginView.swift"
    click SignUpView "https://github.com/luannluna/animeverse/blob/main/AnimeVerse/AnimeVerse/Scene/Auth/SignUpView.swift"
    click MangaListView "https://github.com/luannluna/animeverse/blob/main/AnimeVerse/AnimeVerse/Scene/Mangas/MangaView.swift"
    click MangaListVM "https://github.com/luannluna/animeverse/blob/main/AnimeVerse/AnimeVerse/Scene/Mangas/MangaViewModel.swift"
    click MangaDetailView "https://github.com/luannluna/animeverse/blob/main/AnimeVerse/AnimeVerse/Scene/MangaDetails/MangaDetailView.swift"
    click MangaDetailVM "https://github.com/luannluna/animeverse/blob/main/AnimeVerse/AnimeVerse/Scene/MangaDetails/MangaDetailViewModel.swift"
    click Router "https://github.com/luannluna/animeverse/blob/main/AnimeVerse/AnimeVerse/Navigation/Router.swift"
    click AppRoute "https://github.com/luannluna/animeverse/blob/main/AnimeVerse/AnimeVerse/Navigation/AppRoute.swift"
    click Extensions "https://github.com/luannluna/animeverse/tree/main/AnimeVerse/AnimeVerse/Extensions"
    click Helper "https://github.com/luannluna/animeverse/tree/main/AnimeVerse/AnimeVerse/Helper"
    click Utilities "https://github.com/luannluna/animeverse/tree/main/AnimeVerse/AnimeVerse/Utilities"
    click Models "https://github.com/luannluna/animeverse/tree/main/AnimeVerse/AnimeVerse/Models"
    click AnilistService "https://github.com/luannluna/animeverse/tree/main/AnimeVerse/AnimeVerse/Services/AnilistService"
    click FirebaseService "https://github.com/luannluna/animeverse/tree/main/AnimeVerse/AnimeVerse/Services/FirebaseService"
    click LocalStore "https://github.com/luannluna/animeverse/tree/main/AnimeVerse/AnimeVerse/Services"
    click AnilistAPI "https://github.com/luannluna/animeverse/tree/main/AnimeVerse/AnilistAPI/Sources"
    click GraphQLQueries "https://github.com/luannluna/animeverse/tree/main/AnimeVerse/AnimeVerse/GraphQL/Queries"

    %% Styles
    classDef ui fill:#D0E6FA,stroke:#0366D6,color:#0366D6
    classDef presentation fill:#DFF2BF,stroke:#4F8A10,color:#4F8A10
    classDef service fill:#FFEFBF,stroke:#D18B00,color:#D18B00
    classDef data fill:#E3D4F5,stroke:#6F42C1,color:#6F42C1
    classDef external fill:#EDEDED,stroke:#666,color:#333
    classDef storage fill:#F0F0F0,stroke:#999,color:#555,type:cylinder
```
