React Native enables you to build world-class application experiences on native platforms using a consistent developer experience based on JavaScript andReact.The focus of React Native is on developer efficiency across all the platforms you care about - learn once, write anywhere. Facebook uses React Native in multiple production apps and will continue investing in React Native.
Supported operating systems are >= Android 4.1 (API 16) and >= iOS 7.0.
- Getting Started
- Getting Help
- Documentation
- Examples
- Extending React Native
- Upgrading
- Opening Issues
- Contributing
- License
See the officialReact Native websitefor an introduction to React Native.
- Follow theGetting Started guideto install React Native and its dependencies.
- Check out thistutorialto walk through your first project that fetches real data and displays it in a list.
- Open the UIExplorer example projectto see a list of components that ship with React Native.
- Install the React Developer Tools forChromeorFirefoxfor better debugging(read more).
- Try out apps from theShowcaseto see what React Native is capable of!
Please use these community resources for getting help. We use the GitHub issues for tracking bugs and feature requests and have limited bandwidth to address them.
- Ask a question onStackOverflowand tag it with
react-native
- Chat with us onReactifluxin #react-native
- Articulate your feature request or upvote existing ones onProduct Pains
- Start a thread on theReact Discussion Board
- Join #reactnative on IRC: chat.freenode.net
- If it turns out that you may have found a bug, pleaseopen an issue
The website’s documentationis divided into multiple sections.
- There areGuidesthat discuss topics likedebugging,integrating with existing apps,andthe gesture responder system.
- TheComponentssection covers React components such as
View
andNavigator
. - TheAPIssection covers other libraries likeAnimatedandStyleSheetthat aren’t React components themselves.
- Finally, React Native provides a small number ofPolyfillsthat offer web-like APIs.
Another great way to learn more about the components and APIs included with React Native is to read their source. Look under theLibraries
directory for components likeScrollView
andNavigator
,for example. The UIExplorer example is also here to demonstrate some of the ways to use these components. From the source you can get an accurate understanding of each component’s behavior and API.
The React Native documentation only discusses the components, APIs and topics specific to React Native (React on iOS and Android). For further documentation on the React API that is shared between React Native and React DOM, refer to theReact documentation.
git clone https://github /facebook/react-native.git
cd react-native && npm install
Now open any example (the.xcodeproj
file in each of theExamples
subdirectories) and hit Run in Xcode.
Note that you'll need the Android NDK installed, seeprerequisites.
./gradlew:Examples:Movies:android:app:installDebug
#Start the packager in a separate shell (make sure you ran npm install):
./packager/packager.sh
#Open the Movies app in your emulator
- Looking for a component?JS.coach
- Fellow developers write and publish React Native modules to npm and open source them on GitHub.
- Making modules helps grow the React Native ecosystem and community. We recommend writing modules for your use cases and sharing them on npm.
- Read the guides on Native Modules (iOS,Android) and Native UI Components (iOS,Android) if you are interested in extending native functionality.
React Native is under active development. See the guide onupgrading React Nativeto keep your project up-to-date.
If you encounter a bug with React Native we would like to hear about it. Search theexisting issuesand try to make sure your problem doesn’t already exist before opening a new issue. It’s helpful if you include the version of React Native and OS you’re using. Please include a stack trace and reduced repro case when appropriate, too.
The GitHub issues are intended for bug reports and feature requests. For help and questions with using React Native please make use of the resources listed in theGetting Helpsection.Product Painsin particular is a good way to signal your interest in a feature or issue. There are limited resources available for handling issues and by keeping the list of open issues lean we can respond in a timely manner.
For more information about contributing PRs and issues, see ourContribution Guidelines.
Good First Taskis a great starting point for PRs.
We encourage the community to ask and answer questions on Stack Overflow withthe react-native tag.It's a great way to help out and be involved!
React isBSD licensed.We also provide an additionalpatent grant.
React documentation isCreative Commons licensed.
Examples provided in this repository and in the documentation areseparately licensed,as are some of thecustom components.