Skip to main content

Troubleshooting

Script Not Loading​

Problem: The engine script doesn't appear in the DOM.

Solutions:

  • Check that you're using 'use client'; in your component file
  • Verify the orchestratorKey is correct
  • Check browser console for errors

Anti-Flicker Not Working​

Problem: Page stays hidden or flickers still occur.

Solutions:

  • Verify antiFlickerEnabled={true} is set
  • Check that window.rmfk() is being called by the engine (inspect console)
  • Increase antiFlickerTimeoutMs if the engine takes longer to load
  • Disable anti-flicker in development: antiFlickerEnabled={false}

Multiple Script Tags​

Problem: Multiple script tags are being injected.

Solutions:

  • Ensure MVTOrchestrator is only rendered once at the root
  • Check that you're not using multiple instances with different keys
  • Verify the component isn't being remounted unnecessarily

TypeScript Errors​

Problem: TypeScript can't find types.

Solutions:

  • Ensure you have @types/react and @types/react-dom installed
  • Check that your tsconfig.json includes the package in types
  • Restart your TypeScript server in your IDE

SSR Errors​

Problem: Errors about window or document being undefined.

Solutions:

  • Ensure the component file has 'use client'; at the top
  • Don't use MVTOrchestrator in server components
  • All DOM access is already wrapped in useEffect, so this shouldn't happen