Skip to main content

React Native App - Automatic Setup

Starting with React Native 0.62, after generating your project with react-native init, the Flipper integration is ready out of the box for debug builds:

  • Android - start the Flipper Desktop application and start your project using yarn android. Your application will appear in Flipper.
  • iOS - run pod install once in the ios directory of your project. After that, run yarn ios and start Flipper. Your application will show up in Flipper.

By default, the following plugins will be available:

  • Layout Inspector
  • Network
  • Databases
  • Images
  • Shared Preferences
  • Crash Reporter
  • React DevTools
  • Metro Logs

Additional plugins can be installed through the Plugin Manager.

To create your own plugins and integrate with Flipper using JavaScript, see the Building a React Native Plugin tutorial.

Using the latest Flipper SDK​

By default, React Native might ship with an outdated Flipper SDK. To make sure you are using the latest version, determine the latest released version of Flipper by running npm info flipper.

Latest version of Flipper requires react-native 0.69+! If you use react-native < 0.69.0, please, downgrade react-native-flipper to 0.162.0 (see this GitHub issue for details).

Android:

  1. Bump the FLIPPER_VERSION variable in android/gradle.properties, for example: FLIPPER_VERSION=0.179.0.
  2. Run ./gradlew clean in the android directory.

iOS:

react-native version => 0.69.0

  1. Call FlipperConfiguration.enabled with a specific version in ios/Podfile, for example: :flipper_configuration => FlipperConfiguration.enabled(["Debug"], { 'Flipper' => '0.159.0' }),.
  2. Run pod install --repo-update in the ios directory.

react-native version < 0.69.0

  1. Call use_flipper with a specific version in ios/Podfile, for example: use_flipper!({ 'Flipper' => '0.179.0' }).
  2. Run pod install --repo-update in the ios directory.

Manual Setup​

If you are not using a default React Native template or cannot use the upgrade tool, you can find instructions for how to integrate Flipper into your projects in the following guides: