react-native/docs/GettingStarted.md

id	title	layout	category	permalink	next
getting-started	Getting Started	docs	Quick Start	docs/getting-started.html	tutorial

Requirements

1. OS X - This repo only contains the iOS (7+) implementation right now, and Xcode only runs on Mac.
2. Xcode 6.3 or higher is recommended.
3. Homebrew is the recommended way to install io.js, watchman, and flow.
4. Install io.js 1.0 or newer. io.js is the modern version of Node.

• Install nvm with its setup instructions here. To benefit from the changes to your .bashrc, close and reopen your terminal window. Then run nvm install iojs-v2 && nvm alias default iojs-v2, which installs the latest compatible version of io.js and sets up your terminal so that typing node runs io.js. With nvm you can install multiple versions of Node and io.js and easily switch between them.
• New to npm?

5. brew install watchman. We recommend installing watchman, otherwise you might hit a node file watching bug.
6. brew install flow. If you want to use flow.

We recommend periodically running brew update && brew upgrade to keep your programs up-to-date.

Quick start

• npm install -g react-native-cli
• react-native init AwesomeProject

In the newly created folder AwesomeProject/

• Open iOS/AwesomeProject.xcodeproj and hit run in Xcode.
• Open index.ios.js in your text editor of choice and edit some lines.
• Hit cmd+R in your iOS simulator to reload the app and see your change!

Congratulations! You've successfully run and modified your first React Native app.

If you run into any issues getting started, see the troubleshooting page.