Common/ Shared ViewModel in Kotlin Multiplatform - A Kotlin Multiplatform library that provides shared MVVM for UI applications. Components are lifecycle-aware on Android. Supports Android Parcelable, Kotlin Parcelize, AndroidX SavedStateHandle for restoring state after process death. Easy interoperability with Swift/Objective-C and SwiftUI. Supports Compose Multiplatform Framework (Android, Desktop, Web, iOS, macOS, tvOS, watchOS).

The ViewModel class is a business logic or screen level state holder. It exposes state to the UI and encapsulates related business logic. Its principal advantage is that it caches state and persists it through configuration changes (on Android).

Liked some of my work? Buy me a coffee (or more likely a beer)

• android.
• jvm (must add kotlinx-coroutines-swing/kotlinx-coroutines-javafx to your dependencies to make sure Dispatchers.Main available).

[!NOTE] If you are targeting Desktop and:

• not using JetBrains Compose Multiplatform, you should provide the dependency org.jetbrains.kotlinx:kotlinx-coroutines-swing or org.jetbrains.kotlinx:kotlinx-coroutines-javafx.
• using JetBrains Compose Multiplatform, you should provide org.jetbrains.kotlinx:kotlinx-coroutines-swing.

Because the ViewModel.viewModelScope depends on Dispatchers.Main provided by that libraries on Desktop.

• js (IR).
• wasmJs.
• Darwin targets:
  • iosArm64, iosX64, iosSimulatorArm64.
  • watchosArm32, watchosArm64, watchosX64, watchosSimulatorArm64.
  • tvosX64, tvosSimulatorArm64, tvosArm64.
  • macosX64, macosArm64.

For more information check out the docs.

For more information check out the docs.

For more information check out the docs.

For more information check out the docs.

For more information check out the docs.

For more information check out the docs.

For more information check out https://github.com/hoc081098/solivagant library.

For more information check out the docs.

• KMM sample: shares business logic and ViewHolders, using Jetpack Compose for Android and SwiftUi for iOS.
• Compose Multiplatform Koin sample: shares ViewModels and integrates with Navigation in Compose Multiplatform. It uses Koin for DI.
• Compose Multiplatform Koject sample: shares ViewModels and integrates with Navigation in Compose Multiplatform. It uses Koject for DI.
• Compose Multiplatform KmpViewModel KMM Unsplash Sample: A KMP template of the Unsplash App using Compose multiplatform for Android, Desktop, iOS. Share everything including data, domain, presentation, and UI.
• 🍭 GithubSearchKMM: Github Repos Search KMM for Android and iOS. Kotlin Multiplatform Mobile using Jetpack Compose, SwiftUI, FlowRedux, Coroutines Flow, Dagger Hilt, Koin Dependency Injection, shared KMP ViewModel, Clean Architecture.

• [x] support SaveStateHandle (since 0.2.0).
• [x] add extensions for Flow/StateFlow, to use the ViewModel easily on ios/macOS/tvOS/watchOS platforms (since 0.3.0).
• [x] support Compose Multiplatform Framework (since 0.5.0).
• [x] support Koin integration with ViewModel and JetBrains Compose Multiplatform (since 0.6.2).

MIT License
Copyright (c) 2023-2024 Petrus Nguyễn Thái Học