rive-unity

Rive Unity

The Unity runtime for Rive. It uses the Rive Renderer and stays up to date with the latest Rive C++ runtime. Install it from the Unity Asset Store or from this repo.

Unity version support

The package supports Unity LTS versions from 2021 upwards (including Unity 6).

Rendering support

WebGL

Metal on Mac

Metal on iOS

D3D11 on Windows

D3D12 on Windows

OpenGL on Windows

OpenGL on Android

Vulkan on Windows

Vulkan on Android

Vulkan on Ubuntu 24.04+ (x86_64)

Planned support for:

Consoles

Feature support

See Feature Support for which Rive features each runtime supports, including Unity. The Unity docs have pages for Data Binding, State Machines, Listeners, Layouts, Loading Assets, Audio, Procedural Rendering, Runtime Asset Swapping, and, for older files, Inputs, Text, and Rive Events.

Table of contents

⭐️ Rive Overview

🤖 Build with your agent

🚀 Getting Started

👨‍💻 Contributing

❓ Issues

Rive overview

Rive is an agent-native 2D and 3D engine for games, apps, and interactive UI. Use it as your whole engine, or add it to the products you already have. Build with your coding agent through the Rive CLI, or draw, rig, and animate by hand with the professional design and animation tools in the Rive Editor. Both work on the same files. Open-source runtimes, no royalties or runtime fees. Rive files (.riv) play natively on web, mobile, desktop, game engines, consoles, smart TVs, and cars.

🏡 Homepage

📘 Rive docs · Rive Unity docs

🛠 Learn Rive

Build with your agent

Paste this into Claude Code, Codex, Cursor, or any agent that runs commands on your computer:

Install the Rive CLI from rive.app/cli. Build a game menu and HUD as a Rive file and add them to my Unity project with the Rive runtime.

Your agent installs the Rive CLI, writes the scene, and opens a preview window that rebuilds every time it saves. Keep giving it notes, or open the same file in the Rive Editor and shape it by hand. Trying it needs no account. Writing the .riv that ships in your game needs a free Rive account. Free exports play a short Rive splash screen; paid plans export without it. See Getting started with the Rive CLI.

Getting started

See Getting Started in the Rive Unity docs. To try Rive in Unity quickly, run one of the example projects.

Install the package from the Unity Asset Store (stable releases), or from GitHub to also get canary tags with Early Access features.

From GitHub, open Window -> Package Manager, choose Add package from git URL..., and paste this URL (replace 0.0.0 with the latest release):

https://github.com/rive-app/rive-unity.git?path=package#v0.0.0

Or add it to your project's Packages/manifest.json:

{
  "dependencies": {
    "app.rive.rive-unity": "https://github.com/rive-app/rive-unity.git?path=package#v0.0.0"
  }
}

Unity can crash when it upgrades the package while the Editor is running. If that happens, close Unity, update the version in Packages/manifest.json, then reopen the project.

Once you have a .riv file, drag it into the Unity Project window. Unity imports it as a Rive Asset you can reference from components and scripts.

Awesome Rive

For even more examples and resources on using Rive at runtime or in other tools, checkout the awesome-rive repo.

Contributing

We love contributions! Check out our contributing docs to get more details into how to run this project, the examples, and more all locally.

Issues

Have an issue with using the runtime, or want to suggest a feature/API to help make your development life better? Log an issue in our issues tab! You can also browse older issues and discussion threads there to see solutions that may have worked for common problems.

For crashes, attach the Editor.log from right after the crash. The Unity docs say where to find it.