Installation Guide
This guide will help you configure your system to develop React Native applications using Expo.
System Requirements
| Requirement | Minimum | Recommended | Notes |
|---|---|---|---|
| Operating System | Windows 10 / macOS 12+ | Windows 11 / macOS 13+ | 64-bit OS required |
| RAM | 8 GB | 16 GB | Emulators require more memory |
| Free Disk Space | 15 GB | 25+ GB | Android Studio may use 8–10 GB |
| Node.js | v20 LTS | v24.14.0 LTS | Install using NVM |
| Git | Latest | Latest | Required to clone repository |
| Android Studio | Latest Stable | Latest Stable | Recommended for Windows |
| Xcode | Latest | Latest | Recommended for macOS |
Web support works on both macOS and Windows.
If emulator setup fails, you can continue using Web during the workshop.
Browser
- Google Chrome (recommended)
What You’ll Be Able to Do
- Run apps on Web
- Run apps on Android Emulator (recommended for Windows)
- Run apps on iOS Simulator (recommended for macOS)
Recommended Setup Order
- Install NVM
- Install Node using NVM
- Clone workshop repository
- Test Web
- Configure recommended emulator for your OS
Development Operating System
- macOS
- Windows
macOS Setup
On macOS, the iOS Simulator is recommended.
If not installed, Web works perfectly fine.
Step 1: Install NVM
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash
Restart your terminal and verify:
nvm --version
Step 2: Install Node
nvm install 24.14.0
nvm use 24.14.0
Verify:
node -v
npm -v
Step 3: Clone Workshop Repository
git clone https://github.com/nupur-trivedi-11/habit-app.git
cd habit_app
npm install
Step 4: Test Web
npx expo start --web
If the browser does not open automatically, press:
w
If web runs successfully, your setup is ready.
Recommended: iOS Simulator
Install Xcode from the App Store.
After installation:
sudo xcode-select --switch /Applications/Xcode.app
sudo xcodebuild -license
Start Expo:
npx expo start
Press:
i
If the simulator fails to launch, continue using Web.
Windows Setup
On Windows, Android Studio (Android Emulator) is recommended. If Android setup fails, Web works perfectly fine.
Step 1: Install NVM for Windows
Download:
https://github.com/coreybutler/nvm-windows/releases
Restart terminal and verify:
nvm version
Step 2: Install Node
nvm install 24.14.0
nvm use 24.14.0
Verify:
node -v
npm -v
Step 3: Install Git (If Needed)
Download:
Verify:
git --version
Step 4: Clone Workshop Repository
git clone https://github.com/nupur-trivedi-11/habit-app.git
cd habit_app
npm install
Step 5: Test Web
npx expo start --web
If the browser does not open, press:
w
If Web runs successfully, your setup is ready.
JDK Installation
React Native Android requires JDK 17. Follow the steps below to install and configure it.
Step 1: Install JDK 17
Download and install JDK 17:
https://download.oracle.com/java/17/archive/jdk-17.0.12_windows-x64_bin.exe
Install using default settings.
Step 2: Find Installation Path
After installation, JDK is typically located at:
C:\Program Files\Java\jdk-17.0.12
Step 3: Set JAVA_HOME
- Open Start Menu
- Search for
Environment Variables - Click Edit the system environment variables
- Click Environment Variables
Add a new System Variable:
- Variable Name:
JAVA_HOME - Variable Value:
C:\Program Files\Java\jdk-17.0.12
Step 4: Update Path Variable
- In System Variables, find
Path - Click Edit
- Add a new entry:
%JAVA_HOME%\bin
Step 5: Configure Android Studio
- Open Android Studio
- Navigate to:
File → Settings → Build, Execution, Deployment → Build Tools → Gradle
- Under Gradle JDK, select:
jdk-17
If it is not visible, download JDK or manually select the installed path.
Step 6: Verify Installation
Open Command Prompt and run:
java -version
javac -version
The output should show Java 17.
Recommended: Android Emulator Setup
Follow below expo guideline to install android emulator
Expo Android Studio Installation guide
Run on Android Emulator
npx expo start
Press:
a
If the emulator does not launch or is slow, continue using Web.
Emergency Fallback
If installation fails completely, use:
https://snack.expo.dev/@nupur.tr/habit-app-starter
No local installation required.
Final Verification Checklist
Before the workshop, confirm:
nvm --versionworksnode -vworksnpm installcompletes successfullynpx expo start --webruns- Recommended emulator launches (optional)
If Web runs successfully, your environment is ready.