Getting Started

Run Rive on your platform of choice.

This article is out of date! Find the new version here.

The Rive runtimes are open-source libraries that allow you to load and control your animations in apps, games, and websites. Dive into each of the subpages to get started!

How to use this guide

In this section you'll find runtime subpages that provide all the needed information and resources to get started on your platform of choice. See Installation and Getting Started below.

You'll also find pages dedicated to controlling your animation at runtime. For example, updating a state machine input or text run. See Animation Control and Interaction below.

Installation and Getting Started

Make sure to check out the additional documentation provided under each runtime section. These documents provide platform-specific considerations, migration guides, and advanced usage information.

Animation Control and Interaction

These sections provide details on how to interact with your Rive animations at runtime. Here, you'll find documentation and code samples for all of Rive's official runtimes.


As we publish updates to our Rive editor, we will occasionally push updated runtimes to support the new features. See feature support for the required minimum runtime version needed for specific features.

In most cases, the newest runtimes will also support previous versions of your Rive assets, so you will not need to re-export assets to update to the latest runtimes.

There are a number of ways to export your Rive files in cases where re-exporting is necessary to take advantage of the latest features. Check out our documentation on exporting for more information.

Official runtimes

Check out the runtime subpages for steps on how to get started!

All web runtimes are distributed by npm:

See Canvas vs WebGL for more on the differences between these dependencies

All React runtimes are distributed by npm:


The iOS/macOS runtime is distributed by:


C++ (Mac/Linux/Windows)



Community runtimes





Dan Nelson


François Guezengar



Handling .riv Files

When checking in .riv files with Git, consider adding a .gitattributes file and marking .riv files as binary files to prevent Git from changing line endings when these files are checked in. Otherwise, some platforms may accidentally corrupt the .riv file where there are line returns (i.e. Windows CRLF line endings vs LF line endings) and cause issues at runtime when the file is read.

*.riv binary


Our official runtimes are all open-source and licensed under the MIT License. You're free to use them for personal and commercial applications.


Since all the runtimes are open-source, we encourage you to dive in and take a look around! If you see something missing or feel you can improve upon it, then fork it!

Last updated