Rive Release Notes

Push and pull

• 📥 rive pull brings the remote Rive file's changes into the cli project, writing scene markup plus one file per script, shader and asset. Files whose bytes already match are left untouched, and build inputs missing from the remote file are reported, never deleted. This is a first version: it replaces the local project with the remote file as-is, with no merging of local changes yet, and it explains that and asks for confirmation before it runs. Conflict resolution is coming soon; until then, work in one place at a time and keep the project in source control.
• 🔢 rive push no longer fails with "malformed .rev property" on a project that builds, verifies, inspects and previews clean. An authored fractional index attribute such as childOrder made its object claim one more property than it wrote, and the report came from an object hundreds of objects past the real one.
• 🔌 Script inputs survive a push. The cli now resolves a script input's data type at export. Before, it wrote none, so the editor rebuilt every such input from scratch and lost the artboard the author picked along with the data bind path on view model inputs.
• 🎞️ Duplicate elements for the same object are merged by the compiler, so the editor keeps every keyframe. Markup that spells one per property is legal and exported a .riv that animated correctly, then the editor dropped all but the first on import, silently, taking its keyframes with it.
• 🖌️ Brush, pencil, eraser and bucket strokes survive a .rev to RML to .rev round trip. A stroked shape looked right after a push and then lost its outline on the first edit that rebuilt it.
• 📐 Guide Layers are pruned from the .riv export, matching the editor. A reference pointing into a guide now fails the export instead of building a broken file.

Scripting

• 🎨 Scripts can single out individual drawables inside an artboard. artboard:draw(renderer, visitor) hands the visitor every drawable that carries custom properties, and the visitor decides whether to call drawable:draw(renderer) and under what renderer state; everything else draws as usual and clipping still applies. Read a property with drawable:number(key), :boolean(key), :color(key), or :string(key), resolving the key once in init with artboard:propertyKey("glow").
• 🏷️ Custom properties go on a drawable directly, with no group: a shape, image, text, Component, Component list or scripted drawable takes CustomPropertyNumber, CustomPropertyBoolean, CustomPropertyColor, and the rest as children. They key and bind like any other custom property, and they are what a drawing script reads.
• 🔗 Scripts reach the .riv in dependency order, so a require() resolves against a module that is already registered. A script that required another could previously be registered first and fail to find it.

Keyboard and focus

• 🎯 Any node can hold focus, not just a leaf. A FocusData on a group makes the group a Tab stop in its own right, visited before its children, so Tab goes group, first child, second child. canTraverse="false" makes it a pure container again.
• 🩹 on the artboard no longer empties the tab order. It is the documented way to host keyboard listeners, and it used to take every focusable in the file out of the order with it. canFocus and canTraverse now speak only for the node that carries them.

Build checks

• 🔇 Audio the runtime cannot decode is now a build error. An AudioAsset holding Ogg, AIFF, MP4 or M4A, Matroska or WebM, or WMA fails the build naming the file and telling you to convert it to WAV, MP3 or FLAC. The runtime decodes only those three and reported a failed decode on stderr, so the build was clean and the sound simply never played. Checked on both the .riv and .rev paths, and for embedded bytes as well as a file= reference.
• 🔍 Four new problem kinds from rive inspect and the LSP, declared in the markup definitions rather than hand-written: reference-wrong-type for an id that resolves to the wrong kind of thing, implied-reference-authored for a reference the nesting always sets, wrong-parent for an element nested where it cannot work, and duplicate-sibling for a value repeated within its scope.
• 🔢 --format=json reports 1-based lines and columns, matching the log and problems.log instead of sitting one below them. A problem on line 1 now has the line in its label.
• 🗂️ rive pointed at a built .riv or an editor .rev now names the fix instead of reporting "no rive.yaml"; a .rev gets a rive create --from-rev= suggestion.
• 💬 Suggested commands quote paths correctly, including spaces, quotes and trailing backslashes on Windows. A path with no safe quoted form prints a placeholder instead of a command that breaks when pasted.

RML

• 📝 wordBreakValue on Text: breakWord (default, the previous behavior), normal (the word overflows the box), breakAll (pack every line full).

Runtime fixes

• 🦴 Clockwise fills render correctly on bone-bound paths. The winding is measured from the deformed path instead of the design-time flag.
• 💥 Fixed a crash loading a .riv whose view model data is incomplete or refers back to itself.
• 💥 Fixed a crash loading a .riv where an object fails to import and something else already holds a reference to it.

Built-in CLI docs (rive docs)

These ship with the CLI and are what agents read to author scenes; open them with rive docs.

• 📦 Referenced and hosted assets are documented: where the bytes land in each export mode, how sidecars are named, and which of the two the player can render.
• 🔤 text.md documents familyName and styleName on TextStylePaint. The editor fills its Font and Weight dropdowns from them, so a style carrying only fontAssetId and a wght axis renders correctly and opens with both dropdowns blank.
• data.md gains a worked example of viewModelType="global", which the schema accepted and --data-dump reported but nothing showed being authored.
• 🤖 rive create scaffolds preview guidance into CLAUDE.md: rive . is the previewer, so start it once and leave it running, and don't preview with rive push or through a web runtime.
• 📚 Docs pass across roughly 30 pages, fixing what agents misread in the first week of use: pages that still called build errors silent, contradictions between pages (the Tests script shape, coroutines vs async / await, Feather on fills, performAction vs the deprecated perform), contributor-only and internal content removed, and gotchas.md, layout.md, and luau/protocols.md reordered worst-first.
• 🔗 Fixed a broken link in the scripting API reference.