worker-kmp

4.0.0indexed

WorkManager-style background task framework offering a unified API, one-call DI wiring, Compose UI scheduler/monitor screens, optional app-plugin for auto-generated launchers and push/daemon integrations.

AndroidJSJVMNativeWasm·MobileByteLabs/worker-kmp

Stars

—

Used by

dependents

—

Health

/ 100

worker-kmp

WorkManager for Kotlin Multiplatform + Compose Multiplatform. Write workers once in commonMain. Out-of-box support for Android, iOS, Desktop, and Web. One Koin module call to wire it up.

Out-of-box platform support

No per-platform consumer init code. Same WorkManager API everywhere.

Quick start

1. Add the dependency (commonMain)

Building a Compose Multiplatform app (Android + Desktop + iOS + Web)? Use the all-in-one bundle — one dep brings in core + UI + Koin + Store5 + all 4 platform factories + launchers:

📦 Latest version: — replace LATEST in the snippets below with that string.

// gradle/libs.versions.toml
worker-kmp = "LATEST"  // ← see badge above

// commonMain build.gradle.kts
dependencies {
    implementation("io.github.mobilebytelabs:worker-compose-all:$workerVersion")
    implementation(libs.koin.compose)                  // Koin's Compose helpers
}

See cmp-worker-compose-all/README.md for the full per-platform launcher pattern (3-5 lines each).

Want zero per-platform Kotlin files? Use the worker-kmp-app Gradle plugin:

plugins {
    id("io.github.mobilebytelabs.worker-app") version "$workerVersion"
}

Then annotate two commonMain functions:

@WorkerKmpApp(title = "My App", iosBundleId = "com.example.myapp")
fun appKoinModules(factory: WorkManagerFactory) = ...

@WorkerKmpAppContent
@Composable fun AppContent() = ...

Plugin codegens every per-platform launcher (Android Application/Activity/manifest, JVM fun main(), iOS MainViewController + xcodegen project, wasmJs fun main() + index.html) at build time. Consumer source tree: zero per-platform Kotlin files.

Only need a subset (e.g. pure-Android no-Compose)? The individual worker-* artifacts remain available:

dependencies {
    api(libs.worker.kmp)
    api(libs.worker.koin)
    implementation(libs.worker.compose)  // Compose Multiplatform UI (optional)
}

2. Define a worker (commonMain)

class DataSyncWorker(
    context: WorkerContext,
    private val api: ApiClient,
) : CoroutineWorker(context) {
    override suspend fun doWork(): WorkResult {
        val endpoint = inputData.getString("endpoint") ?: return WorkResult.failure()
        return runCatching { api.sync(endpoint) }.fold(
            onSuccess = { WorkResult.success() },
            onFailure = { WorkResult.retry(it.message) },
        )
    }
}

3. Wire up Koin — one call, every platform (commonMain)

startKoin {
    modules(
        workKoinModule(
            config = WorkerConfig(logLevel = LogLevel.INFO),
            workers = workerRegistry {
                register<DataSyncWorker> { ctx -> DataSyncWorker(ctx, get()) }
            },
            factory = androidWorkManagerFactory(this@Application),
            //      = iosWorkManagerFactory()
            //      = desktopWorkManagerFactory()
            //      = webWorkManagerFactory()
        ),
        appModule,
    )
}

4. Schedule + observe (commonMain)

val workManager: WorkManager = get()
workManager.enqueue(oneTimeWorkRequest<DataSyncWorker> {
    setConstraints(Constraints { setRequiredNetworkType(NetworkType.CONNECTED) })
    setInputData(workDataOf("endpoint" to "/api/sync"))
})
workManager.getWorkInfosByTag("sync").collect { infos -> /* update UI */ }

Compose Multiplatform UI — out-of-box

@Composable
fun WorkDashboard() {
    WorkSchedulerScreen(onWorkScheduled = { /* … */ })
    WorkMonitorScreen(tag = "sync")
}

Modules

All published under io.github.mobilebytelabs on Maven Central.

Samples

Documentation

Full docs live in docs/ and mirror the GitHub Wiki:

License

Apache 2.0. © MobileByteLabs.

Related libraries

Surfaced from shared tags and platforms — no rankings paid for.

compose-shimmer★ 1.0k

valentinilkOffers shimmering animation for UI elements, integrated via a simple modifier. Includes customization options like theming and animation boundaries. Supports advanced usage scenarios and custom modifiers.Shared: wasm, compose-multiplatform

JetCo★ 375

developerchunkReady-to-use, customizable Compose UI components — charts, cards, steppers, controls — offering polished visuals, interactive behaviors, performance optimizations, and easy integration into declarative UI projects.Shared: wasm, compose-multiplatform

KtorMonitor★ 220

CosminMihuMDCMonitors network requests and responses, enhancing debugging and analysis of client-server interactions. Features include header sanitization, log retention, and content length management with platform-specific integrations.Shared: wasm, compose-multiplatform

compose-cupertino★ 171

slanosEnhances the original with updated features like SwipeBox, improved Date Picker interactions, and faster automated releases. Integrates new multiplatform features efficiently.Shared: wasm, compose-multiplatform

RikkaUi★ 137

rainxchzedBeautiful production-ready UI components and theme system, over 40 customizable primitives, optional CLI copies components into source for full ownership and unlimited customization.Shared: wasm, compose-multiplatform

latex★ 109

huarangmengHigh-performance LaTeX math parser and renderer supporting full syntax, \newcommand macros, incremental parsing, chemical-formula (\ce{}) support, and extensive style customization (colors, boxes, display modes).Shared: wasm, compose-multiplatform

Quick start

1. Add the dependency (commonMain)

Building a Compose Multiplatform app (Android + Desktop + iOS + Web)? Use the all-in-one bundle — one dep brings in core + UI + Koin + Store5 + all 4 platform factories + launchers:

📦 Latest version: — replace LATEST in the snippets below with that string.

// gradle/libs.versions.toml worker-kmp = "LATEST" // ← see badge above // commonMain build.gradle.kts dependencies { implementation("io.github.mobilebytelabs:worker-compose-all:$workerVersion") implementation(libs.koin.compose) // Koin's Compose helpers }

See cmp-worker-compose-all/README.md for the full per-platform launcher pattern (3-5 lines each).

Want zero per-platform Kotlin files? Use the worker-kmp-app Gradle plugin:

plugins { id("io.github.mobilebytelabs.worker-app") version "$workerVersion" }

Then annotate two commonMain functions:

@WorkerKmpApp(title = "My App", iosBundleId = "com.example.myapp") fun appKoinModules(factory: WorkManagerFactory) = ... @WorkerKmpAppContent @Composable fun AppContent() = ...

Only need a subset (e.g. pure-Android no-Compose)? The individual worker-* artifacts remain available:

dependencies { api(libs.worker.kmp) api(libs.worker.koin) implementation(libs.worker.compose) // Compose Multiplatform UI (optional) }

2. Define a worker (commonMain)

class DataSyncWorker( context: WorkerContext, private val api: ApiClient, ) : CoroutineWorker(context) { override suspend fun doWork(): WorkResult { val endpoint = inputData.getString("endpoint") ?: return WorkResult.failure() return runCatching { api.sync(endpoint) }.fold( onSuccess = { WorkResult.success() }, onFailure = { WorkResult.retry(it.message) }, ) } }

3. Wire up Koin — one call, every platform (commonMain)

startKoin { modules( workKoinModule( config = WorkerConfig(logLevel = LogLevel.INFO), workers = workerRegistry { register<DataSyncWorker> { ctx -> DataSyncWorker(ctx, get()) } }, factory = androidWorkManagerFactory(this@Application), // = iosWorkManagerFactory() // = desktopWorkManagerFactory() // = webWorkManagerFactory() ), appModule, ) }

4. Schedule + observe (commonMain)

val workManager: WorkManager = get() workManager.enqueue(oneTimeWorkRequest<DataSyncWorker> { setConstraints(Constraints { setRequiredNetworkType(NetworkType.CONNECTED) }) setInputData(workDataOf("endpoint" to "/api/sync")) }) workManager.getWorkInfosByTag("sync").collect { infos -> /* update UI */ }

Android (API 21+)	`androidx.work.WorkManager` + `JobScheduler`	✓
iOS (13+)	`BGTaskScheduler` (+ ContinuedProcessing on iOS 17+)	✓
Desktop (JVM 11+)	OS-scheduler daemon (Windows / macOS / Linux)	✓
Web (browsers)	Service Worker + Web Push (Chrome/Firefox/Safari 16.4+/Edge)	✓

`cmp-worker-kmp`	Core API — `WorkManager`, `CoroutineWorker`, `Constraints`, `WorkResult`
`cmp-worker-koin`	Koin DI — single `workKoinModule(...)`
`cmp-worker-compose`	Compose Multiplatform UI
`cmp-worker-test`	`TestWorkManager` + helpers
`cmp-worker-android` · `-ios` · `-desktop` · `-web`	Platform actuals (auto-wired)
`cmp-worker-store5` · `-storeflow`	Optional: Store5 bridge + offline-first patterns
`cmp-worker-desktop-daemon`	Optional: Desktop OS-scheduler daemon for true background
`cmp-worker-web-push`	Optional: Web Push universal background

`samples/cmp-worker-sample-compose-store/`	Reference Compose Multiplatform app showing all worker-kmp patterns in a single-module setup.
`samples/kmp-project-template/`	Production-shape integration of worker-kmp into openMF/kmp-project-template — clones the template, adds a `sync/` module mirroring Now in Android's architecture using `worker-compose-all` + Koin. PR-ready for upstream. See `samples/kmp-project-template/sync/README.md`.