This is a Kotlin Multiplatform project targeting Android, iOS, Server.

Environment Configuration

This project uses a simplified environment configuration system.

Quick start:

# Generate EnvConfig from .env files
./gradlew generateEnvConfig

File structure:

• .env - Base configuration for all platforms
• .env.android - Android-specific overrides (optional)
• .env.ios - iOS-specific overrides (optional)
• .env.js - Web-specific overrides (optional)
• .env.jvm - Server-specific overrides (optional)

Project Structure

• /composeApp 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.

• /iosApp contains iOS applications. 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.

• /server is for the Ktor server application.

• /shared is for the code that will be shared between all targets in the project. The most important subfolder is commonMain. If preferred, you can add code to the platform-specific folders here too.

Build and Run Android Application

To build and run the development version of the Android app, use the run configuration from the run widget in your IDE's toolbar or build it directly from the terminal:

• on macOS/Linux

  ./gradlew :composeApp:assembleDebug

• on Windows

  .\gradlew.bat :composeApp:assembleDebug

Android Emulator Setup:
The Android app needs to access the backend server running on your host machine. Run this command after starting the emulator:

./setup-android-emulator.sh

Or manually:

adb reverse tcp:8080 tcp:8080

This maps the emulator's localhost:8080 to your host's localhost:8080.

Build and Run Server

To build and run the development version of the server, use the run configuration from the run widget in your IDE’s toolbar or run it directly from the terminal:

• on macOS/Linux

  ./gradlew :server:run

• on Windows

  .\gradlew.bat :server:run

Build and Run iOS Application

To build and run the development version of the iOS app, use the run configuration from the run widget in your IDE’s toolbar or open the /iosApp directory in Xcode and run it from there.

---

Learn more about Kotlin Multiplatform…