Private

PeopleInSpace

See in Github

2025-06-01

Kotlin Multiplatform sample with SwiftUI, Jetpack Compose, Compose for Wear, Compose for Desktop, and Compose for Web clients along with Ktor backend.

3.1k

Github Watches

273

Github Forks

3.1k

Github Stars

PeopleInSpace

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)
Swift Executable Package
Desktop (Compose for Desktop)
Web (Compose for Web - Wasm based)
JVM (small Ktor back end service + Main.kt in common module)
MCP server (using same shared KMP code)

It makes use of Open Notify PeopleInSpace API to show list of people currently in space and also the position of the International Space Station (inspired by https://kousenit.org/2019/12/19/a-few-astronomical-examples-in-kotlin/)!

The project is included as sample in the official Kotlin Multiplatform Mobile docs and also the Google Dev Library

Note that this repository very much errs on the side of minimalism to help more clearly illustrate key moving parts of a Kotlin Multiplatform project and also to hopefully help someone just starting to explore KMP to get up and running for first time (and is of course primarily focused on use of Jetpack Compose and SwiftUI). If you're at the stage of moving beyond this then I'd definitely recommend checking out KaMPKit from Touchlab. I also have the following samples that demonstrate the use of a variety of Kotlin Multiplatform libraries (and also use Jetpack Compose and SwiftUI).

GalwayBus (https://github.com/joreilly/GalwayBus)
Confetti (https://github.com/joreilly/Confetti)
BikeShare (https://github.com/joreilly/BikeShare)
FantasyPremierLeague (https://github.com/joreilly/FantasyPremierLeague)
ClimateTrace (https://github.com/joreilly/ClimateTraceKMP)
GeminiKMP (https://github.com/joreilly/GeminiKMP)
MortyComposeKMM (https://github.com/joreilly/MortyComposeKMM)
StarWars (https://github.com/joreilly/StarWars)
WordMasterKMP (https://github.com/joreilly/WordMasterKMP)
Chip-8 (https://github.com/joreilly/chip-8)

Building

You need to use at least Android Studio Flamingo (note: Java 17 is now the minimum version required). Requires Xcode 13.2 or later (due to use of new Swift 5.5 concurrency APIs).

Open `PeopleInSpaceSwiftUI' for iOS projects.

To exercise (React based) web client run ./gradlew :web:browserDevelopmentRun.

To run backend you can either run ./gradlew :backend:run or run Server.kt directly from Android Studio. After doing that you should then for example be able to open http://localhost:9090/astros_local.json in a browser.

Compose for Web client (Wasm)

Similarly for Kotlin/Wasm based version ./gradlew :compose-web:wasmBrowserDevelopmentRun

Compose for Desktop client

This client is available in compose-desktop module and can be run using ./gradlew :compose-desktop:run. Note that you need to use appropriate version of JVM when running (works for example with Java 11)

Compose for iOS client

Can be run using for example ./gradlew :compose-ios:iosDeployIPhone13ProDebug

Backend code

Have tested this out in Google App Engine deployment. Using shadowJar plugin to create an "uber" jar and then deploying it as shown below. Should be possible to deploy this jar to other services as well.

./gradlew :backend:shadowJar
gcloud app deploy backend/build/libs/backend-all.jar --appyaml=backend/src/jvmMain/appengine/app.yaml

GraphQL backend

There's a GraphQL module (graphql-server) which can be run locally using ./gradlew :graphql-server:bootRun with "playground" then available at http://localhost:8080/playground

Screenshots

iOS (SwiftUI)

Android (Jetpack Compose)

Wear OS (Wear Compose)

Compose for Desktop

Compose for Web (Wasm based)

MCP

The mcp-server module uses the Kotlin MCP SDK to expose an MCP tools endpoint (returning list of people in space) that can for example be plugged in to Claude Desktop as shown below. That module uses same KMP shared code (that uses for example Ktor, SQLDelight and Koin)

To integrate the MCP server with Claude Desktop you need to firstly run gradle shadowJar task and then select "Edit Config" under Developer Settings and add something like the following (update with your path)

{
  "mcpServers": {
    "kotlin-peopleinspace": {
      "command": "java",
      "args": [
        "-jar",
        "/Users/john.oreilly/github/PeopleInSpace/mcp-server/build/libs/serverAll.jar",
        "--stdio"
      ]
    }
  }
}