# nachoarrieta/tvapplicationkmp architecture

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

- Interactive diagram: https://gitdiagram.com/nachoarrieta/tvapplicationkmp
- Repository: https://github.com/nachoarrieta/tvapplicationkmp

## Overview

##### Project type and purpose
- This is a Kotlin Multiplatform “ComposeApp” library + an iOS “iosApp” entry point.
- Targets: Android (via Android SDK), iOS (via SwiftUI host), Desktop (JVM Compose), Web (WASM/JS).
- Purpose: share UI, view-models, data layer, resources across four platforms.

##### File structure
- Top-level modules:
– composeApp/ (KMP library)
– iosApp/ (SwiftUI iOS wrapper)
- Inside composeApp:
– commonMain/ – shared business logic, models, repository, UI Composables, view-models, navigation, theme, utils.
– androidMain/ – AndroidActivity entry (MainActivity.kt), AndroidManifest, resources (drawables, strings, mipmaps).
– iosMain/ – iOS-specific bridges (MainViewController.kt), Platform.ios.kt.
– desktopMain/ – JVM host main.kt, Platform.jvm.kt.
– wasmJsMain/ – Web host main.kt, Platform.wasmJs.kt, index.html, styles.css.
– commonTest/ – shared tests.
- iosApp folder: Swift/Xcode project, SwiftUI ContentView.swift, Info.plist, asset catalogs – this wraps the Compose library for iOS entry.

##### README for additional insights
- Confirms KMP targets and folder roles.
- Compose Multiplatform for UI sharing; iosApp is required entry for SwiftUI integration.
- Web launch via Gradle task `:composeApp:wasmJsBrowserDevelopmentRun`.

## Diagram (Mermaid)

```mermaid
flowchart TB
    ExternalAPI[(External API)]:::external

    subgraph "Shared Library (composeApp)"
        direction TB
        subgraph "Data Layer"
            direction TB
            ApiClient["ApiClient.kt"]:::shared
            ApiInterface["ApiInterface.kt"]:::shared
            ApiService["ApiService.kt"]:::shared
        end
        subgraph "Repository"
            Repository["Repository.kt"]:::shared
        end
        subgraph "ViewModels"
            AppViewModel["AppViewModel.kt"]:::shared
            OtherVM["Other ViewModels"]:::shared
        end
        subgraph "UI Composables & Navigation"
            Components["component package"]:::shared
            NavGraph["NavGraph.kt"]:::shared
            NavigationScreen["NavigationScreen.kt"]:::shared
        end
        subgraph "Theme & Styling"
            Theme["Theme.kt"]:::shared
            Color["Color.kt"]:::shared
            Shape["Shape.kt"]:::shared
            Type["Type.kt"]:::shared
        end
    end

    subgraph "Android Host"
        AndroidHost["MainActivity.kt"]:::platform
        AndroidRes["AndroidManifest.xml & Resources"]:::platform
    end

    subgraph "iOS Host"
        iOSHost["MainViewController.kt"]:::platform
        PlatformiOS["Platform.ios.kt"]:::platform
        iOSAppContent["ContentView.swift"]:::platform
        iOSInfo["Info.plist"]:::platform
    end

    subgraph "Desktop Host"
        DesktopHost["main.kt (Desktop)"]:::platform
        PlatformJVM["Platform.jvm.kt"]:::platform
    end

    subgraph "Web Host"
        WebHost["main.kt (Web)"]:::platform
        PlatformWASM["Platform.wasmJs.kt"]:::platform
        IndexHTML["index.html"]:::platform
        StylesCSS["styles.css"]:::platform
    end

    ExternalAPI --> ApiService
    ApiService --> Repository
    Repository --> AppViewModel
    AppViewModel --> Components
    Components --> AndroidHost
    Components --> iOSHost
    Components --> DesktopHost
    Components --> WebHost

    classDef shared fill:#D0E8FF,stroke:#1E90FF
    classDef platform fill:#D0FFD6,stroke:#4CAF50
    classDef external fill:#FFE5B4,stroke:#FF8C00

    click ApiClient "https://github.com/nachoarrieta/tvapplicationkmp/blob/master/composeApp/src/commonMain/kotlin/data/remote/ApiClient.kt"
    click ApiInterface "https://github.com/nachoarrieta/tvapplicationkmp/blob/master/composeApp/src/commonMain/kotlin/data/remote/ApiInterface.kt"
    click ApiService "https://github.com/nachoarrieta/tvapplicationkmp/blob/master/composeApp/src/commonMain/kotlin/data/remote/ApiService.kt"
    click Repository "https://github.com/nachoarrieta/tvapplicationkmp/blob/master/composeApp/src/commonMain/kotlin/data/repository/Repository.kt"
    click AppViewModel "https://github.com/nachoarrieta/tvapplicationkmp/blob/master/composeApp/src/commonMain/kotlin/ui/AppViewModel.kt"
    click Components "https://github.com/nachoarrieta/tvapplicationkmp/tree/master/composeApp/src/commonMain/kotlin/component/"
    click NavGraph "https://github.com/nachoarrieta/tvapplicationkmp/blob/master/composeApp/src/commonMain/kotlin/navigation/NavGraph.kt"
    click NavigationScreen "https://github.com/nachoarrieta/tvapplicationkmp/blob/master/composeApp/src/commonMain/kotlin/navigation/NavigationScreen.kt"
    click Theme "https://github.com/nachoarrieta/tvapplicationkmp/blob/master/composeApp/src/commonMain/kotlin/theme/Theme.kt"
    click Color "https://github.com/nachoarrieta/tvapplicationkmp/blob/master/composeApp/src/commonMain/kotlin/theme/Color.kt"
    click Shape "https://github.com/nachoarrieta/tvapplicationkmp/blob/master/composeApp/src/commonMain/kotlin/theme/Shape.kt"
    click Type "https://github.com/nachoarrieta/tvapplicationkmp/blob/master/composeApp/src/commonMain/kotlin/theme/Type.kt"
    click AndroidHost "https://github.com/nachoarrieta/tvapplicationkmp/blob/master/composeApp/src/androidMain/kotlin/nacho/tv/application/kmp/MainActivity.kt"
    click AndroidRes "https://github.com/nachoarrieta/tvapplicationkmp/blob/master/composeApp/src/androidMain/AndroidManifest.xml"
    click iOSHost "https://github.com/nachoarrieta/tvapplicationkmp/blob/master/composeApp/src/iosMain/kotlin/nacho/tv/application/kmp/MainViewController.kt"
    click PlatformiOS "https://github.com/nachoarrieta/tvapplicationkmp/blob/master/composeApp/src/iosMain/kotlin/nacho/tv/application/kmp/Platform.ios.kt"
    click iOSAppContent "https://github.com/nachoarrieta/tvapplicationkmp/blob/master/iosApp/iosApp/ContentView.swift"
    click iOSInfo "https://github.com/nachoarrieta/tvapplicationkmp/blob/master/iosApp/iosApp/Info.plist"
    click DesktopHost "https://github.com/nachoarrieta/tvapplicationkmp/blob/master/composeApp/src/desktopMain/kotlin/nacho/tv/application/kmp/main.kt"
    click PlatformJVM "https://github.com/nachoarrieta/tvapplicationkmp/blob/master/composeApp/src/desktopMain/kotlin/nacho/tv/application/kmp/Platform.jvm.kt"
    click WebHost "https://github.com/nachoarrieta/tvapplicationkmp/blob/master/composeApp/src/wasmJsMain/kotlin/nacho/tv/application/kmp/main.kt"
    click PlatformWASM "https://github.com/nachoarrieta/tvapplicationkmp/blob/master/composeApp/src/wasmJsMain/kotlin/nacho/tv/application/kmp/Platform.wasmJs.kt"
    click IndexHTML "https://github.com/nachoarrieta/tvapplicationkmp/blob/master/composeApp/src/wasmJsMain/resources/index.html"
    click StylesCSS "https://github.com/nachoarrieta/tvapplicationkmp/blob/master/composeApp/src/wasmJsMain/resources/styles.css"
```
