Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

https://github.com/joreilly/PeopleInSpace

Kotlin Multiplatform project with SwiftUI, Jetpack Compose, Compose for Wear, Compose for Desktop, Compose for Web and Kotlin/JS + React clients along with Ktor backend.
https://github.com/joreilly/PeopleInSpace

android android-architecture-components compose-desktop compose-ios compose-multiplatform compose-web ios jetpack-compose kmp koin kotlin kotlin-coroutines kotlin-js kotlin-multiplatform kotlin-multiplatform-mobile kotlin-native ktor swift swiftui wasm

Last synced: 16 days ago
JSON representation

Kotlin Multiplatform project with SwiftUI, Jetpack Compose, Compose for Wear, Compose for Desktop, Compose for Web and Kotlin/JS + React clients along with Ktor backend.

Host: GitHub
URL: https://github.com/joreilly/PeopleInSpace
Owner: joreilly
License: apache-2.0
Created: 2019-12-22T20:19:16.000Z (over 4 years ago)
Default Branch: main
Last Pushed: 2024-05-22T15:39:38.000Z (about 1 month ago)
Last Synced: 2024-05-22T16:48:35.348Z (about 1 month ago)
Topics: android, android-architecture-components, compose-desktop, compose-ios, compose-multiplatform, compose-web, ios, jetpack-compose, kmp, koin, kotlin, kotlin-coroutines, kotlin-js, kotlin-multiplatform, kotlin-multiplatform-mobile, kotlin-native, ktor, swift, swiftui, wasm
Language: Kotlin
Homepage:
Size: 69.4 MB
Stars: 2,797
Watchers: 42
Forks: 249
Open Issues: 20
Metadata Files:
- Readme: README.md
- License: LICENSE

Lists

awesome-github-repos - joreilly/PeopleInSpace - Kotlin Multiplatform project with SwiftUI, Jetpack Compose, Compose for Wear, Compose for Desktop, and Compose for Web clients along with Ktor backend. (Kotlin)
awesome-kotlin - PeopleInSpace - Minimal Kotlin Multiplatform project using Jetpack Compose and SwiftUI (Libraries)
awesome-compose - PeopleInSpace - Minimal Kotlin Multiplatform project with SwiftUI, Jetpack Compose, Compose for Desktop, Compose for Web, and Kotlin/JS + React clients along with Ktor backend (Miscellaneous)
awesome-github-star - PeopleInSpace
awesome-kotlin - PeopleInSpace - Minimal Kotlin Multiplatform project using Jetpack Compose and SwiftUI (Libraries)
awesome-kotlin-multiplatform - PeopleInSpace
fucking-open-source-ios-apps - PeopleInSpace

README

        # PeopleInSpace

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

**Kotlin Multiplatform** project with SwiftUI, Jetpack Compose, Compose for Wear OS, Compose for Desktop, Compose for Web, and Kotlin/JS + React 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)

* iOS App Widget (SwiftUI)

* watchOS (SwiftUI) (contributed by https://github.com/nealsanche)

* macOS (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)

It makes use of [Open Notify PeopleInSpace API](http://open-notify.org/Open-Notify-API/People-In-Space/) 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](https://kotlinlang.org/docs/mobile/samples.html#peopleinspace) and also the [Google Dev Library](https://devlibrary.withgoogle.com/products/android)

Related posts:

* [Minimal Kotlin Multiplatform project using Compose and SwiftUI](https://johnoreilly.dev/posts/minimal-kotlin-platform-compose-swiftui/)

* [Adding some Storage (to) Space](https://johnoreilly.dev/posts/adding-sqldelight-to-peopleinspace/)

* [Kotlin Multiplatform running on macOS](https://johnoreilly.dev/posts/kotlinmultiplatform-macos/)

* [PeopleInSpace hits the web with Kotlin/JS and React](https://johnoreilly.dev/posts/peopleinspace-kotlinjs/)

* [Using Koin in a Kotlin Multiplatform Project](https://johnoreilly.dev/posts/kotlinmultiplatform-koin/)

* [Jetpack Compose for the Desktop!](https://johnoreilly.dev/posts/jetpack-compose-desktop-copy/)

* [Comparing use of LiveData and StateFlow in a Jetpack Compose project](https://johnoreilly.dev/posts/jetpack-compose-stateflow-livedata/)

* [Wrapping Kotlin Flow with Swift Combine Publisher in a Kotlin Multiplatform project](https://johnoreilly.dev/posts/kotlinmultiplatform-swift-combine_publisher-flow/)

* [Using Swift Packages in a Kotlin Multiplatform project](https://johnoreilly.dev/posts/kotlinmultiplatform-swift-package/)

* [Using Swift's new async/await when invoking Kotlin Multiplatform code](https://johnoreilly.dev/posts/swift_async_await_kotlin_coroutines/)

* [Exploring new AWS SDK for Kotlin](https://johnoreilly.dev/posts/aws-sdk-kotlin/)

* [Creating a Swift command line app that consumes Kotlin Multiplatform code](https://johnoreilly.dev/posts/swift-command-line-kotlin-multiplatform/)

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](https://github.com/touchlab/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/watchOS/macOS 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)**






**watchOS (SwiftUI)**








**Wear OS (Wear Compose)**










**macOS (SwiftUI)**






**Compose for Desktop**






**Compose for Web (Wasm based)**






### Languages, libraries and tools used

* [Kotlin](https://kotlinlang.org/)

* [Kotlin Coroutines](https://kotlinlang.org/docs/reference/coroutines-overview.html)

* [Kotlinx Serialization](https://github.com/Kotlin/kotlinx.serialization)

* [Ktor client library](https://github.com/ktorio/ktor)

* [Android Architecture Components](https://developer.android.com/topic/libraries/architecture/index.html)

* [Koin](https://github.com/InsertKoinIO/koin)

* [SQLDelight](https://github.com/cashapp/sqldelight)

* [Jetpack Compose](https://developer.android.com/jetpack/compose)

* [SwiftUI](https://developer.apple.com/documentation/swiftui)

* [KMP-NativeCoroutines](https://github.com/rickclephas/KMP-NativeCoroutines)

* [Coil](https://coil-kt.github.io/coil/)