GalwayBus

GalwayBus shows live bus times for Galway city: real-time departures for your saved stops, stops near you, live on-map bus tracking with a journey timeline, and network-wide stop search. A single Compose Multiplatform UI is shared across Android, iOS and Desktop (JVM), backed by a Ktor service that serves GTFS schedule and GTFS-Realtime data.

Screenshots

Android (Jetpack Compose)

iOS (Compose Multiplatform)

The same Compose Multiplatform UI also runs on Desktop (JVM).

Kotlin Multiplatform

This project also acted as an initial platform I used when starting to explore Kotlin Multiplatform capabilities. I also wrote a number of posts about some of my experiences using KMP in the project.

• SwiftUI meets Kotlin Multiplatform!
• Introduction to Multiplatform Persistence with SQLDelight
• Using Google Maps in a Jetpack Compose app
• Using Google Maps in a Jetpack Compose app - Part 2!
• Scanning bus stop codes with ML Kit and Vision in the GalwayBus Compose Multiplatform app

Code organisation

• /iosApp contains an iOS application. Even if you’re sharing your UI with Compose Multiplatform, you need this entry point for your iOS app. This is also where you should add SwiftUI code for your project.

• /shared is for code that will be shared across your Compose Multiplatform applications. It contains several subfolders:

  • commonMain is for code that’s common for all targets.
  • Other folders are for Kotlin code that will be compiled for only the platform indicated in the folder name. For example, if you want to use Apple’s CoreCrypto for the iOS part of your Kotlin app, the iosMain folder would be the right place for such calls. Similarly, if you want to edit the Desktop (JVM) specific part, the jvmMain folder is the appropriate location.

Running the apps

Use the run configurations provided by the run widget in your IDE's toolbar. You can also use these commands and options:

• Android app: ./gradlew :androidApp:assembleDebug
• Desktop app:
  • Hot reload: ./gradlew :desktopApp:hotRun --auto
  • Standard run: ./gradlew :desktopApp:run
• iOS app: open the /iosApp directory in Xcode and run it from there.

Running tests

Use the run button in your IDE's editor gutter, or run tests using Gradle tasks:

• Android tests: ./gradlew :shared:testAndroidHostTest
• Desktop tests: ./gradlew :shared:jvmTest
• iOS tests: ./gradlew :shared:iosSimulatorArm64Test
• UI tests: a Maestro flow shared by the Android and iOS apps, run by CI on an emulator and a simulator (e.g. maestro test -e APP_ID=dev.johnoreilly.galwaybus maestro/GalwayBus.flow)

Full set of Kotlin Multiplatform / Compose / SwiftUI samples

• PeopleInSpace (https://github.com/joreilly/PeopleInSpace)
• GalwayBus (https://github.com/joreilly/GalwayBus)
• Confetti (https://github.com/joreilly/Confetti)
• BikeShare (https://github.com/joreilly/BikeShare)
• FantasyPremierLeague (https://github.com/joreilly/FantasyPremierLeague)
• ClimateTraceKMP (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)
• FirebaseAILogicKMPSample (https://github.com/joreilly/FirebaseAILogicKMPSample)
• OnDeviceAI (https://github.com/joreilly/OnDeviceAI)