Building Immersive VR Apps with React Native on Meta Quest: A Step-by-Step Guide

By • min read

Overview

React Native has always been about enabling developers to reuse knowledge across platforms, from Android and iOS to Apple TV, Windows, macOS, and even the web via react-strict-dom. In 2021, the Many Platform Vision outlined a future where React Native could adapt to new devices and form factors without fragmenting the ecosystem. At React Conf 2025, that vision took another leap forward with official React Native support for Meta Quest devices. This guide walks you through everything you need to know: how to get started, what works today, and how to build and ship VR apps using familiar tools and patterns.

Meta Quest devices run Meta Horizon OS, an Android-based operating system. This means all existing Android tooling, build systems, and debugging workflows carry over with minimal changes. If you've built React Native apps for Android, you're already most of the way there. Rather than introducing a new runtime or development model, Meta Quest integrates seamlessly with React Native's existing abstractions, allowing platform-specific capabilities without fragmenting the framework.

Prerequisites

Before diving in, ensure you have the following:

• A Meta Quest headset (Quest 2, Quest 3, or Quest Pro) updated to the latest firmware.
• Node.js (v18 or later) and npm (or yarn) installed on your development machine.
• Basic familiarity with React Native and the command line.
• The latest Expo CLI installed globally: npm install -g expo-cli (or use npx).
• A Meta Horizon Store account (developer mode enabled) – required to install Expo Go and later side-load builds.

Optionally, you may want a USB-C cable for side-loading or debugging, though most workflow is wireless.

Step-by-Step Instructions

1. Install Expo Go on the Meta Quest

Expo Go is available on the Meta Horizon Store. It allows rapid iteration during development without building a full APK. Install it directly on your headset:

• Power on your headset and open the Meta Horizon Store.
• Search for “Expo Go” and install it (it’s free).
• Once installed, launch it at least once to accept permissions.

2. Create (or Use) an Expo Project

No special template is needed. Create a standard Expo app from the command line:

npx create-expo-app@latest my-quest-app
cd my-quest-app

3. Start the Dev Server

Run the development server on your machine:

npx expo start

This launches Expo's developer tools in your browser and a QR code in the terminal.

4. Connect with the Meta Quest Headset

Put on your headset and open the Expo Go app. Look for the “Scan QR Code” option (usually under the main menu). Point the headset’s camera at the QR code displayed in your terminal or Expo dev tools. The app should load in a new floating window inside the headset. You'll see your React Native UI rendered in VR.

5. Iterate as Usual

Any changes you make to your code are reflected instantly on the headset (live reloading). This edit-refresh cycle is identical to mobile development. For example, change the text in App.js and save – the headset view updates within seconds.

Development Builds and Native Features

Expo Go is great for prototyping, but to access native VR features (like hand tracking, controllers, or spatial audio), you’ll need a development build. This is a custom version of the Expo Go app that includes your native modules.

Creating a Development Build

Run the following from your project root:

npx expo run:android

This compiles a native Android app using the same toolchain as regular React Native for Android. The resulting APK can be side-loaded onto the headset via adb install or uploaded to the Meta Horizon Store for testing. For more details, see the Platform-Specific Setup section.

Platform-Specific Setup and Differences from Mobile

While Meta Quest is Android-based, there are a few key differences to keep in mind:

• Windowed app model: On Meta Quest, React Native apps run in a 2D window floating in VR. You cannot (yet) render directly into the 3D environment using React Native alone.
• Input handling: Touch events map to controller clicks or hand gestures. Consider using libraries like react-native-web-hooks for pointer events.
• Permissions: You may need to request com.oculus.permission.HAND_TRACKING if using hand tracking in a development build.
• Build target: Use --target aab for production builds to submit to the Horizon Store.

Design and UX Considerations for VR

Building for VR isn’t just about porting your mobile app – the user’s context is different. Keep these tips in mind:

• Readability: Ensure text is large enough (minimum 24px in VR space). Avoid small buttons that are hard to target with controllers.
• Field of view: Place UI elements in the center of the user’s gaze. Off-center elements may be missed.
• Motion sickness: Avoid rapid animations or moving UI. Keep interactions stable.
• Depth cues: Use shadows and layering to indicate interactive elements.

Common Mistakes

• Forgetting to enable developer mode: Without developer mode on your Quest, Expo Go won't connect to the dev server.
• Using the wrong Expo Go version: Make sure Expo Go on the headset is up-to-date, otherwise QR scanning may fail.
• Assuming full 3D rendering: React Native on Quest currently renders in a 2D window. For true 3D, you need to bridge to native VR frameworks (e.g., using react-native-vr third-party libraries).
• Ignoring performance: VR headsets have limited resources compared to phones. Profile your app using the built-in perf monitor.

Summary

React Native on Meta Quest brings the power of cross-platform development to VR headsets. Using Expo Go, you can start prototyping in minutes, and with development builds, you can access native features for more immersive experiences. The key takeaway? Your familiar React Native skills apply – just with a new form factor. As the platform matures, deeper integration with the 3D environment is expected. Start building today and be part of the VR revolution.