Rive iOS
An iOS/macOS runtime library for Rive that supports both UIKit, AppKit, and SwiftUI.
The library is distributed both through Swift Package Manager and Cocoapods.
Table of contents
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.
:house_with_garden: Homepage
:blue_book: Rive docs
🛠 Rive Community
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 an animated onboarding screen as a Rive file and add it to my iOS app 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 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.
Getting started
To get started with Rive Apple runtime, check out the following resources:
For more information, see the Runtime sections of the Rive help documentation:
Supported platforms
Supported platforms include iOS, macOS, tvOS, and visionOS. For the minimum supported versions, see Package.swift.
Examples
Check out the Example-iOS/ folder for code examples on how to use the Rive Apple runtime.
Open RiveRuntime.xcworkspace in Xcode and ensure the selected scheme is set to Preview (iOS) or Preview (macOS), based on what platform you want to preview. These schemes make use of the Swift Package Manager package of the Rive Apple runtime, and are the schemes you should use to preview the Rive examples.
Note: The other targets are for local development and require additional configuration and set-up. See Customizing the build schemes for a project for instructions to switch schemes, and CONTRIBUTING.md for more information. You should not use these schemes unless you are making changes to the underlying C++ runtime.
The example showcases a number of ways to use the high-level RiveViewModel API through UIKit and SwiftUI examples, including:
- Setting a Rive file via a URL or asset in the bundle
- Setting layout and loop mode options
- Displaying single or multiple animations / artboards on one component
- Setting up and maniuplating a state machine via inputs
- ...and more!
Awesome Rive
For even more examples and resources on using Rive at runtime or in other tools, checkout the awesome-rive repo.
Migration guides
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!
Migration Guides
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.
