Rive React is the React runtime for Rive.
This library is a wrapper around the JS/Wasm runtime, giving full control over the JS/Wasm runtime while providing components and hooks for React applications.
For more information, check out the following resources:
- ⭐ Rive Overview
- 🤖 Build with your agent
- 🚀 Getting Started & API docs
- 🔍 Supported Versions
- 📚 Examples
- 🏃 Migration Guides
- 👨💻 Contributing
- ❓ Issues
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
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 an interactive hero as a Rive file and add it to my React app with the Rive React 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 app 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.
Follow along with the link below for a quick start in getting Rive React integrated into your React apps.
For more information, see the Runtime sections of the Rive help documentation:
This library supports React versions ^16.8.0 through ^19.0.0.
Check out our Storybook instance that shows how to use the library in small examples, along with code snippets! This includes examples using the basic component, as well as the convenient hooks exported to take advantage of state machines.
For even more examples and resources on using Rive at runtime or in other tools, checkout the awesome-rive repo.
Using an older version of the runtime and need to learn how to upgrade to the latest version? Check out the migration guides below in our help center that help guide you through version bumps; breaking changes and all!
We love contributions! Check out our contributing docs to get more details into how to run this project, the examples, and more all locally.
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.