Skip to main content
Applications generated by Symplr are built using React Native and require specific versions of supporting development tools to build and run successfully. This page provides the approved software toolchain versions for each supported React Native release. Before building or running a generated application, ensure that the required versions of Node.js, Java, Android SDK components, Xcode, Ruby, and CocoaPods are installed. Using unsupported tool versions may result in dependency installation failures, Android build failures, iOS build failures, simulator or emulator launch issues, and runtime compatibility issues.

​
When to Use This Page

Use this page when:
  • Setting up a local development environment
  • Running a generated application locally
  • Troubleshooting Android build failures
  • Troubleshooting iOS build failures
  • Verifying software compatibility requirements
  • Preparing a development workstation for Symplr-generated applications

​
Currently Supported React Native Versions

Symplr currently generates applications using the following React Native versions:
React Native VersionStatus
0.81.4Default for new applications
0.79.1Supported for existing applications
Any other React Native version is currently outside the supported scope.

​
Determine the React Native Version

To determine which React Native version your application uses:
  1. Open the downloaded application package.
  2. Locate the package.json file.
  3. Find the react-native dependency.
Example: 
{
  "react-native": "0.81.4"
}
Use the matching compatibility information listed below for your application’s React Native version.

​
Software Tool Compatibility Matrix

Software ToolReact Native 0.81.4React Native 0.79.1Notes
Node.js≥ 22.22.220.19.5Use a version manager such as fnm or nvm
React19.1.019.0.0Managed by project dependencies
Yarn1.22.x1.22.xRequired for dependency management
JDK1717Configure JAVA_HOME
Android StudioLatestLatestRequired for Android development
Android Gradle Plugin8.8.x8.7.xDefined by project configuration
Compile SDK3635Android SDK Platform
Target SDK3535Android API target level
Minimum SDK2424Minimum supported Android version
Xcode26.1.126.1.1Required for iOS development
iOS Target15.115.1Defined by project configuration
Ruby≥ 3.2≥ 3.2Do not use the system Ruby installation
CocoaPods≥ 1.15≥ 1.15Use an approved CocoaPods version
WatchmanLatestLatestRecommended for Metro bundler
The following installation methods are recommended when preparing a local development environment.
ToolRecommended Installation Method
Node.jsfnm or nvm
JDKZulu OpenJDK 17
Android StudioAndroid Studio
Rubyrbenv
CocoaPodsRuby Gems
WatchmanHomebrew
XcodeMac App Store

​
Android Development Requirements

For Android application development, ensure that:
  • Android Studio is installed
  • Android SDK Platform is installed for the required API level
  • JDK 17 is configured correctly
  • Android SDK Build Tools are available
  • Android Emulator images are installed when emulator testing is required

​
iOS Development Requirements

For iOS application development, ensure that:
  • Xcode 26.1.1 is installed
  • CocoaPods is installed
  • Ruby 3.2 or later is installed
  • iOS Simulator components are available
  • Apple development requirements are satisfied

​
Common Compatibility Issues

Using unsupported software versions may result in:
  • Dependency installation failures
  • Android build failures
  • iOS build failures
  • Android Emulator launch issues
  • iOS Simulator launch issues
  • CocoaPods installation failures
  • Gradle synchronization failures
  • Runtime compatibility issues
If build failures occur, verify that all installed tools match the versions listed in the compatibility matrix. For additional setup and execution guidance, see:
  • Download Code
  • Run Application Locally
  • GitHub Integration
  • Code Generation Settings