React Native Boilerplate

Table of Contents

• Tools & features
• Environment setup
• Installation
• Development
• Building the app

Tools & features included in this template

• Local, staging, and production environments
• Expo modules core
• Prettier
• React i18n
• React Native Config
• React Native SVG
• React Navigation
• Redux Toolkit
• RTK Query
• Tailwind
• TypeScript

Environment setup

Follow this guide to setup the environment for running React Native apps. Make sure to select the React Native CLI Quickstart tab since we don't use the Expo managed workflow.

Installation

Create a new React Native project using this template:

npx react-native init <ProjectName> --npm --template https://github.com/23g/boilerplate-app

In the project root, create .env files representing the different environments:

cp .env.example .env.production
cp .env.example .env.staging
cp .env.example .env.local

The ENV variable should contain the value 'production', 'staging' or 'local' respectively.

Then run:

npm install
npm run pod

Change the bundle identifiers and package names (per build flavor / Xcode scheme) to suit your project.

Finally, create an empty file named tailwind.json in the root directory.

Development

Run tailwind-rn in development mode:

npm run dev:tailwind

Start the metro bundler:

npm start

Building the app

iOS:

Select the desired scheme and device in Xcode and press Run.

Android

Build via Android Studio, or run one of the following commands to launch the app with a specific environment in mind:

npm run android:prod
npm run android:staging
npm run android:local