Introduction

React Native CLI (Command Line Interface) offers developers full control over the mobile app development process, making it the preferred choice for building complex, high-performance apps on both Android and iOS. Setting up the environment for React Native CLI is a crucial first step for developers aiming to build high-performance mobile applications for Android and iOS. Unlike Expo, React Native CLI offers greater control over native code and advanced configurations, making it ideal for production-level projects. This setup involves installing Node.js, Java Development Kit (JDK), Android Studio, and Xcode (for macOS users), along with configuring key environment variables. In this guide, we provide a step-by-step walkthrough to help you set up a complete and functional React Native CLI development environment on Windows, macOS, and Linux systems with ease.

Prerequisites and System Requirements

Industry Cloud Platforms are purpose-built cloud environments that offer services taiBefore diving into setup, make sure your system meets the following baseline requirements.

Node.js & npm

Install the latest LTS version of Node.js (v20 or higher). npm comes bundled with Node.js.

Java Development Kit (JDK)

Use JDK 17 or later for compatibility with the latest Android Gradle plugin.

Android Studio

Install Android Studio Hedgehog or newer, which includes updated emulators and SDK tools.

Xcode (macOS only)

To build iOS apps, Xcode 15+ is required on macOS systems.

CocoaPods (macOS)

Used to manage iOS native libraries. Install via RubyGems.

Watchman (macOS)

A file watcher required by React Native for optimal performance.

React Native CLI depends on several core tools to function correctly.

Download from https://nodejs.org and verify with:

node -v
npm -v

Installing Core Dependencies

Instead of installing globally

npx react-native@latest init MyApp

Installing Java JDK

Install JDK 17 and configure the JAVA_HOME environment variable properly

Installing Watchman (macOS)
brew install watchman
Installing Python (Linux)
sudo apt install python3

Setting Up Android Development Environment

For Android app development, proper SDK and emulator configuration is essential.

Install Android Studio

Download from developer.android.com, then install these components:

  • Android SDK
  • Emulator
  • SDK Build Tools
  • NDK (if needed)
Configure Android SDK Paths

Set environment variables:

ANDROID_HOME=<your-sdk-path>
export PATH=$PATH:$ANDROID_HOME/emulator
export PATH=$PATH:$ANDROID_HOME/platform-tools
Create Android Virtual Device (AVD)

Use the AVD Manager in Android Studio to create a virtual device for testing.

Enable Developer Mode on Android Device

If testing on a real device, enable USB debugging and install proper drivers.

Setting Up iOS Development Environment (macOS Only)

iOS development is only supported on macOS with Xcode.

Install Xcode

Download from the App Store, then install command-line tools:

xcode-select --install

Install CocoaPods

Use RubyGems:

sudo gem install cocoapods

Configure iOS Simulator

Use Xcode to launch and manage various iOS simulators. Enable Permissions

Ensure macOS allows terminal and simulator permissions to avoid build failures.

Running and Testing Your First App

Once everything is set up, create and run your first React Native project.

Create a New App

Use:

npx react-native init FirstApp

Start Metro Bundler

In the project directory:

npx react-native start

Run on Android

Ensure an emulator or device is connected:

npx react-native run-android

Run on iOS (macOS Only)

Start the iOS simulator:

npx react-native run-ios

Optional Tools and Tips (2025)

Boost your React Native workflow with these optional tools and tips.

Use Flipper for Debugging

Flipper is integrated with React Native by default and helps debug apps visually.

Enable Hermes Engine

For performance improvements, enable Hermes in android/app/build.gradle.

Use ESLint + Prettier

Improve code quality with integrated linting and formatting.

Use VS Code with Extensions

Install React Native Tools extension for debugging and IntelliSense.

Use React Native Doctor

Diagnose setup issues:

npx react-native doctor

Conclusion

Setting up the React Native CLI environment may seem complex at first, but it’s a critical foundation for building high-quality, production-ready mobile applications. With the latest updates in 2025 like React Native v0.74+, Node.js v20+, Android Studio Hedgehog, and Xcode 15 developers now have more powerful and stable tools at their disposal. By carefully following the steps outlined in this guide, you’ll be fully equipped to develop for both Android and iOS platforms using native modules, advanced debugging tools, and custom configurations. Once set up, React Native CLI provides unmatched flexibility, speed, and control for modern app development

Selvakumar - CEO, Dhina Technologies

Written by Selvakumar

CEO of Dhina Technologies

Passionate Software Developer | Turning lines of code into innovative solutions | Tech enthusiast on a mission to shape the digital world.

Discover Your Ideas With Us

Transform your business with our Web Development solutions. Achieve growth, innovation, and success. Collaborate with our skilled development team today to revolutionize your digital presence!