Animations

All non-trivial motion in the app is powered by Rive. Rive files are vector, GPU-accelerated, and much smaller than an equivalent Lottie.

Where they live

.riv files are stored under:

assets/animations/

The app precaches them at launch, so first-frame time on the game screen stays negligible.

Replacing an animation

1. Open the existing .riv in the Rive editor — or create a fresh one with the same artboard name and state machine name used in the code.
2. Export as a runtime .riv.
3. Drop the file into assets/animations/ under the same filename.
4. Restart the app.

If you rename the artboard or the state machine, you'll need to update the call sites — grep for the old name in lib/.

Adding a new animation

1. Add the .riv under assets/animations/.
2. Add a constant for the path in lib/src/utils/assets_utils.dart.
3. Load it with the existing RiveAnimation widget in the codebase — copy from an existing call site.

If you want an animation ready for a Rive brief, our own team can build it — see the Rive services page on Visuella.