PeopleInSpace

# PeopleInSpace

![kotlin-version](https://img.shields.io/badge/kotlin-2.4.0-blue?logo=kotlin)

**Kotlin Multiplatform** project with SwiftUI, Jetpack Compose, Compose for Wear OS, Compose for Desktop and Compose for Web clients along with Ktor backend. Currently running on
* Android (Jetpack Compose)
* Android App Widget (Compose based Glance API - contributed by https://github.com/yschimke)
* Wear OS (Compose for Wear OS - primarily developed by https://github.com/yschimke)  
* iOS (SwiftUI)
* Desktop (Compose for Desktop)
* Web (Compose for Web - Wasm based)
* Windows (WinUI 3)
* JVM (small Ktor back end service + `Main.kt` in `common` module)
* MCP server (using same shared KMP code)

The people data comes from [The Space Devs API](https://thespacedevs.com/llapi) (names, bios and images of the people
currently in space) and the position of the International Space Station from the
[Where the ISS at? API](https://wheretheiss.at/w/developer), both served through this
project's own small Ktor backend (see `backend` module below).

The project is included as sample in the official [Kotlin Multiplatform docs](https://kotlinlang.org/docs/multiplatform-samples.html) and also the [Google Dev Library](https://devlibrary.withgoogle.com/products/android)

### Architecture

All of the clients are thin UI layers over the same `common` module: the shared view models expose
`StateFlow`s of UI state, backed by a single repository that treats the local SQLDelight database as
the source of truth and refreshes it from the network.

```mermaid
flowchart TB
    subgraph clients["Clients"]
        direction LR
        android["<b>app</b><br/>Android · Jetpack Compose<br/>+ Glance / Remote Compose widgets"]
        wear["<b>wearApp</b><br/>Wear OS · Compose + Tile"]
        ios["<b>PeopleInSpaceSwiftUI</b><br/>iOS · SwiftUI (Swift Export)"]
        desktop["<b>compose-desktop</b><br/>JVM · Compose for Desktop"]
        web["<b>compose-web</b><br/>Kotlin/Wasm · Compose"]
        winui["<b>windows/WinUiApp</b><br/>.NET · WinUI 3"]
        mcp["<b>mcp-server</b><br/>JVM · Kotlin MCP SDK"]
    end

    subgraph common["common (Kotlin Multiplatform)"]
        direction TB
        cmpui["Compose Multiplatform UI<br/><i>PersonList / ISSPosition / ISSMapView</i><br/>(expect/actual map per platform)"]
        vm["View models<br/><i>PersonListViewModel · ISSPositionViewModel</i><br/>StateFlow&lt;UiState&gt;"]
        winclient["PeopleInSpaceClient<br/><i>mingwX64, exported via NuGet</i><br/>(no Koin / AndroidX)"]
        repo["<b>PeopleInSpaceRepository</b><br/>offline-first: DB is source of truth,<br/>ISS position polled every 10s"]
        db[("SQLDelight<br/>PeopleInSpaceDatabase")]
        api["Ktor client APIs<br/><i>PeopleInSpaceApi · AstroviewerApi</i>"]
        koin{{"Koin DI<br/>(annotations + compiler plugin)"}}

        cmpui --> vm
        vm --> repo
        winclient --> repo
        repo --> db
        repo --> api
        koin -.-> repo
    end

    subgraph r