This is a Kotlin Multiplatform project targeting Android, iOS, Web (DOM, JS), Desktop (JVM), and Server (Spring Boot).
It is powered by Kdomskia to unify UI across platforms.
-
/composeApp contains the UI and shared code for your applications.
It includes several source sets:- commonMain → shared business logic and UI for all targets.
- domMain → code specific to Web (DOM)
- skiaMain → code specific to Skia-based platforms (Android, iOS, Desktop)
- androidMain, desktopMain, iosMain, jsMain → platform-specific code
-
/iosApp contains the iOS application entry point. Even when sharing UI with Compose Multiplatform,
you need this module for iOS integration. SwiftUI code can also be added here if required. -
/server contains the Spring Boot server application.
-
/shared contains code that is shared across all modules (backend and frontend).
The most important subfolder is commonMain. Platform-specific folders can also be used if needed.
Before running the project, make sure to configure the BASE_URL in:
composeApp/src/commonMain/kotlin/com/template/HttpClient.kt
Set it to the local IP address of the server you intend to run. For example:
private val BASE_URL = "http://192.168.0.1:8080"To build and run the development version of the server (Spring Boot), use the run configuration from the IDE toolbar
or run it directly from the terminal:
- on macOS/Linux
./gradlew :server:bootRun
- on Windows
.\gradlew.bat :server:bootRun
To build and run the development version of the Android app, use the run configuration from the IDE toolbar
or run it directly from the terminal:
- on macOS/Linux
./gradlew :composeApp:assembleDebug
- on Windows
.\gradlew.bat :composeApp:assembleDebug
To build and run the development version of the desktop app, use the run configuration from the IDE toolbar
or run it directly from the terminal:
- on macOS/Linux
./gradlew :composeApp:run
- on Windows
.\gradlew.bat :composeApp:run
To build and run the development version of the web app (JS, DOM), use the run configuration from the IDE toolbar
or run it directly from the terminal:
- on macOS/Linux
./gradlew :composeApp:jsBrowserDevelopmentRun
- on Windows
.\gradlew.bat :composeApp:jsBrowserDevelopmentRun
To build and run the development version of the iOS app, open the /iosApp directory in Xcode
and run it from there. You can also use the run configuration from the IDE toolbar.
Before starting development, rename parts of the project so they match your app’s name and identity:
settings.gradle.kts→ updaterootProject.namecomposeApp/build.gradle.kts→ updateappIdcomposeApp/src/androidMain/res/values/strings.xml→ updateapp_namecomposeApp/src/desktopMain/kotlin/com/template/Main.kt→ updatemain.Window.titlecomposeApp/src/jsMain/resources/index.html→ update<head><title>iosApp/Configuration/Config.xcconfig→ updatePRODUCT_*- Update the package name of classes under
com.templateto your own package namespace.
You can check your layout changes without building the whole project with Compose Hot Reload.
To use it, open the Main class inside the desktopMain source set and click on Run composeApp with Compose Hot Reload in your IDE (IntelliJ IDEA or Android Studio).
Simply save the file you are working on, and the running application will be updated automatically.
For more details, see the official JetBrains documentation: Hot Reload in Compose Multiplatform
Learn more at: