Troubleshooting & Support

Visual not loading

Add onLoad callback to help debug loading issues:

const { RiveComponent } = useRive({
  src: '/your-visual.riv',
  stateMachines: 'default',
  autoplay: true,
  onLoad: () => console.log('Visual loaded successfully'),
});

Unsure the stateMachine is set to 'default', that you are using a licensed product, the src path is correct, and that you are using the latest supported renderer such as @rive-app/react-webgl2.

State machine inputs not working

Ensure you're using 'default' for the state machine name. Input names are also case-sensitive and are either 'listening', 'thinking', 'speaking' or 'asleep'.

const listeningInput = useStateMachineInput(rive, 'default', 'listening');

Browser compatibility

When using the webgl2 runtime, ensure your browser supports WebGL2.

https://caniuse.com/webgl2

Getting help

Need additional support? Check out:

• Demo Repository
• Rive Documentation
• Contact us: hayden@surge.studio