DEV Community

Cover image for Starting React Native Project in 2022
Vladimir Vovk
Vladimir Vovk

Posted on • Updated on

Starting React Native Project in 2022

There are many ways to start new React Native project. Here we will be using Expo CLI because it's easier and it has nice defaults out of the box. Also, we will add TypeScript, ESLint, Prettier, and some custom configurations that will make our development process better.

TLDR You can use one command expo init --template @vladimir-vovk/expo-bare-typescript to create new React Native project with all tools already setup for you (see README for details) or follow instructions below. 🤓

Please refer to official React Native and Expo documentation for more details. 🤩

General setup

We will need several tools before we start.

  1. Node.js.
  2. Git.
  3. Yarn.

Then install Expo CLI with npm install --global expo-cli or yarn global add expo-cli.

Awesome! 👍🏻 Now we have two options to start new React Native project with Expo CLI: "managed workflow" and "bare workflow". Let's briefly look into each variant further. For more in depth comparison please read the official Expo doc.

Managed workflow

Managed workflow is the easiest way. Use it if you are new to mobile development and want to start developing your project right away without spending much time on setup and learning how to build native binaries for iOS and Android.

  1. Run expo init command.
  2. Type your project name.
  3. Choose blank (TypeScript) template.
  4. Change directory to your project: cd <your-project-name>.
  5. yarn start to start Metro Bundler.
  6. Press i to start the iOS simulator or a to run the Android emulator.

Bare workflow

Use bare workflow if you are already familiar with mobile development or want to use some libraries (native code) that is not supported by Expo.

  1. Run expo init command.
  2. Type your project name.
  3. Choose minimal template.
  4. Change directory to your project: cd <your-project-name>.
  5. Start Metro Bundler with yarn start.

Check React Native Setup Guide to ensure that everything that needed to build binaries is installed on your machine.

Use yarn ios or yarn android commands to build and run the app on the iOS simulator or Android emulator.📱

Tools

TypeScript

Let's add TypeScript support.

  1. Create an empty tsconfig.json file in your project root: touch tsconfig.json.
  2. Rename App.js to App.tsx: mv App.js App.tsx.
  3. Run yarn start. It will prompt you to install the required dependencies (typescript, @types/react, @types/react-native), and automatically configure your tsconfig.json.

Absolute path imports

To use absolute path imports, e.g. import { ComponentA } from 'src/components/A' (notice path starts with src), we need to add baseUrl and paths parameters to tsconfig.json.

{
  ...
  "baseUrl": "./",
  "paths": {
    "src/*": ["src/*"]
  }
  ...
}
Enter fullscreen mode Exit fullscreen mode

Also we need to create src/package.json file.

{
  "name": "src"
}
Enter fullscreen mode Exit fullscreen mode

Also, we will need to install the babel-plugin-module-resolver to be able to run our project on web.

☝🏻 You can safely skip it, if you targeting only mobile platforms.

yarn add --dev babel-plugin-module-resolver
Enter fullscreen mode Exit fullscreen mode

Specify the plugin configuration in babel.config.js:

module.exports = function(api) {
  api.cache(true);
  return {
    // ... presets settings goes here
    plugins: [
      [
        'module-resolver',
        {
          root: ['.'],
          alias: {
            src: './src'
          }
        }
      ],
    ]
  };
};
Enter fullscreen mode Exit fullscreen mode

Move App.tsx to src folder

It's good to have all source files in one folder. So let's move App.tsx to src with mv App.tsx src command.

Next we need to fix import inside index.js.

...
import App from 'src/App'
...
Enter fullscreen mode Exit fullscreen mode

Prettier

Prettier is an opinionated code formatter. Let's install it with npm install --save-dev prettier or yarn add -D prettier. We will also need .prettierrc.js config file in the project root.

module.exports = {
  semi: false,
  trailingComma: 'none',
  singleQuote: true,
  printWidth: 100,
  tabWidth: 2,
  useTabs: false,
}
Enter fullscreen mode Exit fullscreen mode

Remove React imports

Starting from React 17 it's now not necessary to import React to use JSX. To be able to use this new feature we need to update babel.config.js (line 4).

module.exports = function(api) {
  api.cache(true);
  return {
    presets: [['babel-preset-expo', { jsxRuntime: 'automatic' }]]
    // ... plugins settings goes here
  };
};
Enter fullscreen mode Exit fullscreen mode

And restart Metro Bundler. Press Ctrl-C to stop it and run yarn start to start Metro Bundler again.

Check code for errors

We can use TypeScript compiler and ESLint for this.

TypeScript Compiler

Let's add new check-typescript script to our package.json.

...
"scripts": {
  ...
  "check-typescript": "tsc --noEmit"
},
...
Enter fullscreen mode Exit fullscreen mode

Now we can run yarn check-typescript command to check our code for errors with TypeScript compiler.

ESLint

ESLint has a lot configuration options and rules. Let's start with Expo eslint-config-universe package.

yarn add --dev eslint-config-universe
yarn add --dev eslint prettier @typescript-eslint/eslint-plugin @typescript-eslint/parser
yarn add --dev eslint-plugin-react-hooks
yarn add --dev eslint-import-resolver-typescript
Enter fullscreen mode Exit fullscreen mode

Add .eslintrc.js config file to the project root.

module.exports = {
  extends: ['universe', 'universe/shared/typescript-analysis', 'plugin:react-hooks/recommended'],
  overrides: [
    {
      files: ['*.ts', '*.tsx', '*.d.ts'],
      parserOptions: {
        project: './tsconfig.json'
      }
    }
  ],
  settings: {
    'import/resolver': {
      typescript: {} // this loads <rootdir>/tsconfig.json to ESLint
    }
  }
}

Enter fullscreen mode Exit fullscreen mode

Add new check-eslint script to our package.json.

...
"scripts": {
  ...
  "check-eslint": "eslint './src/**/*{js,ts,jsx,tsx}'"
},
...
Enter fullscreen mode Exit fullscreen mode

Now we can run yarn check-eslint command to check our code for errors with ESLint. And yarn check-eslint --fix to fix errors automatically.

Lint script

Let's combine TypeScript and ESLint checks together so we can run both at once.

Add new lint script to our package.json.

...
"scripts": {
  ...
  "lint": "yarn check-typescript && yarn check-eslint"
},
...
Enter fullscreen mode Exit fullscreen mode

What to add next?


Post your favourite tools in comments, press 💖 button and happy hacking! 🙌🏻

Discussion (0)