# philipplackner/cmpdeeplinking architecture

> Architecture diagram of the GitHub repository philipplackner/cmpdeeplinking, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-04). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/philipplackner/cmpdeeplinking
- Repository: https://github.com/philipplackner/cmpdeeplinking

## Overview

This Kotlin Multiplatform app demonstrates shared Compose navigation with URI deep links. On iOS, an incoming URL is passed from the SwiftUI app to a shared URI handler; the shared listener forwards it to the navigation controller, which resolves list and detail destinations. Users can also open a detail from the list. Android and iOS entry points both launch the shared app. The graph focuses on these demonstrated paths; no Android URL-ingress configuration is shown in the sampled files.

Main entry points: [`composeApp/src/commonMain/kotlin/com/plcoding/cmp_deeplinking/navigation/NavRoot.kt`](https://github.com/philipplackner/cmpdeeplinking/blob/master/composeApp/src/commonMain/kotlin/com/plcoding/cmp_deeplinking/navigation/NavRoot.kt) (Navigation host), [`iosApp/iosApp/iOSApp.swift`](https://github.com/philipplackner/cmpdeeplinking/blob/master/iosApp/iosApp/iOSApp.swift) (iOS app), [`composeApp/src/commonMain/kotlin/com/plcoding/cmp_deeplinking/navigation/DeepLinkListener.kt`](https://github.com/philipplackner/cmpdeeplinking/blob/master/composeApp/src/commonMain/kotlin/com/plcoding/cmp_deeplinking/navigation/DeepLinkListener.kt) (Deep-link listener), [`composeApp/src/commonMain/kotlin/com/plcoding/cmp_deeplinking/App.kt`](https://github.com/philipplackner/cmpdeeplinking/blob/master/composeApp/src/commonMain/kotlin/com/plcoding/cmp_deeplinking/App.kt) (Shared app)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_platforms["Platform entry points"]
  node_ios_app["iOS app<br/>[iOSApp.swift]"]
  node_ios_view["Compose host<br/>[ContentView.swift]"]
  node_ios_controller["iOS controller"]
  node_android_activity["Android activity<br/>[MainActivity.kt]"]
end

subgraph group_shared["Shared application"]
  node_app["Shared app<br/>[App.kt]"]
  node_platform_contract["Platform contract<br/>[Platform.kt]"]
  node_android_platform["Android platform"]
  node_ios_platform["iOS platform<br/>[Platform.ios.kt]"]
end

subgraph group_navigation["Navigation and links"]
  node_nav_root["Navigation host<br/>[NavRoot.kt]"]
  node_routes["Route definitions<br/>[Route.kt]"]
  node_deep_listener["Deep-link listener"]
  node_uri_handler["URI handler"]
end

node_external(("URL sender"))

node_external -->|"opens URL"| node_ios_app
node_ios_app -->|"shows view"| node_ios_view
node_ios_app -->|"passes URI"| node_uri_handler
node_ios_view -->|"creates controller"| node_ios_controller
node_ios_controller -->|"launches"| node_app
node_android_activity -->|"launches"| node_app
node_app -->|"renders"| node_nav_root
node_nav_root -->|"installs"| node_deep_listener
node_deep_listener -->|"registers listener"| node_uri_handler
node_deep_listener -->|"navigates URI"| node_nav_root
node_nav_root -->|"uses routes"| node_routes
node_nav_root -->|"opens detail"| node_nav_root
node_android_platform -->|"implements"| node_platform_contract
node_ios_platform -->|"implements"| node_platform_contract

click node_ios_app "https://github.com/philipplackner/cmpdeeplinking/blob/master/iosApp/iosApp/iOSApp.swift"
click node_ios_view "https://github.com/philipplackner/cmpdeeplinking/blob/master/iosApp/iosApp/ContentView.swift"
click node_ios_controller "https://github.com/philipplackner/cmpdeeplinking/blob/master/composeApp/src/iosMain/kotlin/com/plcoding/cmp_deeplinking/MainViewController.kt"
click node_android_activity "https://github.com/philipplackner/cmpdeeplinking/blob/master/composeApp/src/androidMain/kotlin/com/plcoding/cmp_deeplinking/MainActivity.kt"
click node_app "https://github.com/philipplackner/cmpdeeplinking/blob/master/composeApp/src/commonMain/kotlin/com/plcoding/cmp_deeplinking/App.kt"
click node_platform_contract "https://github.com/philipplackner/cmpdeeplinking/blob/master/composeApp/src/commonMain/kotlin/com/plcoding/cmp_deeplinking/Platform.kt"
click node_android_platform "https://github.com/philipplackner/cmpdeeplinking/blob/master/composeApp/src/androidMain/kotlin/com/plcoding/cmp_deeplinking/Platform.android.kt"
click node_ios_platform "https://github.com/philipplackner/cmpdeeplinking/blob/master/composeApp/src/iosMain/kotlin/com/plcoding/cmp_deeplinking/Platform.ios.kt"
click node_nav_root "https://github.com/philipplackner/cmpdeeplinking/blob/master/composeApp/src/commonMain/kotlin/com/plcoding/cmp_deeplinking/navigation/NavRoot.kt"
click node_routes "https://github.com/philipplackner/cmpdeeplinking/blob/master/composeApp/src/commonMain/kotlin/com/plcoding/cmp_deeplinking/navigation/Route.kt"
click node_deep_listener "https://github.com/philipplackner/cmpdeeplinking/blob/master/composeApp/src/commonMain/kotlin/com/plcoding/cmp_deeplinking/navigation/DeepLinkListener.kt"
click node_uri_handler "https://github.com/philipplackner/cmpdeeplinking/blob/master/composeApp/src/commonMain/kotlin/com/plcoding/cmp_deeplinking/navigation/ExternalUriHandler.kt"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_ios_app,node_ios_view,node_ios_controller,node_android_activity toneBlue
class node_app,node_platform_contract,node_android_platform,node_ios_platform toneAmber
class node_nav_root,node_routes,node_deep_listener,node_uri_handler toneMint
class node_external toneIndigo
```

## Components

### Platform entry points

- [iOS app](https://github.com/philipplackner/cmpdeeplinking/blob/master/iosApp/iosApp/iOSApp.swift): `iosApp/iosApp/iOSApp.swift`
- [Compose host](https://github.com/philipplackner/cmpdeeplinking/blob/master/iosApp/iosApp/ContentView.swift): `iosApp/iosApp/ContentView.swift`
- [iOS controller](https://github.com/philipplackner/cmpdeeplinking/blob/master/composeApp/src/iosMain/kotlin/com/plcoding/cmp_deeplinking/MainViewController.kt): `composeApp/src/iosMain/kotlin/com/plcoding/cmp_deeplinking/MainViewController.kt`
- [Android activity](https://github.com/philipplackner/cmpdeeplinking/blob/master/composeApp/src/androidMain/kotlin/com/plcoding/cmp_deeplinking/MainActivity.kt): `composeApp/src/androidMain/kotlin/com/plcoding/cmp_deeplinking/MainActivity.kt`

### Shared application

- [Shared app](https://github.com/philipplackner/cmpdeeplinking/blob/master/composeApp/src/commonMain/kotlin/com/plcoding/cmp_deeplinking/App.kt): `composeApp/src/commonMain/kotlin/com/plcoding/cmp_deeplinking/App.kt`
- [Platform contract](https://github.com/philipplackner/cmpdeeplinking/blob/master/composeApp/src/commonMain/kotlin/com/plcoding/cmp_deeplinking/Platform.kt): `composeApp/src/commonMain/kotlin/com/plcoding/cmp_deeplinking/Platform.kt`
- [Android platform](https://github.com/philipplackner/cmpdeeplinking/blob/master/composeApp/src/androidMain/kotlin/com/plcoding/cmp_deeplinking/Platform.android.kt): `composeApp/src/androidMain/kotlin/com/plcoding/cmp_deeplinking/Platform.android.kt`
- [iOS platform](https://github.com/philipplackner/cmpdeeplinking/blob/master/composeApp/src/iosMain/kotlin/com/plcoding/cmp_deeplinking/Platform.ios.kt): `composeApp/src/iosMain/kotlin/com/plcoding/cmp_deeplinking/Platform.ios.kt`

### Navigation and links

- [Navigation host](https://github.com/philipplackner/cmpdeeplinking/blob/master/composeApp/src/commonMain/kotlin/com/plcoding/cmp_deeplinking/navigation/NavRoot.kt): `composeApp/src/commonMain/kotlin/com/plcoding/cmp_deeplinking/navigation/NavRoot.kt`
- [Route definitions](https://github.com/philipplackner/cmpdeeplinking/blob/master/composeApp/src/commonMain/kotlin/com/plcoding/cmp_deeplinking/navigation/Route.kt): `composeApp/src/commonMain/kotlin/com/plcoding/cmp_deeplinking/navigation/Route.kt`
- [Deep-link listener](https://github.com/philipplackner/cmpdeeplinking/blob/master/composeApp/src/commonMain/kotlin/com/plcoding/cmp_deeplinking/navigation/DeepLinkListener.kt): `composeApp/src/commonMain/kotlin/com/plcoding/cmp_deeplinking/navigation/DeepLinkListener.kt`
- [URI handler](https://github.com/philipplackner/cmpdeeplinking/blob/master/composeApp/src/commonMain/kotlin/com/plcoding/cmp_deeplinking/navigation/ExternalUriHandler.kt): `composeApp/src/commonMain/kotlin/com/plcoding/cmp_deeplinking/navigation/ExternalUriHandler.kt`

### Other components

- **URL sender**

## Connections

- URL sender → iOS app: opens URL (evidence: `iosApp/iosApp/iOSApp.swift`)
- iOS app → Compose host: shows view (evidence: `iosApp/iosApp/iOSApp.swift`)
- iOS app → URI handler: passes URI (evidence: `iosApp/iosApp/iOSApp.swift`)
- Compose host → iOS controller: creates controller (evidence: `iosApp/iosApp/ContentView.swift`)
- iOS controller → Shared app: launches (evidence: `composeApp/src/iosMain/kotlin/com/plcoding/cmp_deeplinking/MainViewController.kt`)
- Android activity → Shared app: launches (evidence: `composeApp/src/androidMain/kotlin/com/plcoding/cmp_deeplinking/MainActivity.kt`)
- Shared app → Navigation host: renders (evidence: `composeApp/src/commonMain/kotlin/com/plcoding/cmp_deeplinking/App.kt`)
- Navigation host → Deep-link listener: installs (evidence: `composeApp/src/commonMain/kotlin/com/plcoding/cmp_deeplinking/navigation/NavRoot.kt`)
- Deep-link listener → URI handler: registers listener (evidence: `composeApp/src/commonMain/kotlin/com/plcoding/cmp_deeplinking/navigation/DeepLinkListener.kt`)
- Deep-link listener → Navigation host: navigates URI (evidence: `composeApp/src/commonMain/kotlin/com/plcoding/cmp_deeplinking/navigation/DeepLinkListener.kt`)
- Navigation host → Route definitions: uses routes (evidence: `composeApp/src/commonMain/kotlin/com/plcoding/cmp_deeplinking/navigation/NavRoot.kt`)
- Navigation host → Navigation host: opens detail (evidence: `composeApp/src/commonMain/kotlin/com/plcoding/cmp_deeplinking/navigation/NavRoot.kt`)
- Android platform → Platform contract: implements (evidence: `composeApp/src/androidMain/kotlin/com/plcoding/cmp_deeplinking/Platform.android.kt`)
- iOS platform → Platform contract: implements (evidence: `composeApp/src/iosMain/kotlin/com/plcoding/cmp_deeplinking/Platform.ios.kt`)
