compose-multiplatform-patterns

name	compose-multiplatform-patterns
description	Compose Multiplatform and Jetpack Compose patterns for KMP — state management, navigation, theming, performance, and platform-specific UI. USE WHEN building shared Compose UI across Android/iOS/Desktop/Web, managing Compose state, or optimizing recomposition.
cluster	jvm
version	1.0.0

Compose Multiplatform Patterns

Patterns for building shared UI across Android, iOS, Desktop, and Web using Compose Multiplatform and Jetpack Compose. Covers state management, navigation, theming, and performance.

When to Activate

• Building Compose UI (Jetpack Compose or Compose Multiplatform)
• Managing UI state with ViewModels and Compose state
• Implementing navigation in KMP or Android projects
• Designing reusable composables and design systems
• Optimizing recomposition and rendering performance

State Management

ViewModel + Single State Object

Use a single data class for screen state. Expose it as StateFlow and collect in Compose:

data class ItemListState(
    val items: List<Item> = emptyList(),
    val isLoading: Boolean = false,
     error: String? = ,
     searchQuery: String = 
)

 (
      getItems: GetItemsUseCase
) : ViewModel() {
      _state = MutableStateFlow(ItemListState())
     state: StateFlow<ItemListState> = _state.asStateFlow()

     {
        _state.update { it.copy(searchQuery = query) }
        loadItems(query)
    }

      {
        viewModelScope.launch {
            _state.update { it.copy(isLoading = ) }
            getItems(query).fold(
                onSuccess = { items -> _state.update { it.copy(items = items, isLoading = ) } },
                onFailure = { e -> _state.update { it.copy(error = e.message, isLoading = ) } }
            )
        }
    }
}