Open-source AR & VR
for React Native and Expo.

Meet ViroReact

Unlike WebXR solutions that render into a browser canvas, ViroReact converts your React Native code into true native draw calls, giving you access to ARKit on iOS and ARCore on Android at full hardware speed, with device-specific features intact. Write once, ship natively across the full extended reality (XR) spectrum: augmented reality on phones, virtual reality on Meta Quest, and mixed reality passthrough on Quest 3 and 3S, plus visionOS and beyond.

Free and open-source (MIT)

ViroReact is licensed under the MIT License. No paywalls, no feature tiers, no runtime fees, no strings attached. The full source is on GitHub: fork it, extend it, or contribute back. A community of developers collaborates with the ReactVision team to keep things stable and moving forward.

Powered by the ReactVision Platform

Cloud Anchors and Geospatial Anchors connect to the ReactVision Platform by default. This is the same backend that powers ReactVision Studio, and it makes persistent and location-based AR much easier to set up and scale. Geospatial and Cloud Anchors require an rvApiKey and rvProjectId from a Studio account.

Design in Studio, load with one component

Build AR and VR scenes visually in ReactVision Studio, then drop them into your app with a single StudioSceneNavigator component. ViroReact loads the scene at runtime from the Platform, so you can update scenes centrally without rebuilding and shipping a new app. No scene graph to hand-write, no asset pipeline to wire up.

import { StudioSceneNavigator } from '@reactvision/react-viro';

// Design the scene visually in ReactVision Studio, then
// load it at runtime with a single component. Credentials
// live in app.json, so there's nothing to wire up here.
export default function App() {
  return <StudioSceneNavigator />;
}

What you can build

ViroReact gives you a production-grade 3D rendering engine through standard React Native components. Here is what ships out of the box, no third-party plugins, no paid add-ons.

Familiar APIs, spatial results

Declarative JSX, typed props, familiar component patterns. The example below puts plane detection, image recognition, physics, and particle effects in a single TSX file. No engine-specific scripting, just components.

import {
  ViroARScene, ViroARSceneNavigator,
  ViroAmbientLight, Viro3DObject,
  ViroARPlaneSelector, ViroARImageMarker,
  ViroARTrackingTargets, ViroParticleEmitter,
} from '@reactvision/react-viro';

ViroARTrackingTargets.createTargets({
  packaging: {
    source: require('./assets/product-box.png'),
    physicalWidth: 0.15, // metres
  },
});

const ARScene = () => (
  <ViroARScene physicsWorld={{ gravity: [0, -9.8, 0] }}>
    <ViroAmbientLight color="#ffffff" intensity={200} />
    <ViroARPlaneSelector>
      <Viro3DObject
        source={require('./assets/chair.glb')}
        type="GLB"
        animation={{ name: "spin", run: true, loop: true }}
        physicsBody={{ type: 'Dynamic', mass: 1 }}
      />
    </ViroARPlaneSelector>
    <ViroARImageMarker target="packaging">
      <ViroParticleEmitter run={true} />
    </ViroARImageMarker>
  </ViroARScene>
);

export default () => (
  <ViroARSceneNavigator initialScene={{ scene: ARScene }} />
);

How ViroReact compares

If you have a React Native team shipping a mobile app, ViroReact is a much better fit than a C# game engine, and the ReactVision Platform gives you managed Cloud Anchor and Geospatial infrastructure out of the box.

Migrating from a WebAR platform? Read our 8th Wall alternative guide.

What people have built with ViroReact

Real products shipped to iOS and Android from a single React Native codebase, no game engine required. Here is how teams are using ViroReact in production.

Nonprofit · Heritage

Pittsburgh's erased Black history, back on the streets in AR

Adrian Jones built Looking Glass, a place-based AR storytelling app, with ViroReact and Studio. No game engine, open-source tools, and full control over the data.

ViroReactStudio

Marketing & Brand AR

Location-based AR that landed Red Bull and Burger King

Toch Emuwa's team built Pikd, a gamified AR platform for brand engagement, on ViroReact, shipping to iOS and Android from one codebase to land 30+ brands.

ViroReact

Get started

Add ViroReact to an existing project, or spin up a fresh one with the Starter Kit.

Support