mvi-architecture

MVI Architecture

Unidirectional data flow architecture for Android and Compose Multiplatform.

Intent → ViewModel → State → UI
   ↑                        │
   └────────────────────────┘

Everything below compiles in commonMain: ViewModel/viewModelScope, collectAsStateWithLifecycle, and repeatOnLifecycle all have commonMain declarations. Mind the group id — a Compose Multiplatform module consumes the JetBrains-published build, org.jetbrains.androidx.lifecycle:lifecycle-viewmodel / :lifecycle-runtime-compose (2.11.0); an Android-only module consumes androidx.lifecycle:*. AndroidX's own artifacts are multiplatform too, but lifecycle-runtime-compose only started publishing Native/Wasm klibs at 2.9.3, while lifecycle-viewmodel and lifecycle-runtime have shipped them since 2.8.0.

DI wiring: kmp-di / android-di-koin. Result mapping: error-handling-result. Test tooling: mobile-testing.

State

One data class per screen, all fields with defaults so the initial value is HomeState().

@Immutable
data class HomeState(
    val isLoading: Boolean = false,
    val items: ImmutableList<Item> = persistentListOf(),
    val error: ErrorState? = null,
    val searchQuery: String = ""
) {
    sealed interface ErrorState {
        data class Network(val message: String) : ErrorState
        data object Unauthorized : ErrorState
    }
}

@Immutable is an unchecked promise: the Compose compiler trusts it and skips recomposition when the instance compares equal. A plain List<Item> satisfies that only if nobody mutates the backing list — an ArrayList handed over from a repository breaks it silently. Use ImmutableList/persistentListOf() from org.jetbrains.kotlinx:kotlinx-collections-immutable, or drop the annotation.

Intent

sealed interface HomeIntent {
    data object LoadItems : HomeIntent
    data object Refresh : HomeIntent
    data class Search(val query: String) : HomeIntent
    data class ItemClicked(val id: String) : HomeIntent
    data object ClearError : HomeIntent
}