Enables seamless integration of Rive animations into Android and iOS applications through a unified API, supporting playback controls, state machine manipulation, and resource management.
KrossRive is a Kotlin Multiplatform library that makes it easy to use Rive animations in Android and iOS apps with a unified API.
Add the dependency in your build.gradle.kts:
dependencies {
implementation("io.github.farimarwat:krossrive:1.0")
}
Add the official Rive iOS SDK in your Xcode project: File>Add Package Dependencies
//pull the latest version
https://github.com/rive-app/rive-ios.git
An animation state represents a Rive file + optional artboard + state machine.
You can load it either from local resources (bytes) or from a URL.
Suppose you have a .riv file in your resources:
val riveBytes by produceState<ByteArray?>(initialValue = null) {
value = Res.readBytes("files/login.riv")
}
val animationState = riveBytes?.let {
rememberKrossRiveAnimationState(
config = KrossRiveConfig(
resource = KrossRiveResource.Url("https://cdn.rive.app/animations/juice_v7.riv"),
)
)
}
You can also load directly from the web:
val animationState = rememberKrossRiveAnimationState(
config = KrossRiveConfig(
resource = KrossRiveResource.Url("https://cdn.rive.app/animations/off_road_car_v7.riv"),
)
)
Once you have an animationState, show it using KrossRiveAnimation inside your Compose UI:
KrossRiveAnimation(
state = animationState,
modifier = Modifier
.fillMaxWidth()
.height(200.dp)
)
You can control your animation via the KrossRiveAnimationState functions:
// playback controls
animationState.play()
animationState.pause()
animationState.stop()
animationState.reset()
// state machine inputs
animationState.setBoolean("Login Machine", "isHandsUp", true)
animationState.setNumber("Login Machine", "numLook", 5f)
animationState.fire("Login Machine", "trigSuccess")
// reload with a new resource (bytes or url)
animationState.load(url = "https://cdn.rive.app/animations/new_animation.riv")
krossrive for Android, Rive SDK for iOS).KrossRiveAnimation.setNumbersetBooleanfireSurfaced from shared tags and platforms — no rankings paid for.