# felipekoga/deeplink-launcher architecture

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

- Interactive diagram: https://gitdiagram.com/felipekoga/deeplink-launcher
- Repository: https://github.com/felipekoga/deeplink-launcher

## Overview

##### Project Type and Purpose
- This is a full-stack, modular Kotlin Multiplatform Compose application called “DeepLink Launcher.” It provides a UI on Android, iOS and desktop to execute, organize, share and track deeplinks.

##### File Structure Analysis
- Top-level “androidApp”, “iosApp” and “desktopApp” modules are the platform-specific entry points.
- “shared” contains common UI setup and DI initialization.
- “core” houses low-level, reusable libraries (coroutines, database, file, date, navigation, preferences, resources, design system, UI events).
- “feature” is broken out by domain (deeplink, device-bridge, home, import-export, purchase, settings), each subdivided into API, implementation and UI submodules.
- Build logic, configuration and CI/CD files live in “build-logic”, “config” and “.github”.

##### README Insights
- Uses Compose Multiplatform for cross-platform UI, Koin for DI, SQLDelight for the database, DataStore for preferences, Material3, RevenueCat for IAP, and external device control via ADB/Xcrun.

##### Main Components and Interactions
a. Platform Apps: Android, iOS, Desktop – each depends on shared UI + feature modules.
b. Shared Module: hosts cross-platform UI entry, KoinInit, common animations & DI.
c. Core Libraries: data layer (SQLDelight DB, DataStore), file I/O, date/time, navigation, coroutines, resources, design system, UI events.
d. Feature Layers:
– Domain API modules (interfaces)
– Domain Impl modules (use-cases, repositories, mappers)
– UI modules (screens, components, view-models)
e. External Services:
– Local SQLite through SQLDelight
– Android DataStore
– ADB and Xcrun via the device-bridge feature
– RevenueCat for in-app purchase

##### Architectural Patterns
- Layered architecture: Presentation (Compose UI) → Domain (Use-cases & repositories) → Data (SQLDelight, DataStore, file, device bridge).
- Modular design: clear separation of concerns per feature and per platform.
- Dependency Injection with Koin.
- Kotlin Multiplatform with “commonMain” vs platformMain source sets.

## Diagram (Mermaid)

```mermaid
flowchart TD
    %% Platform Apps
    subgraph "Platform Apps"
        androidApp["Android App"]:::platform
        iosApp["iOS App"]:::platform
        desktopApp["Desktop App"]:::platform
    end

    %% Shared Module
    shared["shared"]:::shared

    %% Feature Modules
    subgraph "Features"
        deeplinkUI["DeepLink UI"]:::feature
        deeplinkAPI["DeepLink API"]:::feature
        deeplinkImpl["DeepLink Impl"]:::feature

        deviceBridgeAPI["Device-Bridge API"]:::feature
        deviceBridgeImpl["Device-Bridge Impl"]:::feature

        homeUI["Home UI"]:::feature

        importExportUI["Import-Export UI"]:::feature
        importExportAPI["Import-Export API"]:::feature
        importExportImpl["Import-Export Impl"]:::feature

        purchaseAPI["Purchase API"]:::feature
        purchaseImpl["Purchase Impl"]:::feature

        settingsUI["Settings UI"]:::feature
    end

    %% Core Libraries
    subgraph "Core Libraries"
        coroutines["Coroutines"]:::core
        database["Database"]:::core
        date["Date/Time"]:::core
        designsystem["Design System"]:::core
        fileio["File I/O"]:::core
        navigation["Navigation"]:::core
        platformAbst["Platform Abstraction"]:::core
        preferences["Preferences/DataStore"]:::core
        resources["Resources"]:::core
        uievent["UI Events"]:::core
    end

    %% External Services
    subgraph "External Services"
        sql["SQLDelight DB"]:::external
        dataStore["Android DataStore"]:::external
        adb["ADB/Xcrun"]:::external
        revenueCat["RevenueCat"]:::external
    end

    %% Dependencies and Flows
    androidApp --> shared
    iosApp --> shared
    desktopApp --> shared

    shared --> deeplinkUI
    shared --> deviceBridgeAPI
    shared --> homeUI
    shared --> importExportUI
    shared --> purchaseAPI
    shared --> settingsUI

    deeplinkUI --> deeplinkAPI --> deeplinkImpl --> database
    deviceBridgeAPI --> deviceBridgeImpl --> adb
    homeUI --> coroutines
    importExportUI --> importExportAPI --> importExportImpl --> fileio
    purchaseAPI --> purchaseImpl --> revenueCat
    settingsUI --> preferences --> dataStore

    shared --> coroutines
    shared --> navigation
    shared --> designsystem
    shared --> uievent
    shared --> resources
    shared --> platformAbst

    database --> sql

    %% Click Events
    click androidApp "https://github.com/felipekoga/deeplink-launcher/tree/main/androidApp/src/main/java/dev/koga/deeplinklauncher/android"
    click iosApp "https://github.com/felipekoga/deeplink-launcher/tree/main/iosApp/deeplinklauncher"
    click desktopApp "https://github.com/felipekoga/deeplink-launcher/blob/main/desktopApp/src/jvmMain/kotlin/Main.kt"
    click shared "https://github.com/felipekoga/deeplink-launcher/tree/main/shared/src/commonMain/kotlin/dev/koga/deeplinklauncher/shared"
    click coroutines "https://github.com/felipekoga/deeplink-launcher/tree/main/core/coroutines/src/commonMain/kotlin/dev/koga/deeplinklauncher/coroutines"
    click database "https://github.com/felipekoga/deeplink-launcher/tree/main/core/database/src/commonMain/kotlin/dev/koga/deeplinklauncher/database"
    click date "https://github.com/felipekoga/deeplink-launcher/tree/main/core/date/src/commonMain/kotlin/dev/koga/deeplinklauncher/date"
    click designsystem "https://github.com/felipekoga/deeplink-launcher/tree/main/core/designsystem/src/commonMain/kotlin/dev/koga/deeplinklauncher/designsystem"
    click fileio "https://github.com/felipekoga/deeplink-launcher/tree/main/core/file/src/commonMain/kotlin/dev/koga/deeplinklauncher/file"
    click navigation "https://github.com/felipekoga/deeplink-launcher/tree/main/core/navigation/src/commonMain/kotlin/dev/koga/deeplinklauncher/navigation"
    click platformAbst "https://github.com/felipekoga/deeplink-launcher/tree/main/core/platform/src/commonMain/kotlin/dev/koga/deeplinklauncher/platform"
    click preferences "https://github.com/felipekoga/deeplink-launcher/tree/main/core/preferences/src/commonMain/kotlin/dev/koga/deeplinklauncher/preferences"
    click resources "https://github.com/felipekoga/deeplink-launcher/tree/main/core/resources/src/commonMain/composeResources"
    click uievent "https://github.com/felipekoga/deeplink-launcher/tree/main/core/ui-event/src/commonMain/kotlin/dev/koga/deeplinklauncher/uievent"
    click deeplinkAPI "https://github.com/felipekoga/deeplink-launcher/tree/main/feature/deeplink/api/src/commonMain/kotlin/dev/koga/deeplinklauncher/deeplink/api"
    click deeplinkImpl "https://github.com/felipekoga/deeplink-launcher/tree/main/feature/deeplink/impl/src/commonMain/kotlin/dev/koga/deeplinklauncher/deeplink/impl"
    click deeplinkUI "https://github.com/felipekoga/deeplink-launcher/tree/main/feature/deeplink/ui/src/commonMain/kotlin/dev/koga/deeplinklauncher/deeplink/ui"
    click deviceBridgeAPI "https://github.com/felipekoga/deeplink-launcher/tree/main/feature/device-bridge/api/src/main/kotlin/dev/koga/deeplinklauncher/devicebridge/api"
    click deviceBridgeImpl "https://github.com/felipekoga/deeplink-launcher/tree/main/feature/device-bridge/impl/src/main/kotlin/dev/koga/deeplinklauncher/devicebridge/impl"
    click homeUI "https://github.com/felipekoga/deeplink-launcher/tree/main/feature/home/ui/src/commonMain/kotlin/dev/koga/deeplinklauncher/home/ui"
    click importExportAPI "https://github.com/felipekoga/deeplink-launcher/tree/main/feature/import-export/api/src/commonMain/kotlin/dev/koga/deeplinklauncher/importexport"
    click importExportImpl "https://github.com/felipekoga/deeplink-launcher/tree/main/feature/import-export/impl/src/commonMain/kotlin/dev/koga/deeplinklauncher/importexport/impl"
    click importExportUI "https://github.com/felipekoga/deeplink-launcher/tree/main/feature/import-export/ui/src/commonMain/kotlin/dev/koga/deeplinklauncher/importdata/ui"
    click purchaseAPI "https://github.com/felipekoga/deeplink-launcher/tree/main/feature/purchase/api/src/commonMain/kotlin/dev/koga/deeplinklauncher/purchase/api"
    click purchaseImpl "https://github.com/felipekoga/deeplink-launcher/tree/main/feature/purchase/impl/src/commonMain/kotlin/dev/koga/deeplinklauncher/purchase/impl"
    click settingsUI "https://github.com/felipekoga/deeplink-launcher/tree/main/feature/settings/ui/src/commonMain/kotlin/dev/koga/deeplinklauncher/settings/ui"
    click buildLogic "https://github.com/felipekoga/deeplink-launcher/tree/main/build-logic/src/main/kotlin"
    click github "https://github.com/felipekoga/deeplink-launcher/tree/main/.github/workflows"
    click config "https://github.com/felipekoga/deeplink-launcher/blob/main/config/filters/detekt.yml"

    %% Styles
    classDef platform fill:#2196f3,stroke:#000,color:#fff
    classDef shared fill:#4caf50,stroke:#000,color:#fff
    classDef feature fill:#ff9800,stroke:#000,color:#000
    classDef core fill:#9e9e9e,stroke:#000,color:#000
    classDef external fill:#b39ddb,stroke:#000,color:#000
```
