feat!: experimental Rive runtime backend (iOS + Android) by mfazekas · Pull Request #134 · rive-app/rive-nitro-react-native

mfazekas · 2026-01-23T11:00:11Z

Adds a new native backend using Rive's experimental runtime APIs on both iOS and Android. The new backend is async-native — all ViewModel operations go through a CommandQueue, eliminating the need for blockingAsync/runBlocking wrappers on the non-deprecated API surface.

The experimental backend is now the default. Legacy backend files are moved to ios/legacy/ and android/src/legacy/ (identical to main except getEnums() stub and backend property). New implementations live in ios/new/ and android/src/new/. CI runs tests on both backends.

Release-please configured for beta prereleases (0.5.0-beta, published as @next).

Opting into the legacy backend

# iOS
USE_RIVE_LEGACY=1 pod install

# Android — add to gradle.properties
USE_RIVE_LEGACY=true

Without the flag, the experimental backend is used.

What works

ViewModel data binding (all property types: number, string, boolean, color, enum, trigger, image, list, artboard)
Property listeners (number, string, boolean, color, enum, trigger)
Nested ViewModels (viewModelAsync)
List operations (add, remove, swap, getInstanceAt)
Touch/pointer events (handled automatically by RiveUIView on iOS, custom implementation on Android)
play() / pause() (iOS: toggles isPaused; Android: fully implemented)
getEnums() for introspection
getPropertyCountAsync / getInstanceCountAsync

Known limitations

Android

defaultArtboardViewModel doesn't expose the ViewModel name — pending rive-android#443. This causes modelName/propertyCount/instanceCount to throw and viewModelAsync path validation to be skipped on those instances.
replaceViewModel is a no-op (not yet implemented)

iOS

reset() only pauses — doesn't actually reset the state machine

Both platforms

Deprecated legacy APIs (Rive Events, SMI inputs, text runs) are not available in the experimental runtime and throw when called
Image and list property listeners are no-ops (not yet available in experimental SDK)

github-actions

Remaining comments which cannot be posted as a review comment to avoid GitHub Rate Limit

ktlint

🚫 [ktlint] standard:multiline-if-else _{reported by reviewdog 🐶}
Missing { ... }

rive-nitro-react-native/android/src/experimental/java/com/margelo/nitro/rive/ExperimentalAssetLoader.kt

Line 129 in dd06b3a

data[2] == 0x54.toByte() && data[3] == 0x4F.toByte()) return AssetType.FONT

🚫 [ktlint] standard:chain-method-continuation _{reported by reviewdog 🐶}
Expected newline before '.'

rive-nitro-react-native/android/src/experimental/java/com/margelo/nitro/rive/HybridRiveFile.kt

Line 120 in dd06b3a

enums.map { enum ->

🚫 [ktlint] standard:chain-method-continuation _{reported by reviewdog 🐶}
Expected newline before '.'

rive-nitro-react-native/android/src/experimental/java/com/margelo/nitro/rive/HybridRiveFile.kt

Line 160 in dd06b3a

file.getViewModelProperties(name)

🚫 [ktlint] standard:try-catch-finally-spacing _{reported by reviewdog 🐶}
Expected a newline after '{'

rive-nitro-react-native/android/src/experimental/java/com/margelo/nitro/rive/HybridRiveFile.kt

Line 167 in dd06b3a

} catch (_: Exception) { return vmNames.first() }

🚫 [ktlint] standard:statement-wrapping _{reported by reviewdog 🐶}
Missing newline after '{'

rive-nitro-react-native/android/src/experimental/java/com/margelo/nitro/rive/HybridRiveFile.kt

Line 167 in dd06b3a

} catch (_: Exception) { return vmNames.first() }

🚫 [ktlint] standard:statement-wrapping _{reported by reviewdog 🐶}
Missing newline before '}'

rive-nitro-react-native/android/src/experimental/java/com/margelo/nitro/rive/HybridRiveFile.kt

Line 167 in dd06b3a

} catch (_: Exception) { return vmNames.first() }

🚫 [ktlint] standard:try-catch-finally-spacing _{reported by reviewdog 🐶}
Expected a newline before '}'

rive-nitro-react-native/android/src/experimental/java/com/margelo/nitro/rive/HybridRiveFile.kt

Line 167 in dd06b3a

} catch (_: Exception) { return vmNames.first() }

🚫 [ktlint] standard:try-catch-finally-spacing _{reported by reviewdog 🐶}
Expected a newline after '{'

rive-nitro-react-native/android/src/experimental/java/com/margelo/nitro/rive/HybridRiveFile.kt

Line 174 in dd06b3a

} catch (_: Exception) { continue }

🚫 [ktlint] standard:statement-wrapping _{reported by reviewdog 🐶}
Missing newline after '{'

rive-nitro-react-native/android/src/experimental/java/com/margelo/nitro/rive/HybridRiveFile.kt

Line 174 in dd06b3a

} catch (_: Exception) { continue }

🚫 [ktlint] standard:statement-wrapping _{reported by reviewdog 🐶}
Missing newline before '}'

rive-nitro-react-native/android/src/experimental/java/com/margelo/nitro/rive/HybridRiveFile.kt

Line 174 in dd06b3a

} catch (_: Exception) { continue }

🚫 [ktlint] standard:try-catch-finally-spacing _{reported by reviewdog 🐶}
Expected a newline before '}'

rive-nitro-react-native/android/src/experimental/java/com/margelo/nitro/rive/HybridRiveFile.kt

Line 174 in dd06b3a

} catch (_: Exception) { continue }

🚫 [ktlint] standard:no-unused-imports _{reported by reviewdog 🐶}
Unused import

rive-nitro-react-native/android/src/experimental/java/com/margelo/nitro/rive/HybridViewModel.kt

Line 7 in dd06b3a

import app.rive.ViewModelInstanceSource

🚫 [ktlint] standard:string-template _{reported by reviewdog 🐶}
Redundant curly braces

rive-nitro-react-native/android/src/experimental/java/com/rive/RiveReactNativeView.kt

Line 83 in dd06b3a

    
           Log.d(TAG, "onSurfaceTextureAvailable: ${w}x${h} worker=${this@RiveReactNativeView.riveWorker != null}")

🚫 [ktlint] standard:if-else-wrapping _{reported by reviewdog 🐶}
Expected a newline

rive-nitro-react-native/android/src/experimental/java/com/rive/RiveReactNativeView.kt

Line 117 in dd06b3a

val deltaTime = if (lastFrameTimeNs == 0L) Duration.ZERO

🚫 [ktlint] standard:multiline-if-else _{reported by reviewdog 🐶}
Missing { ... }

rive-nitro-react-native/android/src/experimental/java/com/rive/RiveReactNativeView.kt

Line 117 in dd06b3a

val deltaTime = if (lastFrameTimeNs == 0L) Duration.ZERO

🚫 [ktlint] standard:if-else-wrapping _{reported by reviewdog 🐶}
Expected a newline

rive-nitro-react-native/android/src/experimental/java/com/rive/RiveReactNativeView.kt

Line 118 in dd06b3a

else (frameTimeNanos - lastFrameTimeNs).nanoseconds

🚫 [ktlint] standard:multiline-if-else _{reported by reviewdog 🐶}
Missing { ... }

rive-nitro-react-native/android/src/experimental/java/com/rive/RiveReactNativeView.kt

Line 118 in dd06b3a

else (frameTimeNanos - lastFrameTimeNs).nanoseconds

🚫 [ktlint] standard:chain-method-continuation _{reported by reviewdog 🐶}
Expected newline before '.'

rive-nitro-react-native/android/src/experimental/java/com/rive/RiveReactNativeView.kt

Line 159 in dd06b3a

    
           Log.d(TAG, "configure: reload=$reload initialUpdate=$initialUpdate fit=$activeFit surfaceTexture=${surfaceTexture != null} surfaceW=${surfaceWidth} surfaceH=${surfaceHeight}")

🚫 [ktlint] standard:argument-list-wrapping _{reported by reviewdog 🐶}
Argument should be on a separate line (unless all arguments can fit a single line)

rive-nitro-react-native/android/src/experimental/java/com/rive/RiveReactNativeView.kt

Line 159 in dd06b3a

    
           Log.d(TAG, "configure: reload=$reload initialUpdate=$initialUpdate fit=$activeFit surfaceTexture=${surfaceTexture != null} surfaceW=${surfaceWidth} surfaceH=${surfaceHeight}")

🚫 [ktlint] standard:argument-list-wrapping _{reported by reviewdog 🐶}
Argument should be on a separate line (unless all arguments can fit a single line)

rive-nitro-react-native/android/src/experimental/java/com/rive/RiveReactNativeView.kt

Line 159 in dd06b3a

    
           Log.d(TAG, "configure: reload=$reload initialUpdate=$initialUpdate fit=$activeFit surfaceTexture=${surfaceTexture != null} surfaceW=${surfaceWidth} surfaceH=${surfaceHeight}")

🚫 [ktlint] standard:string-template _{reported by reviewdog 🐶}
Redundant curly braces

rive-nitro-react-native/android/src/experimental/java/com/rive/RiveReactNativeView.kt

Line 159 in dd06b3a

    
           Log.d(TAG, "configure: reload=$reload initialUpdate=$initialUpdate fit=$activeFit surfaceTexture=${surfaceTexture != null} surfaceW=${surfaceWidth} surfaceH=${surfaceHeight}")

🚫 [ktlint] standard:max-line-length _{reported by reviewdog 🐶}
Exceeded max line length (140)

rive-nitro-react-native/android/src/experimental/java/com/rive/RiveReactNativeView.kt

Line 159 in dd06b3a

    
           Log.d(TAG, "configure: reload=$reload initialUpdate=$initialUpdate fit=$activeFit surfaceTexture=${surfaceTexture != null} surfaceW=${surfaceWidth} surfaceH=${surfaceHeight}")

🚫 [ktlint] standard:string-template _{reported by reviewdog 🐶}
Redundant curly braces

rive-nitro-react-native/android/src/experimental/java/com/rive/RiveReactNativeView.kt

Line 159 in dd06b3a

    
           Log.d(TAG, "configure: reload=$reload initialUpdate=$initialUpdate fit=$activeFit surfaceTexture=${surfaceTexture != null} surfaceW=${surfaceWidth} surfaceH=${surfaceHeight}")

🚫 [ktlint] standard:argument-list-wrapping _{reported by reviewdog 🐶}
Missing newline before ")"

rive-nitro-react-native/android/src/experimental/java/com/rive/RiveReactNativeView.kt

Line 159 in dd06b3a

    
           Log.d(TAG, "configure: reload=$reload initialUpdate=$initialUpdate fit=$activeFit surfaceTexture=${surfaceTexture != null} surfaceW=${surfaceWidth} surfaceH=${surfaceHeight}")

🚫 [ktlint] standard:statement-wrapping _{reported by reviewdog 🐶}
Missing newline after '{'

rive-nitro-react-native/android/src/experimental/java/com/rive/RiveReactNativeView.kt

Line 218 in dd06b3a

val worker = riveWorker ?: run { Log.w(TAG, "touch: no worker"); return }

🚫 [ktlint] standard:statement-wrapping _{reported by reviewdog 🐶}
Missing newline after ';'

rive-nitro-react-native/android/src/experimental/java/com/rive/RiveReactNativeView.kt

Line 218 in dd06b3a

val worker = riveWorker ?: run { Log.w(TAG, "touch: no worker"); return }

🚫 [ktlint] standard:statement-wrapping _{reported by reviewdog 🐶}
Missing newline before '}'

rive-nitro-react-native/android/src/experimental/java/com/rive/RiveReactNativeView.kt

Line 218 in dd06b3a

val worker = riveWorker ?: run { Log.w(TAG, "touch: no worker"); return }

🚫 [ktlint] standard:statement-wrapping _{reported by reviewdog 🐶}
Missing newline after '{'

rive-nitro-react-native/android/src/experimental/java/com/rive/RiveReactNativeView.kt

Line 219 in dd06b3a

    
           val smHandle = stateMachineHandle ?: run { Log.w(TAG, "touch: no smHandle"); return }

🚫 [ktlint] standard:statement-wrapping _{reported by reviewdog 🐶}
Missing newline after ';'

rive-nitro-react-native/android/src/experimental/java/com/rive/RiveReactNativeView.kt

Line 219 in dd06b3a

    
           val smHandle = stateMachineHandle ?: run { Log.w(TAG, "touch: no smHandle"); return }

🚫 [ktlint] standard:statement-wrapping _{reported by reviewdog 🐶}
Missing newline before '}'

rive-nitro-react-native/android/src/experimental/java/com/rive/RiveReactNativeView.kt

Line 219 in dd06b3a

    
           val smHandle = stateMachineHandle ?: run { Log.w(TAG, "touch: no smHandle"); return }

🚫 [ktlint] standard:if-else-wrapping _{reported by reviewdog 🐶}
A single line if-statement should be kept simple. The 'THEN' may not be wrapped in a block.

rive-nitro-react-native/android/src/experimental/java/com/rive/RiveReactNativeView.kt

Line 222 in dd06b3a

    
           if (w <= 0 || h <= 0) { Log.w(TAG, "touch: invalid surface ${w}x${h}"); return }

🚫 [ktlint] standard:statement-wrapping _{reported by reviewdog 🐶}
Missing newline after '{'

rive-nitro-react-native/android/src/experimental/java/com/rive/RiveReactNativeView.kt

Line 222 in dd06b3a

    
           if (w <= 0 || h <= 0) { Log.w(TAG, "touch: invalid surface ${w}x${h}"); return }

🚫 [ktlint] standard:string-template _{reported by reviewdog 🐶}
Redundant curly braces

rive-nitro-react-native/android/src/experimental/java/com/rive/RiveReactNativeView.kt

Line 222 in dd06b3a

    
           if (w <= 0 || h <= 0) { Log.w(TAG, "touch: invalid surface ${w}x${h}"); return }

🚫 [ktlint] standard:statement-wrapping _{reported by reviewdog 🐶}
Missing newline after ';'

rive-nitro-react-native/android/src/experimental/java/com/rive/RiveReactNativeView.kt

Line 222 in dd06b3a

    
           if (w <= 0 || h <= 0) { Log.w(TAG, "touch: invalid surface ${w}x${h}"); return }

🚫 [ktlint] standard:statement-wrapping _{reported by reviewdog 🐶}
Missing newline before '}'

rive-nitro-react-native/android/src/experimental/java/com/rive/RiveReactNativeView.kt

Line 222 in dd06b3a

    
           if (w <= 0 || h <= 0) { Log.w(TAG, "touch: invalid surface ${w}x${h}"); return }

🚫 [ktlint] standard:chain-method-continuation _{reported by reviewdog 🐶}
Expected newline before '.'

rive-nitro-react-native/example/android/app/src/main/java/rive/example/ComposeTestActivity.kt

Line 56 in dd06b3a

val legacyFile = app.rive.runtime.kotlin.core.File(bytes)

🚫 [ktlint] standard:chain-method-continuation _{reported by reviewdog 🐶}
Expected newline before '.'

rive-nitro-react-native/example/android/app/src/main/java/rive/example/ComposeTestActivity.kt

Line 66 in dd06b3a

    
           Log.d("ComposeRiveTest", "[$label]   input[$j]: name=${input.name} isBoolean=${input.isBoolean} isTrigger=${input.isTrigger} isNumber=${input.isNumber}")

🚫 [ktlint] standard:argument-list-wrapping _{reported by reviewdog 🐶}
Argument should be on a separate line (unless all arguments can fit a single line)

rive-nitro-react-native/example/android/app/src/main/java/rive/example/ComposeTestActivity.kt

Line 66 in dd06b3a

    
           Log.d("ComposeRiveTest", "[$label]   input[$j]: name=${input.name} isBoolean=${input.isBoolean} isTrigger=${input.isTrigger} isNumber=${input.isNumber}")

🚫 [ktlint] standard:argument-list-wrapping _{reported by reviewdog 🐶}
Argument should be on a separate line (unless all arguments can fit a single line)

rive-nitro-react-native/example/android/app/src/main/java/rive/example/ComposeTestActivity.kt

Line 66 in dd06b3a

    
           Log.d("ComposeRiveTest", "[$label]   input[$j]: name=${input.name} isBoolean=${input.isBoolean} isTrigger=${input.isTrigger} isNumber=${input.isNumber}")

🚫 [ktlint] standard:max-line-length _{reported by reviewdog 🐶}
Exceeded max line length (140)

rive-nitro-react-native/example/android/app/src/main/java/rive/example/ComposeTestActivity.kt

Line 66 in dd06b3a

    
           Log.d("ComposeRiveTest", "[$label]   input[$j]: name=${input.name} isBoolean=${input.isBoolean} isTrigger=${input.isTrigger} isNumber=${input.isNumber}")

🚫 [ktlint] standard:argument-list-wrapping _{reported by reviewdog 🐶}
Missing newline before ")"

rive-nitro-react-native/example/android/app/src/main/java/rive/example/ComposeTestActivity.kt

Line 66 in dd06b3a

    
           Log.d("ComposeRiveTest", "[$label]   input[$j]: name=${input.name} isBoolean=${input.isBoolean} isTrigger=${input.isTrigger} isNumber=${input.isNumber}")

🚫 [ktlint] standard:function-naming _{reported by reviewdog 🐶}
Function name should start with a lowercase letter (except factory methods) and use camel case

rive-nitro-react-native/example/android/app/src/main/java/rive/example/ComposeTestActivity.kt

Line 82 in dd06b3a

fun RiveContent() {

🚫 [ktlint] standard:chain-method-continuation _{reported by reviewdog 🐶}
Expected newline before '.'

rive-nitro-react-native/example/android/app/src/main/java/rive/example/ComposeTestActivity.kt

Line 102 in dd06b3a

    
           Log.d("ComposeRiveTest", "artboard=${artboard.artboardHandle} sm=${stateMachine.stateMachineHandle} name=${artboard.name} smName=${stateMachine.name}")

🚫 [ktlint] standard:argument-list-wrapping _{reported by reviewdog 🐶}
Argument should be on a separate line (unless all arguments can fit a single line)

rive-nitro-react-native/example/android/app/src/main/java/rive/example/ComposeTestActivity.kt

Line 102 in dd06b3a

    
           Log.d("ComposeRiveTest", "artboard=${artboard.artboardHandle} sm=${stateMachine.stateMachineHandle} name=${artboard.name} smName=${stateMachine.name}")

🚫 [ktlint] standard:argument-list-wrapping _{reported by reviewdog 🐶}
Argument should be on a separate line (unless all arguments can fit a single line)

rive-nitro-react-native/example/android/app/src/main/java/rive/example/ComposeTestActivity.kt

Line 102 in dd06b3a

    
           Log.d("ComposeRiveTest", "artboard=${artboard.artboardHandle} sm=${stateMachine.stateMachineHandle} name=${artboard.name} smName=${stateMachine.name}")

🚫 [ktlint] standard:max-line-length _{reported by reviewdog 🐶}
Exceeded max line length (140)

rive-nitro-react-native/example/android/app/src/main/java/rive/example/ComposeTestActivity.kt

Line 102 in dd06b3a

    
           Log.d("ComposeRiveTest", "artboard=${artboard.artboardHandle} sm=${stateMachine.stateMachineHandle} name=${artboard.name} smName=${stateMachine.name}")

🚫 [ktlint] standard:argument-list-wrapping _{reported by reviewdog 🐶}
Missing newline before ")"

rive-nitro-react-native/example/android/app/src/main/java/rive/example/ComposeTestActivity.kt

Line 102 in dd06b3a

    
           Log.d("ComposeRiveTest", "artboard=${artboard.artboardHandle} sm=${stateMachine.stateMachineHandle} name=${artboard.name} smName=${stateMachine.name}")

github-actions

Remaining comments which cannot be posted as a review comment to avoid GitHub Rate Limit

ktlint

🚫 [ktlint] standard:if-else-wrapping _{reported by reviewdog 🐶}
A single line if-statement should be kept simple. The 'THEN' may not be wrapped in a block.

rive-nitro-react-native/android/src/experimental/java/com/rive/RiveReactNativeView.kt

Line 222 in a5855c9

    
           if (w <= 0 || h <= 0) { Log.w(TAG, "touch: invalid surface ${w}x${h}"); return }

🚫 [ktlint] standard:statement-wrapping _{reported by reviewdog 🐶}
Missing newline after '{'

rive-nitro-react-native/android/src/experimental/java/com/rive/RiveReactNativeView.kt

Line 222 in a5855c9

    
           if (w <= 0 || h <= 0) { Log.w(TAG, "touch: invalid surface ${w}x${h}"); return }

🚫 [ktlint] standard:string-template _{reported by reviewdog 🐶}
Redundant curly braces

rive-nitro-react-native/android/src/experimental/java/com/rive/RiveReactNativeView.kt

Line 222 in a5855c9

    
           if (w <= 0 || h <= 0) { Log.w(TAG, "touch: invalid surface ${w}x${h}"); return }

🚫 [ktlint] standard:statement-wrapping _{reported by reviewdog 🐶}
Missing newline after ';'

rive-nitro-react-native/android/src/experimental/java/com/rive/RiveReactNativeView.kt

Line 222 in a5855c9

    
           if (w <= 0 || h <= 0) { Log.w(TAG, "touch: invalid surface ${w}x${h}"); return }

🚫 [ktlint] standard:statement-wrapping _{reported by reviewdog 🐶}
Missing newline before '}'

rive-nitro-react-native/android/src/experimental/java/com/rive/RiveReactNativeView.kt

Line 222 in a5855c9

    
           if (w <= 0 || h <= 0) { Log.w(TAG, "touch: invalid surface ${w}x${h}"); return }

🚫 [ktlint] standard:chain-method-continuation _{reported by reviewdog 🐶}
Expected newline before '.'

rive-nitro-react-native/example/android/app/src/main/java/rive/example/ComposeTestActivity.kt

Line 56 in a5855c9

val legacyFile = app.rive.runtime.kotlin.core.File(bytes)

🚫 [ktlint] standard:chain-method-continuation _{reported by reviewdog 🐶}
Expected newline before '.'

rive-nitro-react-native/example/android/app/src/main/java/rive/example/ComposeTestActivity.kt

Line 66 in a5855c9

    
           Log.d("ComposeRiveTest", "[$label]   input[$j]: name=${input.name} isBoolean=${input.isBoolean} isTrigger=${input.isTrigger} isNumber=${input.isNumber}")

🚫 [ktlint] standard:argument-list-wrapping _{reported by reviewdog 🐶}
Argument should be on a separate line (unless all arguments can fit a single line)

rive-nitro-react-native/example/android/app/src/main/java/rive/example/ComposeTestActivity.kt

Line 66 in a5855c9

    
           Log.d("ComposeRiveTest", "[$label]   input[$j]: name=${input.name} isBoolean=${input.isBoolean} isTrigger=${input.isTrigger} isNumber=${input.isNumber}")

🚫 [ktlint] standard:argument-list-wrapping _{reported by reviewdog 🐶}
Argument should be on a separate line (unless all arguments can fit a single line)

rive-nitro-react-native/example/android/app/src/main/java/rive/example/ComposeTestActivity.kt

Line 66 in a5855c9

    
           Log.d("ComposeRiveTest", "[$label]   input[$j]: name=${input.name} isBoolean=${input.isBoolean} isTrigger=${input.isTrigger} isNumber=${input.isNumber}")

🚫 [ktlint] standard:max-line-length _{reported by reviewdog 🐶}
Exceeded max line length (140)

rive-nitro-react-native/example/android/app/src/main/java/rive/example/ComposeTestActivity.kt

Line 66 in a5855c9

    
           Log.d("ComposeRiveTest", "[$label]   input[$j]: name=${input.name} isBoolean=${input.isBoolean} isTrigger=${input.isTrigger} isNumber=${input.isNumber}")

🚫 [ktlint] standard:argument-list-wrapping _{reported by reviewdog 🐶}
Missing newline before ")"

rive-nitro-react-native/example/android/app/src/main/java/rive/example/ComposeTestActivity.kt

Line 66 in a5855c9

    
           Log.d("ComposeRiveTest", "[$label]   input[$j]: name=${input.name} isBoolean=${input.isBoolean} isTrigger=${input.isTrigger} isNumber=${input.isNumber}")

🚫 [ktlint] standard:function-naming _{reported by reviewdog 🐶}
Function name should start with a lowercase letter (except factory methods) and use camel case

rive-nitro-react-native/example/android/app/src/main/java/rive/example/ComposeTestActivity.kt

Line 82 in a5855c9

fun RiveContent() {

🚫 [ktlint] standard:chain-method-continuation _{reported by reviewdog 🐶}
Expected newline before '.'

rive-nitro-react-native/example/android/app/src/main/java/rive/example/ComposeTestActivity.kt

Line 102 in a5855c9

    
           Log.d("ComposeRiveTest", "artboard=${artboard.artboardHandle} sm=${stateMachine.stateMachineHandle} name=${artboard.name} smName=${stateMachine.name}")

🚫 [ktlint] standard:argument-list-wrapping _{reported by reviewdog 🐶}
Argument should be on a separate line (unless all arguments can fit a single line)

rive-nitro-react-native/example/android/app/src/main/java/rive/example/ComposeTestActivity.kt

Line 102 in a5855c9

    
           Log.d("ComposeRiveTest", "artboard=${artboard.artboardHandle} sm=${stateMachine.stateMachineHandle} name=${artboard.name} smName=${stateMachine.name}")

🚫 [ktlint] standard:argument-list-wrapping _{reported by reviewdog 🐶}
Argument should be on a separate line (unless all arguments can fit a single line)

rive-nitro-react-native/example/android/app/src/main/java/rive/example/ComposeTestActivity.kt

Line 102 in a5855c9

    
           Log.d("ComposeRiveTest", "artboard=${artboard.artboardHandle} sm=${stateMachine.stateMachineHandle} name=${artboard.name} smName=${stateMachine.name}")

🚫 [ktlint] standard:max-line-length _{reported by reviewdog 🐶}
Exceeded max line length (140)

rive-nitro-react-native/example/android/app/src/main/java/rive/example/ComposeTestActivity.kt

Line 102 in a5855c9

    
           Log.d("ComposeRiveTest", "artboard=${artboard.artboardHandle} sm=${stateMachine.stateMachineHandle} name=${artboard.name} smName=${stateMachine.name}")

🚫 [ktlint] standard:argument-list-wrapping _{reported by reviewdog 🐶}
Missing newline before ")"

rive-nitro-react-native/example/android/app/src/main/java/rive/example/ComposeTestActivity.kt

Line 102 in a5855c9

    
           Log.d("ComposeRiveTest", "artboard=${artboard.artboardHandle} sm=${stateMachine.stateMachineHandle} name=${artboard.name} smName=${stateMachine.name}")

…E, check WebP explicitly

…ReactNativeView

…allable methods Nitro calls hybrid methods on the JS thread, not the main thread. MainActor.assumeIsolated crashes at runtime when not on main.

…recursion

…tch boundary

…in experimental backend

…nd (#214) Port of #209 fix to the experimental backend. The legacy backend defaulted `layoutScaleFactor` to `resources.displayMetrics.density` when unset, but the experimental backend defaulted to `1f`, causing the artboard to render at pixel dimensions instead of dp.

…nings (#201) ## Summary - Adds `RiveLog` — a general-purpose logging system that surfaces native logs to JS via a configurable handler - Default handler uses `console.error/warn/log` so logs show in the RN console out of the box - On both platforms, hooks into the Rive SDK's pluggable `RiveLog.Logger` to unify C++ runtime logs (state machine, artboard, command queue diagnostics) through the JS handler - Adds `DeprecationWarning` utility that emits once-per-session warnings when deprecated blocking methods are called ## Test plan - [ ] Build exerciser on iOS + Android - [ ] Call a deprecated method (e.g. `riveFile.viewModelByName(...)`) — verify warning in RN console - [ ] Call same method again — verify no duplicate warning - [ ] `RiveLog.setHandler(() => {})` — verify all logs suppressed - [ ] `RiveLog.resetHandler()` — verify back to default console output - [ ] Verify `onError` prop on RiveView still works independently

… backend RiveUIView creates its MTKView lazily during the first layout pass. Setting rive.fit immediately after creating the view had no effect because the drawable didn't exist yet. Store the desired fit as pendingFit and apply it in layoutSubviews once the MTKView is present.

Add `RiveLog.setLogLevel(level)` to filter log output by severity. Levels: `debug`, `info`, `warn`, `error`. Default is `warn`. ## Test plan - `RiveLog.setLogLevel('error')` suppresses warn/info/debug logs - `RiveLog.setLogLevel('debug')` shows all logs

Bump RiveRuntime from 6.19.0 to 6.19.1. Remove `@_spi(RiveExperimental)` imports — no longer needed with this version.

The experimental factory already has `var backend: String { "experimental" }`. This adds the matching property to the legacy side so `RiveFileFactory.backend` works for both backends.

`Int32(value)` traps when ARGB color values exceed `Int32.max` (e.g. `0xFF0000FF` = opaque blue). Uses `Int64` + `truncatingIfNeeded` for safe conversion.

- Pass `fit:` directly in `Rive()` constructor instead of setting it post-creation. Removes the `layoutSubviews`/`pendingFit` workaround since rive-ios 6.19.1 handles this (rive-ios#443) - Warn when `updateReferencedAssets` is called on experimental backend (not supported — concurrency API can't update already-bound artboard assets) - Switch asset registration from parallel `TaskGroup` to sequential to ensure command queue ordering - Add debug logging to `ExperimentalAssetLoader` - Add explicit `type` fields to OutOfBandAssets example - Add `expo-font` plugin for `kanit_regular.ttf` in expo examples ## Test plan - QuickStart + DataBindingArtboards render correctly with `Fit.Layout` on first mount - Out-of-Band Assets example loads initial assets correctly - `updateReferencedAssets` logs a warning instead of silently failing

Copilot

Pull request overview

Copilot reviewed 88 out of 183 changed files in this pull request and generated 8 comments.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

Add addInstanceAsync, addInstanceAtAsync, removeInstanceAsync, removeInstanceAtAsync, swapAsync. Deprecate sync versions that return before knowing if the operation succeeded.

The library module already depends on the correct version via package.json runtimeVersions. The pin caused version conflicts.

… app Debug activities that import app.rive.* directly, causing the example app to need an explicit rive-android dependency. Easy to recreate when needed for native SDK debugging.

mfazekas force-pushed the feat/rive-ios-experimental branch 2 times, most recently from 95816cf to 4fe9e12 Compare January 23, 2026 11:23

mfazekas force-pushed the feat/rive-ios-experimental branch 4 times, most recently from 8485f9f to 9b4acd8 Compare February 9, 2026 10:25

mfazekas changed the title ~~feat: experimental iOS API support (getEnums via SPM)~~ feat: experimental iOS API support Feb 9, 2026

github-actions Bot reviewed Feb 16, 2026

View reviewed changes

mfazekas force-pushed the feat/rive-ios-experimental branch from dd06b3a to a5855c9 Compare February 16, 2026 10:41

github-actions Bot reviewed Feb 16, 2026

View reviewed changes

mfazekas force-pushed the feat/rive-ios-experimental branch from 8134a07 to ec12673 Compare February 17, 2026 12:11

mfazekas changed the title ~~feat: experimental iOS API support~~ WIP feat: experimental iOS / Android POC Feb 17, 2026

mfazekas force-pushed the feat/rive-ios-experimental branch 2 times, most recently from 91e2fb6 to cfb2ff6 Compare February 19, 2026 13:50

mfazekas force-pushed the feat/rive-ios-experimental branch from cfb2ff6 to 44681b5 Compare February 26, 2026 13:57

mfazekas force-pushed the feat/rive-ios-experimental branch 2 times, most recently from f1b851e to aa2fdf0 Compare March 16, 2026 09:39

mfazekas force-pushed the feat/rive-ios-experimental branch 4 times, most recently from 35c6fea to 4f1ab3f Compare March 27, 2026 15:52

mfazekas changed the base branch from main to feat/hooks-undefined-initial-value March 27, 2026 15:52

mfazekas force-pushed the feat/rive-ios-experimental branch from 4e0c53a to be6d334 Compare March 30, 2026 12:39

mfazekas force-pushed the feat/hooks-undefined-initial-value branch from 164180e to 7116ac7 Compare March 30, 2026 18:17

Base automatically changed from feat/hooks-undefined-initial-value to main March 30, 2026 18:20

mfazekas force-pushed the feat/rive-ios-experimental branch from dcdde5e to 0a3d09c Compare March 31, 2026 05:33

mfazekas changed the title ~~WIP feat: experimental iOS / Android POC~~ feat: experimental Rive runtime backend (iOS + Android) Mar 31, 2026

mfazekas marked this pull request as ready for review March 31, 2026 07:31

mfazekas changed the title ~~feat: experimental Rive runtime backend (iOS + Android)~~ feat!: experimental Rive runtime backend (iOS + Android) Mar 31, 2026

mfazekas requested a review from HayesGordon March 31, 2026 14:18

mfazekas added 10 commits April 24, 2026 13:30

fix(android): log warning when inferFromMagicBytes falls back to IMAG…

42d4540

…E, check WebP explicitly

fix(ios): add MainActor.assumeIsolated for calls into @mainactor Rive…

e6ac484

…ReactNativeView

fix(ios): port Xcode 26 ODR workaround from main into podspec

067bbea

fix(ios): add missing try to MainActor.assumeIsolated in afterUpdate

4b5e283

fix(ios): use onMainSync instead of MainActor.assumeIsolated for JS-c…

219c609

…allable methods Nitro calls hybrid methods on the JS thread, not the main thread. MainActor.assumeIsolated crashes at runtime when not on main.

fix(ios): make onMainSync provide @mainactor isolation, fix infinite …

0b2f05f

…recursion

fix(ios): use Result to propagate errors from onMainSync across dispa…

13f079d

…tch boundary

fix(android): use device density for Fit.Layout default scale factor …

652c872

…in experimental backend

mfazekas force-pushed the feat/rive-ios-experimental branch from de3b4b3 to fb86bf0 Compare April 24, 2026 11:34

mfazekas force-pushed the feat/rive-ios-experimental branch from ef919d1 to 24bf675 Compare April 27, 2026 12:51

mfazekas added 5 commits April 29, 2026 06:57

chore(ios): bump rive-ios to 6.19.1 (#233)

32f85f2

Bump RiveRuntime from 6.19.0 to 6.19.1. Remove `@_spi(RiveExperimental)` imports — no longer needed with this version.

fix(ios): add backend property to legacy HybridRiveFileFactory (#236)

018c63d

The experimental factory already has `var backend: String { "experimental" }`. This adds the matching property to the legacy side so `RiveFileFactory.backend` works for both backends.

fix(ios): prevent crash on color values with high alpha (#234)

dcfc431

`Int32(value)` traps when ARGB color values exceed `Int32.max` (e.g. `0xFF0000FF` = opaque blue). Uses `Int64` + `truncatingIfNeeded` for safe conversion.

mfazekas requested a review from Copilot April 29, 2026 13:19

Copilot started reviewing on behalf of mfazekas April 29, 2026 13:20 View session

Copilot AI reviewed Apr 29, 2026

View reviewed changes

mfazekas added 2 commits April 30, 2026 06:55

feat: add async variants for ViewModelListProperty mutation methods

8a943df

Add addInstanceAsync, addInstanceAtAsync, removeInstanceAsync, removeInstanceAtAsync, swapAsync. Deprecate sync versions that return before knowing if the operation succeeded.

fix: remove pinned rive-android version from example app

4ba5dd6

The library module already depends on the correct version via package.json runtimeVersions. The pin caused version conflicts.

mfazekas force-pushed the feat/rive-ios-experimental branch 3 times, most recently from 8dcd161 to e753682 Compare April 30, 2026 06:34

mfazekas added 2 commits April 30, 2026 08:39

chore: upgrade react-native-nitro-modules to 0.35.6

cda21e6

chore: remove ComposeTestActivity and LegacyTestActivity from example…

6af4fdd

… app Debug activities that import app.rive.* directly, causing the example app to need an explicit rive-android dependency. Easy to recreate when needed for native SDK debugging.

mfazekas force-pushed the feat/rive-ios-experimental branch from e753682 to 6af4fdd Compare April 30, 2026 06:40

chore(ios): bump rive-ios to 6.19.2

e509ad3

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

feat!: experimental Rive runtime backend (iOS + Android)#134

feat!: experimental Rive runtime backend (iOS + Android)#134
mfazekas wants to merge 100 commits intomainfrom
feat/rive-ios-experimental

mfazekas commented Jan 23, 2026 •

edited

Loading

Uh oh!

github-actions Bot left a comment

Uh oh!

github-actions Bot left a comment

Uh oh!

Copilot AI left a comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

Conversation

mfazekas commented Jan 23, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Opting into the legacy backend

What works

Known limitations

Android

iOS

Both platforms

Uh oh!

github-actions Bot left a comment

Choose a reason for hiding this comment

Uh oh!

github-actions Bot left a comment

Choose a reason for hiding this comment

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull request overview

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

mfazekas commented Jan 23, 2026 •

edited

Loading