expo / create-react-native-app

Create React Native apps that run on iOS, Android, and web

Create React Native App

The fastest way to create React Native apps

npx create-react-native-app

Once you're up and running with Create React Native App, visit the tutorial on reactnative.dev and the tutorial on expo.dev for more information on building mobile apps with React.

Usage

• npx create-react-native-app Create a new native React app.
• npx crna Alias for npx create-react-native-app.
• npm run ios -- (npx expo run:ios) Build the iOS App (requires a MacOS computer).
• npm run android -- (npx expo run:android) Build the Android App.
• npm run web -- (npx expo start --web) Run the website in your browser.

Templates

By default you create a bare workflow React project with support for iOS, Android, and web. The project comes preconfigured with support for Expo Modules, an API writing native modules using Swift and Kotlin, and this also makes it possible to use any library in the Expo SDK.

You can opt to use an example project instead by selecting the "Templates from ..." option. Custom templates can be used with --template <Example Name or GitHub URL> option.

• Use an example: npx create-react-native-app -t with-typescript
• Use a custom template: npx create-react-native-app --template https://github.com/someone/my-react-starter -- Only works with GitHub repos on the master branch.
• All examples can be modified in the expo/examples repo.

Sections

• Usage with Expo Go App
• Support and Contact
• FAQs
• Contributing

Usage with Expo Go App

Expo Go enables you to work with all of the Components and APIs in react-native, as well as the JavaScript APIs that the are bundled with the Expo app.

• Download the "Expo Go" app from the Play Store or App Store.
• Start your project with Expo CLI: npm start
• Open the project by scanning the QR code in the terminal.

Support and Contact

If you're having issues with Create React Native App, please make sure:

• The issue is not covered in the Expo Docs
• There is not already an open issue for your particular problem

If you've checked the documentation and currently open issues, please either open a new GitHub issue or ask a question on Expo Community Discord.

Contributing

Refer to the Contributing guide for more information.

Attribution

The examples feature was inspired by the templates system of create-next-app by the Vercel team.

Related

CRNA is focused on being the fastest way to bootstrap a React Native app without worrying about the native platforms or bundlers required for developing and shipping apps. Other tools provide both an init script (which is slower) and a suite of other tools that can be used for interacting with the project. CRNA is meant to be used with any of the following tools:

• Expo CLI by Expo team
• Ignite CLI by Infinite Red
• React Native Community CLI by members of the React Native community

Contributors ✨

Thanks goes to these wonderful people (emoji key):

Evan Bacon 💻 📖 🎨 🚧 👀	Brent Vatne 💻 📖 👀	Hamza Halilovic 💻	Cedric van Putten 💻	Ville Immonen 💻 👀	Frieder Bluemle 💻	Kim Brandwijk 💻
Nirav 💻

This project follows the all-contributors specification. Contributions of any kind welcome!