expo-community-flipper

Flipper Support for Expo Apps

Usage (Quick Guide)

1. Install the module along with react-native-flipper: yarn add expo-community-flipper react-native-flipper

2. Add expo-community-flipper configuration to the plugins section of your app.json, as per the examples below. You have the option to specify the version of Flipper and the pods that you want to use. In React Native, the Android SDK is derived from the main Flipper configuration.

If you don't specify anything, expo-community-flipper will default to the version of Flipper bundled with the version of React Native you're currently using.

Not sure what Flipper version you need? Check the Official Flipper Podfile if you are specifying all of Flipper's pods, or the latest version of react-native-flipper if you are just specifying a flipper version.

Configuration

Flipper (React Native Default Version)

{
  "expo": {
    "..."
    "plugins": [
      "expo-community-flipper"
    ]
  }
}

Flipper with a specific version

{
  "expo": {
    "..."
    "plugins": [
      ["expo-community-flipper", "0.123.0"]
    ]
  }
}

Flipper with all Pod dependencies included

note: Android uses the same version as specified in the primary Flipper pod and does not require additional configuration

{
  "expo": {
    "..."
    "plugins": [
      ["expo-community-flipper", {
        "Flipper": "0.123.0",
        "ios": {
          "Flipper-Folly": "2.6.10",
          "Flipper-RSocket": "1.4.3",
          "Flipper-DoubleConversion": "3.1.7",
          "Flipper-Glog": "0.3.9",
          "Flipper-PeerTalk": "0.0.4"
        }
      }]
    ]
  }
}

Verified Versions

The following Flipper versions were verified against EAS. If you have another working combination, open a ticket or PR. Thank you!

Expo SDK Version	Flipper
34	0.123.0
33	0.123.0

Testing

An /example directory is built with expo init example for each major SDK release with a default eas.json file. The plugin is directly linked using expo's filepath support for config plugins. You can run expo prebuild in the directory to verify the plugin is modifying build files appropriately.

example eas.json

{
  "cli": {
    "version": ">= 0.35.0"
  },
  "build": {
    "example": {
      "releaseChannel": "default",
      "channel": "default"
    }
  }
}

example app.json

{
  "expo": {
    "...": "... standard app.json entries ...",
    "plugins": [
      [
        "./../build/withFlipper",
        {
          "Flipper": "0.123.0",
          "ios": {
            "Flipper-Folly": "2.6.10",
            "Flipper-RSocket": "1.4.3",
            "Flipper-DoubleConversion": "3.1.7",
            "Flipper-Glog": "0.3.9",
            "Flipper-PeerTalk": "0.0.4"
          }
        }
      ]
    ]
  }
}