# daggerpov/spawn-app-android-kotlin architecture

> Architecture diagram of the GitHub repository daggerpov/spawn-app-android-kotlin, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-07-19). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/daggerpov/spawn-app-android-kotlin
- Repository: https://github.com/daggerpov/spawn-app-android-kotlin

## Overview

##### Project Type and Purpose
- This is a full-stack mobile client: an Android application written in Kotlin using Jetpack Compose and the MVVM pattern.
- It connects over HTTP to a separate REST API (“Spawn-App-Back-End”) to fetch and post event and user data. It also embeds the Mapbox SDK for map rendering.

##### Key Directories and Architectural Layers
- app/src/main/java/com/example/spawn_app_android/data
- model (DTOs for JSON payloads)
- remote (ApiService/ApiClient for REST calls via Retrofit or similar)
- app/src/main/java/com/example/spawn_app_android/domain
- model (business/domain objects)
- (potentially) use-case classes (not shown, but your ViewModels mediate here)
- app/src/main/java/com/example/spawn_app_android/presentation
- navigation (Compose Navigation graph)
- screens (Composables for UI)
- viewModels (UI state + calls into data/domain layers)
- app/src/main/res

##### External Dependencies & Services
- Spawn-App-Back-End REST API (external server)
- Mapbox SDK / Mapbox access token (external mapping service)
- Android OS and device hardware
- Build system: Gradle (Kotlin DSL)

## Diagram (Mermaid)

```mermaid
graph TB

    subgraph "Android Platform"
        OS["Android OS & Device"]:::external
    end

    subgraph "Build & Resources"
        Gradle["Gradle Build (build.gradle.kts)"]:::external
        Drawables["Drawable Resources"]:::external
        Strings["String Resources"]:::external
        Token["Mapbox Access Token"]:::external
    end

    subgraph "Application Entry"
        MainActivity["MainActivity.kt"]:::presentation
        SpawnApp["SpawnApp.kt"]:::presentation
    end

    subgraph "Presentation Layer"
        subgraph "UI Layer"
            NavGraph["Navigation.kt"]:::presentation
            BottomNav["BottomNavItem.kt"]:::presentation
            Screens["Screens"]:::presentation
            MapScreen["Map.kt"]:::presentation
        end
        ViewModel["HomeViewModel.kt"]:::presentation
        Theme["Theme Definitions"]:::presentation
    end

    subgraph "Domain Layer"
        DomainModel["ActivityModel.kt"]:::domain
    end

    subgraph "Data Layer"
        DTO["EventsDto.kt"]:::data
        ApiClient["ApiClient.kt"]:::data
        ApiService["ApiService.kt"]:::data
    end

    subgraph "External Services"
        RESTAPI["Spawn-App-Back-End REST API"]:::external
        BackendDB["Back-End Database"]:::external
        MapboxService["Mapbox SDK"]:::external
    end

    OS -->|"launches"| MainActivity
    Gradle -->|"builds"| MainActivity
    Drawables -->|"resources"| Screens
    Strings -->|"resources"| Screens
    Token -->|"injects"| MapScreen

    MainActivity -->|"starts"| NavGraph
    NavGraph -->|"navigates"| Screens
    Screens -->|"userActions"| ViewModel
    ViewModel -->|"calls use cases"| DomainModel
    ViewModel -->|"calls data layer"| ApiClient
    ViewModel -->|"stateUpdate"| Screens

    ApiClient -->|"uses"| ApiService
    ApiService -->|"HTTP requests"| RESTAPI
    RESTAPI -->|"queries"| BackendDB
    BackendDB -->|"data"| RESTAPI
    RESTAPI -->|"responses"| ApiService
    ApiService -->|"JSON"| ApiClient
    ApiClient -->|"data"| ViewModel

    MapboxService -->|"renders maps"| MapScreen
    MapScreen -->|"requests tiles"| MapboxService

    click Screens "https://github.com/daggerpov/spawn-app-android-kotlin/tree/main/Spawn-Android/app/src/main/java/com/example/spawn_app_android/presentation/screens"
    click NavGraph "https://github.com/daggerpov/spawn-app-android-kotlin/blob/main/Spawn-Android/app/src/main/java/com/example/spawn_app_android/presentation/navigation/Navigation.kt"
    click BottomNav "https://github.com/daggerpov/spawn-app-android-kotlin/blob/main/Spawn-Android/app/src/main/java/com/example/spawn_app_android/presentation/navigation/BottomNavItem.kt"
    click ViewModel "https://github.com/daggerpov/spawn-app-android-kotlin/blob/main/Spawn-Android/app/src/main/java/com/example/spawn_app_android/presentation/viewModels/HomeViewModel.kt"
    click Theme "https://github.com/daggerpov/spawn-app-android-kotlin/tree/main/Spawn-Android/app/src/main/java/com/example/spawn_app_android/presentation/theme"
    click DomainModel "https://github.com/daggerpov/spawn-app-android-kotlin/blob/main/Spawn-Android/app/src/main/java/com/example/spawn_app_android/domain/model/ActivityModel.kt"
    click DTO "https://github.com/daggerpov/spawn-app-android-kotlin/blob/main/Spawn-Android/app/src/main/java/com/example/spawn_app_android/data/model/EventsDto.kt"
    click ApiClient "https://github.com/daggerpov/spawn-app-android-kotlin/blob/main/Spawn-Android/app/src/main/java/com/example/spawn_app_android/data/remote/ApiClient.kt"
    click ApiService "https://github.com/daggerpov/spawn-app-android-kotlin/blob/main/Spawn-Android/app/src/main/java/com/example/spawn_app_android/data/remote/ApiService.kt"
    click MainActivity "https://github.com/daggerpov/spawn-app-android-kotlin/blob/main/Spawn-Android/app/src/main/java/com/example/spawn_app_android/MainActivity.kt"
    click SpawnApp "https://github.com/daggerpov/spawn-app-android-kotlin/blob/main/Spawn-Android/app/src/main/java/com/example/spawn_app_android/SpawnApp.kt"
    click MapScreen "https://github.com/daggerpov/spawn-app-android-kotlin/blob/main/Spawn-Android/app/src/main/java/com/example/spawn_app_android/presentation/screens/Map.kt"
    click Drawables "https://github.com/daggerpov/spawn-app-android-kotlin/tree/main/Spawn-Android/app/src/main/res/drawable/"
    click Strings "https://github.com/daggerpov/spawn-app-android-kotlin/blob/main/Spawn-Android/app/src/main/res/values/strings.xml"
    click Token "https://github.com/daggerpov/spawn-app-android-kotlin/blob/main/Spawn-Android/app/src/main/res/values/mapbox_access_token.xml"
    click Gradle "https://github.com/daggerpov/spawn-app-android-kotlin/blob/main/Spawn-Android/app/build.gradle.kts"

    classDef presentation fill:#ADD8E6,stroke:#333,stroke-width:1px
    classDef domain fill:#90EE90,stroke:#333,stroke-width:1px
    classDef data fill:#FFFFE0,stroke:#333,stroke-width:1px
    classDef external fill:#D3D3D3,stroke:#333,stroke-width:1px
```
