KToast is a lightweight toast/notice library built with Kotlin Multiplatform and Compose Multiplatform. It provides a simple, unified API to show toasts across Android, iOS, Desktop (JVM), and Web/Wasm with sensible defaults and smooth transitions.

Android	Desktop	Web	iOS

• Cross-platform: Android, iOS, Desktop (JVM), Web/Wasm
• Simple API: one ToastState you can pass around
• Composable host: place it anywhere in your layout
• Transitions: slide/fade presets via ToastDefaults
• Works with your theme: drop into any Material setup

• Language: Kotlin (Multiplatform)
• UI: JetBrains Compose Multiplatform
• Targets: Android, iOS (framework), Desktop (JVM), Wasm/JS (browser)
• Build System: Gradle 8.13 (Wrapper)
• Android Gradle Plugin with Compose; Kotlin 2.0.20; Compose MPP 1.7.0
• Publishing: Maven Central via Gradle (maven-publish + Vanniktech plugin) and GitHub Actions

• JDK 17 installed (library targets JVM 17; Android module compiles with Java 11 toolchain but JDK 17 is safe across the board)
• Android Studio Giraffe+ / IntelliJ IDEA 2024.2+ recommended
• Xcode 15+ for iOS build/run
• Node.js is optional; Web/Wasm is built via Gradle (Webpack is configured by Kotlin plugin)
• Operating systems: macOS for building iOS; any OS for Desktop/Android/Web

Add KToast to your multiplatform project from commonMain.

kotlin {
    sourceSets {
        commonMain {
            dependencies {
                implementation("com.tarifchakder:ktoast:<latest>")
            }
        }
    }
}

[versions]
toast = "1.0.5" # TODO: replace with the latest from Maven Central

[libraries]
k-toast = { module = "com.tarifchakder:ktoast", version.ref = "toast" }

// Create toast state
val toast = ToastState()

MaterialTheme {
    Box {
        ToastHost(
            modifier = Modifier.fillMaxSize().padding(20.dp),
            alignment = Alignment.BottomCenter,
            hostState = toast,
            transitionSpec = { ToastDefaults.SLIDE }
        )
    }
}

// Call it anywhere
toast.showToast("Hi this is a common toast")

This repo includes a sample app to try the library on all targets.

• Desktop (JVM):
  • ./gradlew :composeApp:run
• Android:
  • Build: ./gradlew :composeApp:assembleDebug
  • Install on device/emulator (if connected): ./gradlew :composeApp:installDebug
• iOS:
  • Open iosApp/iosApp.xcodeproj in Xcode and run the scheme iosApp on a simulator or device
  • The shared KMP code is in composeApp; iOS UI host is in iosApp
• Web/Wasm (development server):
  • ./gradlew :composeApp:wasmJsBrowserDevelopmentRun
• Web/Wasm (production bundle):
  • ./gradlew :composeApp:wasmJsBrowserDistribution

Notes:

• For iOS build from Gradle, additional setup may be required; Xcode is the recommended runner.

• Build all: ./gradlew build
• Check/verify: ./gradlew check
• Run Desktop sample: ./gradlew :composeApp:run
• Android build (sample): ./gradlew :composeApp:assembleDebug
• Wasm dev server: ./gradlew :composeApp:wasmJsBrowserDevelopmentRun
• Publish library to Maven Central (CI uses this): ./gradlew publishAllPublicationsToMavenCentralRepository
• Generate docs (Dokka): ./gradlew :kmp-toast:dokkaHtml

• kmp-toast/ — the reusable KMP library published to Maven Central
  • src/commonMain/... — core API (ToastState, ToastHost, ToastDefaults, etc.)
  • src/androidMain/... — Android manifest and any Android specifics
  • src/wasmJsMain/resources — demo html/css for wasm previews
• composeApp/ — sample app using the library
  • src/commonMain/... — cross-platform UI
  • src/androidMain/... — Android app
  • src/desktopMain/... — Desktop entry point (main class: com.tarifchakder.sample.MainKt)
  • src/iosMain/... — iOS bridge (MainViewController)
  • src/wasmJsMain/... — Web/Wasm entry (with index.html/styles.css)
• iosApp/ — Xcode project wrapping the shared module for iOS UI host
• gradle/libs.versions.toml — centralized versions and plugins
• version.properties — library version used for publishing

• Currently there are no unit tests in the repository. TODO: add tests for core toast behavior (state changes, duration handling, transitions).

Issues and PRs are welcome! To propose a change:

• Fork the repository
• Create a feature branch: git checkout -b feature/my-new-feature (target branch: develop)
• Commit and open a Pull Request

This project is distributed under the MIT License. See LICENSE for details.