Expo

Expo provides a React Native WebGPU template that works with React Three Fiber on iOS, Android, and web. This is the fastest path if you want a preconfigured project.

Create a project

npx create-expo-app@latest -e with-webgpu

The template includes react-native-webgpu, Reanimated, and Metro settings compatible with Three.js WebGPU builds.

For a walkthrough of the template, watch the video below.

Config plugin

react-native-webgpu ships its own Expo config plugin. Add it to the plugins array of your app config:

{
  "expo": {
    "plugins": ["react-native-webgpu"]
  }
}

The plugin disables Metal API Validation in the shared Xcode scheme of your iOS project - the equivalent of unchecking Product → Scheme → Edit Scheme → Run → Diagnostics → Metal API Validation in Xcode. This is required to run WebGPU on the iOS Simulator: Metal API validation flags false positives in Dawn that do not occur on a physical device and would otherwise crash the app (see the troubleshooting section).

With Continuous Native Generation, the ios directory is regenerated by npx expo prebuild --clean, so unchecking the setting manually in Xcode does not stick - the config plugin re-applies it on every prebuild.

The plugin only affects the iOS Xcode scheme; it is a no-op on Android and it changes nothing for release builds on physical devices. Since the plugin ships with the package, its version is always aligned with the react-native-webgpu version you have installed.