Skip to content
RNUEReact Native for Unreal Engine
Get started

Get started
with RNUE.

It only takes a few minutes to get access and start creating.

Docs ↗
Small productionsbudget <
Free forever

Indie games and productions with a budget under $1M. Sign the EULA and get a perpetual, free license to use RNUE in your project.

Sign the EULA
$1M
≤ budgetBig productions
Talk to us

Commercial titles with a budget of $1M or more. We'll put together a license that fits your production.

Contact us ↗
Step 11

Sign the EULA

To use React Native for Unreal Engine you sign an End User License Agreement. Get in touch to start the process, or to ask questions first.

Sign the EULAorContact us ↗
Step 22

Connect your GitHub account

Once the EULA is signed, connect your GitHub account to join the react-native-unreal GitHub organization and get your credentials for the private @rnue package registry.

Connect GitHubAfter step 1
Step 33

Set up your machine

Log in to the registry, scope @rnue to it in your project, and install a supported Unreal Engine.

$ npm login --registry=https://npm.rnue.dev/
.npmrc · project root
@rnue:registry=https://npm.rnue.dev/
Check it worked
$ npx @rnue/cli
Hello World

Zero to a React
surface in Unreal.

Half the work happens in JavaScript, half in the editor. Steps alternate between the two, just like your day will.

JavaScriptYour terminal
Unreal EngineYour editor
04
04Prepare your project

Install the plugin

Clone it into your project's Plugins folder, enable it, and add the module.

$ git clone https://github.com/etodanik/ReactNativeUnreal.git ReactNative
  • MyGame
    • Plugins
      • ReactNative
    • Source
      • MyGame
        • MyGame.Build.cs
      • MyGame.Target.cs
      • MyGameEditor.Target.cs
    • MyGame.uproject
MyGame.uproject
"Plugins": [
  {
    "Name": "React",
    "Enabled": true,
    "Version": 2
  }
]
MyGame.Build.cs
PrivateDependencyModuleNames
  .Add("ReactNative");
05Create the app

Create your project

Terminal
$ npm create @rnue/app@latest hello-world
Choose a starter
  • Minimal · TypeScript (default)
  • Minimal · JavaScript
  • Expo Web + RNUE · one React tree for the browser and Unreal
✔ Created hello-world
$
05
06Run Metro

Start the dev server

The Unreal Engine plugin connects to the Metro dev server for live editing and DevTools support.

Terminal
$ npm run start
Welcome to React Native v0.86
Starting dev server on http://localhost:8081
INFO Dev server ready. Press Ctrl+C to exit.
r reload app(s) d dev menu j DevTools
06
07
07Add a React Surface

Put it on screen

Create a level and a Widget Blueprint. Add a React Surface to the widget and set its Module Name. Then create the widget and add it to the viewport from the Level Blueprint.

Details · ReactSurface×
React
Module NameHelloWorld
08
08Run the game

Press Play

Your React surface renders in the viewport. Edit App.tsx, save, and watch it update.

Play
Done

That's it.

React Native, running in Unreal Engine.

Full walkthrough ↗
Docs

Learn More

Explore various use cases and features in the documentation