RAVDocsConfiguration
RAV
Getting StartedOpening FilesUI LayoutViewModel ControlsArtboard SwitcherScript EditorConsolesExport + SnippetsConfigurationMCP IntegrationAuto UpdatesShortcutsTroubleshooting
2.4.3 current public release. This documentation describes the version available from GitHub and the normal public updater feed.

Configuration

Settings Panel

Settings panel showing runtime version picker, BG color, canvas sizing with AUTO/FIXED toggle, pixel dimensions with aspect lock, and About button

The Settings gear in the toolbar opens the configuration panel with:

  1. Runtime Ver — use the safe 2.39.2 default, or explicitly select Latest, another pinned version, or Custom semver
  2. BG Color — canvas background color picker with NO BG reset
  3. Canvas Size — AUTO (fills viewport) or FIXED (explicit pixels)
  4. Pixels — width and height inputs with aspect-ratio LOCK
  5. About — opens the About window with build metadata and credits

For the script editor, supported config keys, APPLY behavior, internal vs editor live mode, and the window.riveInst surface, see Script Editor.

Renderer Selection

Choose between Canvas and WebGL2 in the toolbar. WebGL2 is recommended for vector feathering and complex animations.

Runtime Version

RAV 2.4.3 defaults to 2.39.2. Live RAV MCP comparison proved that Web 2.40.0 / runtime-v0.1.271 can double-offset nested, data-bound images in both WebGL2 and Canvas; 2.39.2 preserves the Rive Editor-authored layout. On first 2.4.3 launch, a one-time migration changes storedlatest and 2.40.0 preferences to 2.39.2.

You can explicitly choose Latest (auto), one of the concrete versions, or Custom for manual semver input. Latest and 2.40.0 are marked with an authored-layout risk warning; selecting either after migration is treated as deliberate opt-in and remains persisted per file and embedded in exports.

Layout

Fit and alignment are surfaced directly in the main toolbar:

FitBehavior
containFit entirely within canvas, preserving aspect ratio
coverFill canvas, cropping as needed
fillStretch to fill (may distort)
fitWidthMatch canvas width, overflow height
fitHeightMatch canvas height, overflow width
scaleDownOnly shrink if larger than canvas
noneNo scaling, original size
layoutRive layout mode

Canvas Sizing

In Settings, switch between AUTO (canvas fills the viewport) andFIXED (explicit pixel width and height). When fixed, an aspect-ratio lock keeps dimensions proportional while editing. Fixed sizes carry through to exports and snippets. Overflow-safe auto margins keep a fixed canvas centered while it fits; when it exceeds the viewport, the margins collapse and the canvas scrolls from the authored top-left origin with a styled 10px track, thumb, and corner.

Export + SnippetsMCP Integration