npm package: @reactvision/react-viro
Description: Maintained version of react-viro - New Architecture (Fabric) required
Author: ReactVision, Inc
Latest version: 2.54.0


<p align="center" style="background-colour: #CCCCCC;">
  <a href="https://www.reactvision.xyz/">
    <img src="https://avatars.githubusercontent.com/u/74572641?s=200&v=4" alt="ReactVision logo" width="120px" height="120px">
  </a>
</p>

<p align="center">
  <a href="https://www.npmjs.com/package/@reactvision/react-viro">
    <img src="https://img.shields.io/npm/v/@reactvision/react-viro" alt="npm version">
  </a>
  <a href="https://www.npmjs.com/package/@reactvision/react-viro">
    <img src="https://img.shields.io/npm/dm/@reactvision/react-viro?colour=purple" alt="downloads">
  </a>
  <a href="https://discord.gg/yqqEGUjK">
    <img src="https://img.shields.io/discord/774471080713781259?label=Discord" alt="Discord">
  </a>
</p>

<h1 align="center">ViroReact (ReactVision)</h1>

ViroReact is a library for building Augmented Reality (AR) and Virtual Reality (VR) experiences using React Native. Viro runs your code natively across mobile VR (including Google Daydream, Samsung Gear VR, and Google Cardboard on iOS and Android) and AR platforms (iOS ARKit and Android ARCore).

<table>
  <tr>
    <td align="centre">
      <img height="200" src="https://raw.githubusercontent.com/viromedia/viro/master/code-samples/js/ARCarDemo/viro_car_marker_demo.gif" alt="AR car demo">
    </td>
    <td align="centre">
      <img height="200" src="https://github.com/ViroCommunity/viro/assets/430272/b153b8e4-7b40-4197-b05b-dd1eb1566102" alt="Viro example">
    </td>
  </tr>
</table>

## Documentation

Documentation is available here: https://viro-community.readme.io/docs/overview

We do our best to keep it up to date, but you may occasionally encounter broken links or outdated samples. If you spot anything, please submit an edit or reach out on Discord: https://discord.gg/A6TaFNqwVc

## Getting Started

If you’re starting a fresh project with ViroReact, clone one of the starter kits:

- Expo + TypeScript: https://github.com/ReactVision/expo-starter-kit-typescript
- React Native: https://github.com/ReactVision/starter-kit
- Expo + JavaScript: https://github.com/ReactVision/expo-starter-kit

## Examples

See the `./examples` directory for sample code demonstrating ViroReact usage, including automatic architecture detection and other features.

You can also browse the example projects page: https://viro-community.readme.io/docs/examples  
These are a little old (~2019), but they’re still a useful reference for many parts of the library.

## Connect with the ReactVision Community

For support, discussion, or contributing to ViroReact, Discord is the best place to find us:

<a href="https://discord.gg/A6TaFNqwVc">
  <img src="https://discordapp.com/api/guilds/774471080713781259/widget.png?style=banner2" alt="Discord Banner"/>
</a>

## External Support

If you need hands-on help, we maintain a list of trusted partners you can hire:  
https://viro-community.readme.io/docs/hire-a-viro-react-expert

All partners are vetted by the ReactVision team and have experience shipping production-grade apps with Viro.

## Powered by

[![JetBrains logo.](https://resources.jetbrains.com/storage/products/company/brand/logos/jetbrains.svg)](https://jb.gg/OpenSource)

## Supporters

A huge thank you to everyone who supports ongoing development by sponsoring us on GitHub:  
https://github.com/sponsors/ReactVision

- https://github.com/devicecloud-dev — Device Cloud: https://devicecloud.dev/
- https://github.com/lentesta
- Looking Glass: http://looking-glass.space

## A little history…

ViroReact was originally developed by Viro Media (http://www.viromedia.com/) and open-sourced in 2019.

In late 2020, the Viro Community formed to help maintain and modernise the project—keeping it compatible with current React Native versions and expanding functionality over time.

In 2025, Morrow acquired ReactVision (https://www.themorrow.digital/blog/morrow-acquires-reactvision-and-viroreact-library) to accelerate development and invest in the future of ViroReact. ReactVision now has a full-time team working to keep the codebase current and ready for the next generation of XR / spatial computing.

Our vision is to enable React Native developers to build AR and VR applications that run across XR devices (smartphones, smart glasses, and headsets) from a single React Native codebase.

We (as a community) owe a great debt to Viro Media and the original authors of this library, and we hope to make them proud as it continues to grow within ReactVision.