Prerequisites

Last updated 2026-10-07

Install and verify these tools before you add the framework to a project. Each section has download buttons for your operating system and copyable install commands, so you don't need to search anywhere else. Prefer one list? Open Downloads & tools.

All platforms

Tool	Version	Why it's needed	Official guide
Ruby	3.4.x (≥ 3.2)	fastlane is a Ruby gem; the Firebase plugin requires Ruby ≥ 3.2	ruby-lang.org
Bundler	≥ 2.4, < 5	Pins the exact fastlane version through `Gemfile.lock`	bundler.io
Git	any recent	Release notes are read from git history; branch checks for production	git-scm.com
Node.js	LTS	React Native projects only (`npm ci` before building)	nodejs.org

Download & install

Ruby 3.4 + DevKit (RubyInstaller)3.4.x

fastlane is a Ruby gem. DevKit compiles gems with native extensions on Windows.

Ruby+Devkit 3.4 (x64)

winget install RubyInstallerTeam.RubyWithDevKit.3.4

Verify: ruby --version

Pick the “WITH DEVKIT” x64 installer, and let it run “ridk install” at the end.

Official install guide

Ruby 3.4 via rbenv3.4.x

Never use the macOS system Ruby; rbenv installs a private Ruby per project.

rbenv install guide

brew install rbenv ruby-build && rbenv install 3.4.1

Verify: ruby --version

Official install guide

Bundler2.4 – 4.x

Pins the exact fastlane version through Gemfile.lock.

bundler.io

gem install bundler

Verify: bundle --version

Gitany recent

Release notes are built from git history; production lanes check the branch.

Windows macOS Linux

winget install Git.Git

Verify: git --version

Node.jsLTS

React Native's Gradle/Xcode build runs Node to bundle JavaScript; also needed for the Firebase CLI.

Download Node.js LTS

winget install OpenJS.NodeJS.LTS

Verify: node --version

Official install guide

Prefer step-by-step Ruby setup? See Install Ruby (Windows) or Install Ruby (macOS).

Android

Requirement	Notes	Official guide
JDK 17	Required by current Android Gradle Plugin versions. Set `JAVA_HOME`.	Eclipse Temurin
Android SDK + build tools	Installed with Android Studio; set `ANDROID_HOME`.	Android Studio
A working `android/gradlew`	Must build from the command line: `./gradlew assembleRelease`.	Build from the command line
Firebase project with the Android app registered	The package name must match applicationId exactly.	Add Firebase to Android
Firebase CLI	Needed once, to create `FIREBASE_TOKEN` (`npm i -g firebase-tools`).	Firebase CLI

Download & install

Java JDK 17 (Eclipse Temurin)17 LTS

Gradle needs it to build Android apps (React Native 0.73+ requires JDK 17).

Windows .msi macOS .pkg Linux

winget install EclipseAdoptium.Temurin.17.JDK

Verify: java -version

In the Windows installer, enable “Set JAVA_HOME variable”.

Official install guide

Android Studio + Android SDKlatest stable

Installs the Android SDK, build tools and platform tools used by Gradle.

Download Android Studio

winget install Google.AndroidStudio

Verify: adb --version

After the first launch, set ANDROID_HOME to the SDK path shown in Settings → Languages & Frameworks → Android SDK.

Official install guide

Firebase CLIlatest

Run once to create FIREBASE_TOKEN (“firebase login:ci”).

Windows standalone .exe All install options

npm install -g firebase-tools

Verify: firebase --version

Open Firebase console Open Firebase project settings (App ID)

iOS

Requirement	Notes	Official guide
macOS with Xcode and command-line tools	Install Xcode from the App Store, then run `xcode-select --install`.	Xcode
CocoaPods	It's installed through the Gemfile, and the framework runs `pod install` itself.	CocoaPods guide
Apple Developer Program membership	Required to sign and upload to TestFlight.	Apple Developer Program
App record in App Store Connect	Create the app with the same bundle identifier.	Add a new app
App Store Connect API key (`.p8`, Key ID, Issuer ID)	Used for signing, build numbers and upload, so no 2FA prompts.	Creating API keys

Download & install

Xcodelatest (App Store requirement)

Builds and signs the iOS app. macOS only.

Mac App Store Older versions (Apple Developer)

xcode-select --install

Verify: xcodebuild -version

Open Xcode once after installing to accept the license and install components.

Homebrewlatest

The macOS package manager used by the other macOS install commands.

brew.sh

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

Verify: brew --version

CocoaPods≥ 1.13

Installs iOS native dependencies. The framework runs “pod install” for you.

CocoaPods guide

echo 'gem "cocoapods", ">= 1.13"' >> Gemfile && bundle install

Verify: bundle exec pod --version

Open Apple Developer account (Team ID)Open App Store Connect Open App Store Connect API keys

Verify your machine

Run these commands in a new terminal. Every command should print a version and none should print "not found".

Windows PowerShell

PS C:\my-app> ruby --version
ruby 3.4.1 (2024-12-25 revision 48d4efcb85) +PRISM [x64-mingw-ucrt]
PS C:\my-app> bundle --version
Bundler version 2.6.2
PS C:\my-app> java -version
openjdk version "17.0.12" 2024-07-16
OpenJDK Runtime Environment Temurin-17.0.12+7 (build 17.0.12+7)
PS C:\my-app> git --version
git version 2.47.1.windows.1
PS C:\my-app> node --version
v22.12.0
PS C:\my-app> firebase --version
13.29.1

Android tool chain verified on Windows.

Tip: the exact version numbers on your machine will differ. What matters is that the major versions match the table above.

Next steps

Install Ruby (Windows)RubyInstaller with DevKit.Learn more Install Ruby (macOS)Homebrew, rbenv and ruby-build.Learn more

Official documentation

Was this helpful?

PreviousFolder structure NextReact Native compatibility