Skip to content
Limited timeStarter is now $9 a month instead of $20.See plans
charmotion

Rive Tutorial for Beginners: From First Shape to a State Machine

By the Charmotion team · Updated · How we write guides

Cover illustration for the guide: Rive Tutorial for Beginners: From First Shape to a State Machine, with Charmotion demo characters

To start with Rive, open the editor in your browser or the desktop app, draw or import artwork in Design mode, then press Tab for Animate mode. Create a timeline, set keys at two points in time, and switch it to Loop. Add a state machine to choose between timelines, then export a .riv from Publish.

Key takeaways

  • The Rive editor runs in the browser at editor.rive.app or as a desktop app for macOS and Windows.
  • Design mode changes the artwork; Animate mode (press Tab) holds timelines, keys and state machines.
  • Editing an object while a timeline is selected creates keys, the most common beginner surprise.
  • New timelines are One-Shot by default; set them to Loop or Ping-Pong for repeating motion.
  • Every plan can export a .riv; on the Free plan the exported file plays a Rive splash screen.

How do I start using Rive?

Sign up for a free Rive account, then open the editor in your browser at editor.rive.app or download the desktop app for macOS or Windows. Rive says both versions have the same core features.

When you create a file, Rive asks for an artboard size: pick a preset or type a width and height. An artboard is your canvas. It holds the artwork, its timelines and its state machines, and one file can hold several artboards.

The Free plan is enough to learn everything in this tutorial. Two limits matter later: a .riv exported on Free plays a Rive splash screen, and rendering MP4 or GIF needs a paid plan. As of November 2026 the pricing page lists Cadet at $9 per seat per month. For what Rive is and how its runtimes are licensed, see what is Rive.

What are the parts of the Rive editor?

Rive's interface overview names these panels:

PanelWhereWhat you do there
ToolbarTopPick tools (select, shapes, pen, artboard, bones), switch modes, Publish
SidebarLeftHierarchy, Assets, Data (view models), Animations, and the AI Agent
InspectorRightProperties of whatever is selected, including key buttons in Animate mode
Viewport (Stage)CenterYour artboards
TimelineBottom, Animate modeKeys, playback, loop type
State Machine graphReplaces the timelineStates and transitions
Debug PanelBottomLogs, problems in the file, AI Agent changes

Shortcuts worth learning on day one: Tab switches Design and Animate mode, Space plays the selected timeline, A is the Artboard tool, B the Bone tool, V the Select tool, and Cmd/Ctrl + 4 opens the Animations list.

How do I draw or import a character in Design mode?

Design mode is for creating, importing and rigging. Draw with the shape tools and the Pen tool, or drag files onto the stage: SVGs become editable vector paths, layered Photoshop files keep their layers, and PNG or JPEG images come in as raster images.

  • Group parts that move together (a head with its eyes), and set each group's origin where it should rotate, such as the neck.
  • Bones (B): click to place a chain; each new bone is a child of the last. Parent a shape to a bone, or bind path vertices to bones so the shape bends.
  • Meshes make raster art bend: select an image, press Enter or open Deform in the Inspector, click + and choose Mesh.

For a first project, a few separate shapes are enough: a body, a head and two eyes. If you already have a finished character as a flat image, PNG to Rive and SVG to Rive cover how to split it into parts.

How do I make my first animation in Rive?

Build a 1-second breathing idle loop:

  1. Press Tab to enter Animate mode and select the artboard.
  2. Click + next to the timeline tabs and choose Timeline. Rename it idle.
  3. Click the time display at the top of the timeline and set Duration to 1 second. Snap Keys is the frame rate keys snap to; the default is 60.
  4. With the playhead at 0, select the body and click the key button next to Scale in the Inspector. A filled key button means there is a key at the playhead.
  5. Move the playhead to the middle and scale the body up slightly. Rive keys the change automatically.
  6. Copy the first key (Cmd/Ctrl + C), move the playhead to the end and paste (Cmd/Ctrl + V), so the loop ends where it began.
  7. Select the keys and pick an ease from the Interpolation menu (right-click the keys).
  8. Set the animation type to Loop with the buttons next to the time display, then press Space.

Repeat for a second timeline, such as happy, with a quick bounce. Ping-Pong plays to the end and back, which suits swaying.

Why does Rive keep adding keys when I edit?

Because you are in Animate mode with a timeline selected. Rive's docs warn that moving, resizing, rotating or recoloring an object while a timeline is selected can key the change automatically. The fix is a habit: press Tab back to Design mode before you change the artwork itself.

Three other things that confuse beginners:

  • Animate mode edits don't change the design. If you want the artwork to match a moment in an animation, use Apply all to design mode in the timeline options.
  • Motion looks too smooth for pixel or sprite styles. Turn on Quantize in the timeline settings to play at the timeline's frame rate.
  • Playback only covers part of the timeline. The Work Area may be on; click the Work Area button to turn it off.

How do I add a state machine?

A state machine decides which timeline plays and when it changes. Your app controls it at runtime.

  1. In the Animations list, click + and choose State Machine (every artboard already has one).
  2. Select it. The graph replaces the timeline and shows Entry, Any State and Exit.
  3. Drag idle from the Animations list onto the graph and connect Entry to it.
  4. Drag in happy. Hover near a state until a circle appears, then drag from the circle to draw a transition.
  5. Give each transition a condition. Rive recommends data binding for new files: add a Boolean such as isHappy to the view model in the Data panel, then use it as the condition.
  6. Click the play button above the graph and change the value to test it.

Listeners add interaction inside the file, such as playing happy on Pointer Enter. Older tutorials use Inputs instead of view models; they still work, but Rive marks them as the older approach. The Rive state machine guide goes deeper.

How do I export and use my Rive file?

Click Publish on the right of the toolbar and choose To .riv, or use the main menu: Export then For Runtime. Then click Export your Rive file. The .riv is the production file your app loads with an open-source runtime.

A .riv strips editor data. To keep an editable copy, export For Backup, which gives a .rev. For MP4 or GIF, see how to export Rive to MP4 or GIF.

Platform setup: React and Next.js, SwiftUI, Android, Flutter and React Native. To check what an exported file contains, drop it into the free Rive File Inspector.

Where can I learn Rive for free?

  • Rive 101, Rive's YouTube series on the fundamentals, plus a Quick Start tutorial and "Rive for Absolute Beginners", all linked from the Learn Rive page.
  • The Marketplace. Open real files in the editor and click Remix to get your own copy. Marketplace files are shared under CC BY, so credit the author if you reuse them. Rive character animation examples lists good ones.
  • The docs. The editor pages are short, current and full of GIFs.
  • The community and Discord for questions.
  • Paid courses, such as School of Motion's Rive Academy, which Rive links from its docs.

Rive's built-in AI Agent (Agent tab, Cmd/Ctrl + 5) can also answer questions about your file in Ask mode, which uses fewer credits than Build mode.

How to make your first Rive animation

  1. Create a file. Open editor.rive.app or the desktop app and create a file with an artboard size preset.
  2. Add artwork in Design mode. Draw shapes or drag in an SVG, PSD or PNG, and group parts that move together.
  3. Create a timeline. Press Tab for Animate mode, click + next to the timeline tabs and choose Timeline.
  4. Set keys. Key a property at 0, change it in the middle, paste the first key at the end, and set the timeline to Loop.
  5. Add a state machine. Drag timelines onto the state machine graph, connect them with transitions and add conditions.
  6. Export. Click Publish and choose To .riv, then load the file with a Rive runtime.

Frequently asked questions

Do I need to code to use Rive?

Not to design and animate: the editor is visual. Putting the file into a website or app takes a few lines of code with a Rive runtime, and some builders, such as Webflow and Wix Studio, add Rive without code.

What is the difference between a .riv and a .rev file?

A .riv is the runtime export your app plays; it strips editor-only data. A .rev is a backup that keeps everything and can be imported back into the editor. Keep the .rev, or the editor file itself, if anyone will need to edit the animation later.

Can I animate a PNG in Rive?

Yes. Import it, add a mesh, and move the mesh vertices or bind them to bones so the image bends. Vector artwork is easier to rig, and a character split into separate parts animates far better than a single flat image.

Is the Rive AI Agent free?

Rive says every plan includes the agent, with usage limits on Free and Cadet that refill over time, and monthly credits plus advanced models on Voyager and Enterprise (as of November 2026).

Why doesn't my animation play in my app?

The runtime may be playing a different artboard or state machine than you expect, or none at all. Name the state machine in your runtime code, and check that a transition leaves Entry. The Rive File Inspector lists the names inside a .riv.

Quick answers from this guide

Sources

Related guides