Extensions

Rive

Rive extension

Render Rive artboards, animations, and state machines.

Enable the extension

Add the extension key to ruflet.yaml:

extensions:
  - rive

Run ruflet run during development or ruflet build <target> for a release. Extension packages are compiled into the Ruflet client, so rebuild the client after changing this list.

Ruby DSL example

mascot = rive(
  src: "assets/animation.riv",
  animations: ["idle"],
  fit: "contain",
  expand: true
)
page.add(mascot)

API provided

  • Extension key: rive
  • Flet package: flet_rive
  • Kind: Animation control
  • Rive control reference — complete helpers, properties, events, and methods.

Permissions and platforms

No protected service declaration is added automatically. Platform support still follows the underlying Flet extension, so test every target you ship.

Build behavior

Ruflet resolves the extension key to flet_rive and includes that Flet package through the client extension pipeline. Application code uses the Ruby DSL shown above; do not add the package directly to your app's Flutter dependencies.