Skip to content
Modular boilerplate for getting started with React Native 📱
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Type Name Latest commit message Commit time
Failed to load latest commit information.

npm version npm downloads


react-native init NewApp --template=vidatec && cd NewApp && node ./setup.js

Instructions in app/* directories.

Finishing Setup

Make sure you have detox, storybook and filament-cli on your machine. If you have these already then you can run setup.js.


Run node setup.js this will update the package.json so that it has the required updated scripts and values for the following dependencies.


Detox should be set up on your machine see Detox - Getting Started for more details on how to install it. At time of writing you will only need to do step one for iOS as the setup.js and the inital template setup take care of the remaining steps. Setting up for Android has become more involved. You will need to follow the detailed steps that are outlined here.

To run detox:

npm run detox_ios

npm run detox_android

Note you must have Genymotion installed to use detox on Android and you may have to update the device name. Once you have run your emulator you can get its device name by running adb devices.

In this template Detox uses Jest. End to end tests are in the ./e2e folder. A sample working test exists so run one of the above commands to see it in action.


This template uses storybook to edit components.

To use storybook go to ./index.js and comment out the line

import MainAppProvider from './app/index';

and uncomment

import Storybook from './storybook';

Save and reload your app to see the storybook view of the components.

Filament support

This repository supports Filament CLI when using the filament-rnvidatec package. Currently this repository is set to use filament-rnvidatec. The template installs the CLI and the package, and the setup.js script links it in the package.json file.

You'll be able to use filament commands to generate screens, components, network and redux controllers:

  • npx filament new component <componentName>
  • npx filament new screen <screenName>
  • npx filament new network <networkControllerName>
  • npx filament new redux <reduxName>

Testing and Linting

Testing is provided via Jest.

npm run test This will run jest in verbose mode.

npm run test_clear This will clear the jest cache.

npm run test_update This will update any snapshots you have used.

Tests are stored in ./__tests__. Jest matches on *.test.js this is because detox matches on the *.spec.js and confusions and errors will arise if they are not separate.

A sample working test exists so run npm run test to see it in action.

Linting is provided by Eslint

npm run lint will run the command eslint *.js ./ --fix.


Built on top of Andrew M + Jordan D's templates.

You can’t perform that action at this time.