wbrawner/PeopleInSpace

Fork 0

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

Find a file

John O'Reilly 86cc905034 Merge pull request #55 from PatilShreyas/sp/web-app [Web] Design ReactJS Web app with Material Designing components		2021-06-06 20:12:53 +01:00
.github/workflows	kotlin/js gh-pages deploy updates	2021-02-05 14:19:48 +00:00
app	compose build updates	2021-05-29 14:49:17 +01:00
backend	further compose for web changes	2021-05-20 18:24:18 +01:00
buildSrc	build cleanup	2021-05-26 19:46:30 +01:00
common	use 7.0.0-beta02 gradle plugin	2021-05-29 14:23:54 +01:00
compose-desktop	Loading images in ui thread would cause screen freezing.	2021-04-09 16:51:36 +08:00
compose-web	compose web updates	2021-05-29 16:40:59 +01:00
gradle/wrapper	use 7.0.0-beta02 gradle plugin	2021-05-29 14:23:54 +01:00
ios/PeopleInSpaceSwiftUI	SwiftUI: show iss position on map	2021-02-27 10:11:41 +00:00
macOS/PeopleInSpace	macOS map fix	2021-01-10 20:16:38 +00:00
watchos/PeopleInSpaceWatch	scope updates	2020-11-01 17:31:51 +00:00
web	Design main app interface with material design	2021-06-06 23:45:53 +05:30
.gitignore	Removed file that shouldn't be tracked	2020-09-06 16:19:54 +01:00
build.gradle.kts	gradle plugin 7.0.0-beta03	2021-05-29 14:29:02 +01:00
gradle.properties	update to kotlin 1.4.10 + other dependency updates	2020-09-10 17:30:00 +01:00
gradlew	Update gradle to 6.5.1	2020-07-21 12:11:41 +02:00
gradlew.bat	Update gradle to 6.5.1	2020-07-21 12:11:41 +02:00
LICENSE	add Apache-2 license	2020-10-12 20:22:08 +01:00
README.md	Add screenshot of web app	2021-06-06 23:51:50 +05:30
settings.gradle.kts	build cleanup	2021-05-26 19:46:30 +01:00

README.md

PeopleInSpace

Minimal Kotlin Multiplatform project using Compose and SwiftUI. Currently running on

Android (Jetpack Compose)
iOS (SwiftUI)
watchOS (SwiftUI)
macOS (SwiftUI)
Desktop (Compose for Desktop)
Web (Compose for Web)
Web (Kotlin/JS + React Wrapper)
JVM (small Ktor back end service + Main.kt in common module)

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 focussed on use of Jetpack Compose and SwiftUI). If you're at 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).

Building

You need to use Android Studio Arctic Fox (note: Java 11 is now the minimum version required). Have tested with XCode v11 and v12.

When opening iOS/watchOS/macOS projects remember to open .xcworkspace file (and not .xcodeproj one).

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

The Compose for Web client resides in the compose-web module and can be run by invoking ./gradlew :compose-web:jsBrowserDevelopmentRun

Compose for Desktop client

This client is available in compose-desktop module. Note that you need to use appropriate version of JVM when running (works for example with Java 11)