react-native README

The project's README from github.com/react/react-native. As one markdown file: README.md.

React Native logo

Learn once, write anywhere:
Create native apps for Android, iOS, and more using React

React Native is released under the MIT license Current npm package version Monthly npm downloads Follow @reactnative on X

Getting Started · Learn the Basics · Showcase · Contribute · Community · Support

React Native

React Native lets you build native apps using React. Written in JavaScript, rendered with native code.

React Native is developed and supported by many companies and individual core contributors. Find out more on the React Foundation website.

Building your first React Native app

Follow the Getting Started guide for a new app, or Integration with Existing Apps to adopt React Native incrementally.

Using a Framework

We believe that the best way to experience React Native is through a Framework, a toolbox with all the necessary APIs to let you build production ready apps. Expo is a production-grade React Native Framework, with file-based routing, a standard library of native modules, and much more.

To create a new Expo project, run the following in your terminal:

npx create-expo-app@latest

Then follow the rest of Expo's getting started guide to start building.

Without a Framework

You can also use React Native without a Framework, however we've found that most developers benefit from one — navigation, native dependencies, and platform tooling are problems the ecosystem has already solved. If a Framework doesn't suit your app, follow Getting Started Without a Framework.

Documentation

The full documentation for React Native can be found on our website.

The source for the React Native docs and website is hosted on a separate repository, react/react-native-website.

Contributing

The main purpose of this repository is to continue evolving React Native core. We want to make contributing to this project as easy and transparent as possible, and we are grateful to the community for contributing bug fixes and improvements. Read below to learn how you can take part in improving React Native.

Code of Conduct

Meta has adopted a Code of Conduct that we expect project participants to adhere to. Please read the full text so that you can understand what actions will and will not be tolerated.

Contributing Guide

Read our Contributing Guide to learn about our development process, how to propose bugfixes and improvements, and how to build and test your changes to React Native.

Discussions

Larger discussions and proposals are discussed in react-native-community/discussions-and-proposals.

React Native releases are discussed in reactwg/react-native-releases.

License

React Native is MIT licensed, as found in the LICENSE file.

react-native (react/react-native)

Searching Database…

What is this?React Native lets you build native mobile apps for Android, iOS, and other platforms using React. UI is described in JavaScript but rendered with real native platform components, not a webview.
Is this a UI library or something more, like a full app framework?It is a core framework: it provides native UI primitives, a JS-to-native bridge (Native Modules), and the rendering architecture, but it's not a complete toolbox by itself — the project recommends pairing it with a higher-level framework like Expo for routing, native dependency management, and tooling.
How do I start a new React Native app?The recommended path is to use Expo: run 'npx create-expo-app@latest' and follow Expo's getting started guide. You can also skip a framework and follow the 'Getting Started Without a Framework' guide, or integrate React Native into an existing native app.
Do I need native mobile dev tools installed too?Yes — since React Native renders to real native UI and ships with Native Modules for calling platform code, you'll need the standard Android/iOS toolchains (Android Studio/Gradle, Xcode/CocoaPods) alongside Node/JavaScript tooling.
Is it better to just use this without any framework?The maintainers explicitly discourage going frameworkless for most people: navigation, native dependencies, and platform tooling are considered already-solved problems in the Expo ecosystem, so skipping it means solving those yourself.
Which platforms does it target?Android and iOS are the primary targets, with the tagline promising 'native apps for Android, iOS, and more' via a learn-once-write-anywhere approach.
What happens when I edit JavaScript code during development?Fast Refresh applies JS changes in seconds without rebuilding the native app, so you see local changes almost instantly.
Does the UI actually use native components, or is it a webview?It renders to real native platform UI primitives, so gestures, text scaling, and accessibility behave exactly as users expect on each OS, not through an embedded browser.
Can I add React Native to an app I already have?Yes, the 'Integration with Existing Apps' guide covers adopting React Native incrementally inside an existing native codebase.
What if I need functionality React Native doesn't provide out of the box?You can write Native Modules to call platform code directly from JavaScript (synchronous and type-safe), or use one of thousands of existing community libraries.
Creator
react
Size
965.5 MB
Stars
126.7K
Age
11y
Commits · 90 Days