Upload your Rive file

TL;DR — Upload the .riv, switch image assets to referenced, set up your animation states, then bind data through Smart Inputs.

#Before you upload

Open your .riv file in the Rive editor and confirm:

• Every layer that should appear has a 100% opacity keyframe. Layers default to 0% — anything without a visible keyframe will stay hidden.
• Image assets you plan to swap at runtime are set to referenced, not embedded. Embedded assets are baked into the file and can't be replaced live.
• Your artboard matches your output resolution (1920×1080 for HD streams).

#Step 1 — Upload the file

1. Open the Quadraviz Controller.
2. Click Animations in the sidebar.
3. Click + New animation.
4. Drop your .riv file into the upload area or click to browse.
5. Wait for the upload to finish. A green checkmark means it's ready.

If the upload fails, the most common reasons are file size (over 50 MB) or an invalid .riv format. Export from the Rive editor again and retry.

#Step 2 — Set image assets to referenced

Referenced images are swapped live. Embedded images are stuck.

In the Rive editor:

1. Open the asset panel.
2. For each image you want to control from Quadraviz, click the asset.
3. Change Export type from Embedded to Referenced.
4. Re-export the .riv file.
5. Re-upload to Quadraviz.

#Step 3 — Set up your animation states

Quadraviz expects three states per scene:

• idle — what plays by default
• in — the entrance animation
• out — the exit animation

Build these as a state machine in Rive. Quadraviz uses them to drive scene transitions on the Live Controller.

#Step 4 — Bind your data

Once the file is uploaded, you can connect resources to elements with Smart Inputs. That's the next page.

#Next steps

• Resources overview — Learn how resources power animations
• Smart Inputs — Bind data to Rive elements