fifi
0.0.43indexedFacilitates extensive code sharing between iOS and Android, focusing on non-UI components like network requests, caching, and business logic, while integrating with SwiftUI and Compose.
6
Stars
—
Used by
dependents
—
Health
/ 100
Facilitates extensive code sharing between iOS and Android, focusing on non-UI components like network requests, caching, and business logic, while integrating with SwiftUI and Compose.
FiFi is a Kotlin Multiplatform Mobile (KMM) framework designed to facilitate maximum code sharing between iOS and Android, focusing on almost everything except UI and navigation code. With FiFi, you can write network requests, caching mechanisms, view models, business logic, and event handling all in shared code, allowing for a seamless development experience across platforms.
FiFi is currently in early development. The API is not stable and is subject to change. We are actively working on the framework and will be working on documentation and examples in the near future.
We encourage you to try out FiFi and provide feedback. If you have any questions, please reach out to us.
fifi-common can be shared with projects like a Ktor-based server, while fifi-framework is dedicated for mobile apps.FiFi is a great fit for apps that communicate with a server (optionally with token based authentication) and need to cache some of that data. Based on that data, view models can be created and used to drive the UI automatically.
The framework lets your create shared view models in Kotlin. These view models define in an Output data class what a view needs to display. It also provides Events that the UI can send to the view model. The view model can then react to these events and update the output accordingly. Whenever the output changes, the UI is automatically updated. Whenever the UI needs to react to an event, the view model is notified through an Action.
View Models get their data through Models. Models are responsible for determining when to fetch data from the server and when to use cached data. A view model generally only indicates what data it needs and the model will take care of the rest.
Models keep a cache of a single data structure tree in memory. This acts as the single source of truth for the app. Whenever a view model needs data, it can request it from the model. The model will then either return the cached data or fetch it from the server. The model also keeps track of the last time it fetched data from the server. If the data is older than a certain threshold, the model will automatically fetch new data from the server. Besides having the cache in memory it allows iOS and Android implementations to store the cache on disk as well.
The framework provides a way to define API's in Kotlin. These API's can be used to make network requests to a server. The framework provides a way to automatically parse the response from the server into Kotlin data classes. The framework also provides a way to automatically parse errors from the server into Kotlin data classes. This allows you to define a single API for both iOS and Android and use it in your shared code.
The framework provides a way to authenticate with a server using tokens. It provides a way to automatically refresh tokens when they expire. Authentication is optional and can be enabled by using the fifi-auth module.
Set up a Kotlin Multiplatform Mobile (KMM) project as outlined here.
In your shared module, create a dependency to the fifi-framework library.
implementation("com.paoapps.fifi:fifi-framework:0.0.36-SNAPSHOT-41")
Implement an initApp function in your shared code. This function should be called from both Android and iOS main entry points.
fun <ModelData, Environment: ModelEnvironment, UserId, AccessTokenClaims: IdentifiableClaims, RefreshTokenClaims: Claims, ServerError, Api: ClientApi<AccessTokenClaims>> initKoinShared(
serviceName: ,
sharedAppModule: ,
model: () -> <, AccessTokenClaims, Environment, UserId, Api>,
tokenDecoder: <, RefreshTokenClaims>,
authApi: (: ) -> <>,
languageProvider: ,
stringsProvider: ,
serverErrorParser: <>,
appDeclaration: = {}
)
We welcome contributions to FiFi. Please read our contributing guide for more information.
Surfaced from shared tags and platforms — no rankings paid for.