> ## Documentation Index
> Fetch the complete documentation index at: https://docs.symplr.io/llms.txt
> Use this file to discover all available pages before exploring further.

# React Native Software Tools & Version Compatibility

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 Version | Status                              |
| :------------------- | :---------------------------------- |
| 0.81.4               | Default for new applications        |
| 0.79.1               | Supported 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:

```json theme={null}
{
  "react-native": "0.81.4"
}
```

Use the matching compatibility information listed below for your application's React Native version.

## Software Tool Compatibility Matrix

| Software Tool         | React Native 0.81.4 | React Native 0.79.1 | Notes                                    |
| :-------------------- | :------------------ | :------------------ | :--------------------------------------- |
| Node.js               | ≥ 22.22.2           | 20.19.5             | Use a version manager such as fnm or nvm |
| React                 | 19.1.0              | 19.0.0              | Managed by project dependencies          |
| Yarn                  | 1.22.x              | 1.22.x              | Required for dependency management       |
| JDK                   | 17                  | 17                  | Configure JAVA\_HOME                     |
| Android Studio        | Latest              | Latest              | Required for Android development         |
| Android Gradle Plugin | 8.8.x               | 8.7.x               | Defined by project configuration         |
| Compile SDK           | 36                  | 35                  | Android SDK Platform                     |
| Target SDK            | 35                  | 35                  | Android API target level                 |
| Minimum SDK           | 24                  | 24                  | Minimum supported Android version        |
| Xcode                 | 26.1.1              | 26.1.1              | Required for iOS development             |
| iOS Target            | 15.1                | 15.1                | Defined by project configuration         |
| Ruby                  | ≥ 3.2               | ≥ 3.2               | Do not use the system Ruby installation  |
| CocoaPods             | ≥ 1.15              | ≥ 1.15              | Use an approved CocoaPods version        |
| Watchman              | Latest              | Latest              | Recommended for Metro bundler            |

## Recommended Installation Methods

The following installation methods are recommended when preparing a local development environment.

| Tool           | Recommended Installation Method |
| :------------- | :------------------------------ |
| Node.js        | fnm or nvm                      |
| JDK            | Zulu OpenJDK 17                 |
| Android Studio | Android Studio                  |
| Ruby           | rbenv                           |
| CocoaPods      | Ruby Gems                       |
| Watchman       | Homebrew                        |
| Xcode          | Mac 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.

## Related Documentation

For additional setup and execution guidance, see:

* Download Code
* Run Application Locally
* GitHub Integration
* Code Generation Settings