@callstack/react-native-visionos

React Native visionOS

Learn once, write anywhere:
Build spatial apps with React.

React Native visionOS allows you to write visionOS with full support for platform SDK. This is a full fork of the main repository with changes needed to support visionOS.

🎉 Building your first spatial React Native app

Follow the Getting Started guide. If you wish to get started quickly, you can utilize this command:

npx @callstack/react-native-visionos@latest init YourApp

📖 Documentation

The full documentation for React Native visionOS can be found on our website.

The source for the React Native visionOS documentation and website is hosted on a separate repo, @callstack/react-native-visionos-docs.

Contributing

Prerequisites:

• Download the latest Xcode (at least 15.2)
• Install the latest version of CMake (at least v3.28.0)

Check out rn-tester README.md to build React Native from the source.

Remember to use RNTester-visionOS target

If RNTester-visionOS scheme is not showing up, click "New Scheme", which should be pre-populated with RNTester-visionOS. Build the app using Xcode.

Release process

We use a script called oot-release.js which automatically releases visionos packages and aligns versions of dependencies with React Native core.

Usage:

node ./scripts/oot-release.js --new-version "<visionos-version>" --react-native-version "<react-native-version>" --one-time-password "<otp>"

To test releases and template we use Verdaccio.

Changelog

v0.74.4

Added

Android specific

• Stub com.facebook.react.settings on 0.74 (13ea273850 by @cortinico)

iOS specific

• Prebuilt version of Hermes for visionOS (924fb3de9b by @okwasniewski)

Fixed

• Don't break script phase and codegen when coreutils installed on macOS (e0799536ef by @blakef)
• Remove setting of process.exitCode that breaks Jest tests (e42932cfc6 by @@douglowder)

iOS specific

• Make sure to pass the RCTBridgeProxy to ViewManagers (d6c90cf7ed by @cipolleschi)
• Implement shared atomic counters and replace static integers in RCTImageLoader and RCTNetworkTask that were accessed concurrently, which in some cases lead to data races. (ffc16fc18b by @hakonk)
• Do not use temporary node when creating the .xcode.env.local (8408b8bc96 by @cipolleschi)
• Building of iOS project when RCTAppDelegate is used in the project (be93092c1b by @nikhiltekwani09)
• Fix error on handling privacy manifest (e39e9c4a60 by @cxa)