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 implementation right now, and Xcode only runs on Mac.
2. New to Xcode? Download it from the Mac App Store.
3. Homebrew is the recommended way to install node, watchman, and flow.
4. brew install node. New to node or 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.

Quick start

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

In the newly created folder AwesomeProject/

• Open 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 just successfully run and modified your first React Native app.

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