Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/orbit-mvi/orbit-mvi
A simple MVI framework for Kotlin Multiplatform and Android
https://github.com/orbit-mvi/orbit-mvi
hacktoberfest mvi mvi-android mvi-coroutines-flow mvi-coroutines-flow-kotlin
Last synced: 5 days ago
JSON representation
A simple MVI framework for Kotlin Multiplatform and Android
- Host: GitHub
- URL: https://github.com/orbit-mvi/orbit-mvi
- Owner: orbit-mvi
- License: apache-2.0
- Created: 2020-12-22T11:01:18.000Z (almost 4 years ago)
- Default Branch: main
- Last Pushed: 2024-05-22T10:29:09.000Z (6 months ago)
- Last Synced: 2024-05-22T10:41:22.311Z (6 months ago)
- Topics: hacktoberfest, mvi, mvi-android, mvi-coroutines-flow, mvi-coroutines-flow-kotlin
- Language: Kotlin
- Homepage: https://orbit-mvi.org
- Size: 2.59 MB
- Stars: 844
- Watchers: 9
- Forks: 53
- Open Issues: 30
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Contributing: CONTRIBUTING.md
- Funding: .github/FUNDING.yml
- License: LICENSE.md
Awesome Lists containing this project
- awesome-kotlin-multiplatform - Orbit MVI - MVI framework for Kotlin Multiplatform. (Libraries / Architecture)
- awesome-list - orbit-mvi/orbit-mvi - A simple MVI framework for Kotlin Multiplatform and Android (Kotlin)
- kmp-awesome - Orbit MVI - MVI framework (Libraries / 🏗 Architecture)
README
# Orbit Multiplatform
[](https://github.com/orbit-mvi/orbit-mvi/actions)
[](https://codecov.io/gh/orbit-mvi/orbit-mvi)
[](https://search.maven.org/artifact/org.orbit-mvi/orbit-core)
[](LICENSE.md)
## Get in touch
[](https://kotlinlang.slack.com/messages/CPM6UMD2P)
[](https://twitter.com/orbit_mvi)
## What is Orbit
Orbit is a Redux/MVI-like library - but without the baggage. It's so simple we
think of it as MVVM+.
- Simple, type-safe, coroutine-style, extensible API
- Multiplatform, targetting Android and iOS (iOS support is in alpha and being
actively worked on)
- Full support for Kotlin Coroutines (it's built on top of them after all)
- Lifecycle-safe collection of infinite flows
- ViewModel support, along with SavedState
- Optional, simple unit test library
- Built-in espresso idling resource support
- Compatible with [RxJava](https://orbit-mvi.org/Core/rxjava), [LiveData](https://orbit-mvi.org/Core/livedata.md)
etc. through coroutine wrappers
- And more...
## Documentation
- [Getting Started](https://orbit-mvi.org)
- [Core](https://orbit-mvi.org/Core/overview)
- [Android ViewModel](https://orbit-mvi.org/Android-ViewModel/overview)
- [Compose](https://orbit-mvi.org/Compose/overview)
- [Test](https://orbit-mvi.org/Test/overview)
- [Dokka source code documentation](https://orbit-mvi.org/dokka/)
- [Resources](https://orbit-mvi.org/resources)
### Articles & Talks
- [How to write your own MVI library and why you shouldn't](https://www.youtube.com/watch?v=E6obYmkkdko)
- [Top Android MVI libraries in 2021](https://appmattus.medium.com/top-android-mvi-libraries-in-2021-de1afe890f27)
## Getting started
[](https://search.maven.org/artifact/org.orbit-mvi/orbit-viewmodel)
```kotlin
implementation("org.orbit-mvi:orbit-core:")
// or, if on Android:
implementation("org.orbit-mvi:orbit-viewmodel:")
// If using Jetpack Compose include
implementation("org.orbit-mvi:orbit-compose:")
// Tests
testImplementation("org.orbit-mvi:orbit-test:")
```
### Define the contract
``` kotlin
data class CalculatorState(
val total: Int = 0
)
sealed class CalculatorSideEffect {
data class Toast(val text: String) : CalculatorSideEffect()
}
```
### Create the ViewModel
1. Implement the
[ContainerHost](orbit-core/src/commonMain/kotlin/org/orbitmvi/orbit/ContainerHost.kt)
interface
1. Override the `container` field and use the `ViewModel.container` factory
function to build an Orbit
[Container](orbit-core/src/commonMain/kotlin/org/orbitmvi/orbit/Container.kt)
in your
[ContainerHost](orbit-core/src/commonMain/kotlin/org/orbitmvi/orbit/ContainerHost.kt)
``` kotlin
class CalculatorViewModel: ContainerHost, ViewModel() {
// Include `orbit-viewmodel` for the factory function
override val container = container(CalculatorState())
fun add(number: Int) = intent {
postSideEffect(CalculatorSideEffect.Toast("Adding $number to ${state.total}!"))
reduce {
state.copy(total = state.total + number)
}
}
}
```
We have used an Android `ViewModel` as the most common example, but there is no
requirement to do so.
### Connect to the ViewModel in your Activity or Fragment
``` kotlin
class CalculatorActivity: AppCompatActivity() {
// Example of injection using koin, your DI system might differ
private val viewModel by viewModel()
override fun onCreate(savedState: Bundle?) {
...
addButton.setOnClickListener { viewModel.add(1234) }
viewModel.observe(state = ::render, sideEffect = ::handleSideEffect)
}
private fun render(state: CalculatorState) {
...
}
private fun handleSideEffect(sideEffect: CalculatorSideEffect) {
when (sideEffect) {
is CalculatorSideEffect.Toast -> toast(sideEffect.text)
}
}
}
```
With Jetpack Compose wire up the ViewModel as follows:
```kotlin
@Composable
fun CalculatorScreen(viewModel: CalculatorViewModel) {
val state = viewModel.collectAsState().value
viewModel.collectSideEffect { handleSideEffect(it) }
// render UI using data from 'state'
...
}
private fun handleSideEffect(sideEffect: CalculatorSideEffect) {
when (sideEffect) {
is CalculatorSideEffect.Toast -> toast(sideEffect.text)
}
}
```
## Contributing
Please read [contributing](CONTRIBUTING.md)
for details on our code of conduct, and the process for submitting pull
requests to us.
## Versioning
We use [SemVer](http://semver.org/) for versioning. For the versions
available, see the [tags on this repository](https://github.com/orbit-mvi/orbit-mvi/tags).
## License
[](LICENSE.md)
This project is licensed under the Apache License, Version 2.0 - see the
[license](LICENSE.md) file for details