FiFi is a Kotlin Multiplatform (KMP) framework for sharing mobile app logic between iOS and Android: ViewModels, data models, caching, API clients, and optional token auth. UI and navigation stay in platform code (Compose / SwiftUI).

Current version: 0.0.45 (see CHANGELOG.md)

Peer dependency: blocked-cache (com.paoapps.blockedcache:blocked-cache) — used by ModelHelper for fetch/cache flows.

// build.gradle.kts (shared module)
implementation("com.paoapps.fifi:fifi-framework:0.0.45")
implementation("com.paoapps.blockedcache:blocked-cache:0.0.10")

1. Implement AppDefinition — environment factory, API factory, Model, Koin modules.
2. Call initKoinApp(appDefinition) from Android/iOS entry points (Android: com.paoapps.fifi.koin.initKoinApp(context, …)).
3. Create ViewModels extending AbstractViewModel<Output, Event, Action>.
4. Bind platform UI to output, action, and emitEvent().

See docs/getting-started.md for a full checklist. The sample app demonstrates a non-auth setup.

• Output — UI state (Flow / FlowAdapter)
• Event — user input via emitEvent()
• Action — one-shot navigation or side effects

Helpers: viewModelOutput(), createRefreshableFetchFlow(), ActionHandler.

Models fetch and cache data via ModelHelper and blocked-cache. ViewModels request data; Models decide cache vs network.

com.paoapps.fifi.loading.Loadable maps CacheResult to a UI-agnostic loading/error/data wrapper. Apps map it to their own error components.

import com.paoapps.fifi.viewmodel.testOutput
import com.paoapps.fifi.viewmodel.testActions

viewModel.testOutput { /* assert on Output */ }
viewModel.testActions { emit -> emit(MyEvent.Tap) }

Use fifi-auth: implement AuthAppDefinition, TokenDecoder, and call com.paoapps.fifi.auth.di.initKoinApp. See docs/auth-setup.md.

• ViewModels use a custom scope; call viewModel.clear() when the screen is dismissed (see docs/ios-integration.md).
• Disk persistence for DataContainer is Android-only in-framework; iOS apps provide their own storage bridge.

• Android: sample/android — Compose UI wired to shared ViewModels
• iOS: sample/iosApp — SwiftUI reference (see README in that folder)

Run Android sample: ./gradlew :sample:android:installDebug

Released to Maven Central on GitHub release. Version in gradle.properties.

See CONTRIBUTING.md.