Skip to content
A desktop debugging platform for mobile developers.
Branch: master
Clone or download
jknoxville and facebook-github-bot Fix missing simulator bug
Apple has changed the xcrun api in some cases, it seems.
Adding support for true instead of YES...

Reviewed By: danielbuechele

Differential Revision: D15940810

fbshipit-source-id: 94ba2733527e005b989fb5a62ffbab2f7a0243b9
Latest commit fdd75a1 Jun 21, 2019
Type Name Latest commit message Commit time
Failed to load latest commit information.
.circleci Automate iOS release (#445) May 14, 2019
.github Add issue templates Apr 29, 2019
.vscode Initial commit 🎉 Jun 1, 2018
PortForwardingMacApp More copyright headers for misc stuff May 1, 2019
Specs Flipper Release: v0.20.0 Apr 17, 2019
android Add getTableInfo API to process incoming TableInfo queries Jun 20, 2019
docs Add docs for Fresco image attribution Jun 20, 2019
flow-typed Use mutex library instead of repeatedly chaining promises Jun 17, 2019
gradle Another round of header updates May 3, 2019
headless-tests Add sample app layout snapshot test Jun 12, 2019
headless Plugin name list Jun 17, 2019
iOS Add accessibilityIdentifier to iOS layout attributes Jun 18, 2019
libs Solve fbjni bug to allow catching Java exception in JNI Nov 19, 2018
scripts Rename uses of in fbsource Jun 17, 2019
src Fix missing simulator bug Jun 21, 2019
static keytar update node v70 Jun 14, 2019
website Add setup docs for Fresco/Images Jun 20, 2019
xplat Bump Folly dependency for Android (#463) Jun 12, 2019
.eslintignore Upgrading flow and fixing lint errors Feb 1, 2019
.eslintrc.js Declare prettier the winner Apr 5, 2019
.flowconfig Flow 100 Jun 3, 2019
.gitignore Ignore Podfile.lock (#297) Oct 21, 2018
.sonarhandles Initial commit 🎉 Jun 1, 2018
.travis.yml Build Android app on Travis (#430) May 2, 2019
.watchmanconfig Add .watchmanconfig to fix yarn start (#265) Sep 17, 2018
.yarnrc Initial commit 🎉 Jun 1, 2018 Create Apr 29, 2019
CNAME Update CNAME Jul 31, 2018 Initial commit 🎉 Jun 1, 2018 Update README w/TOC & link Contributing & MIT sections (#222) Aug 13, 2018 Create (#409) Apr 5, 2019
Flipper.podspec Flipper Release: v0.21.1 May 30, 2019
FlipperKit.podspec Flipper Release: v0.21.1 May 30, 2019
LICENSE Initial commit 🎉 Jun 1, 2018 Update (#465) Jun 12, 2019
build.gradle Upgrade to Fresco 2.0.0 Jun 13, 2019 Bump Kotlin to 1.3.31 (#462) Jun 10, 2019
gradlew Upgrade to Gradle 5.1.1 stable version (#357) Jan 23, 2019
package.json Bump React Devtools Jun 18, 2019
settings.gradle Update iOS license headers (and more) May 2, 2019
yarn.lock Bump React Devtools Jun 18, 2019

Flipper Build Status Android Maven Badge iOS

Flipper (formerly Sonar) is a platform for debugging mobile apps on iOS and Android. Visualize, inspect, and control your apps from a simple desktop interface. Use Flipper as is or extend it using the plugin API.


Table of Contents

Mobile development

Flipper aims to be your number one companion for mobile app development on iOS and Android. Therefore, we provide a bunch of useful tools including a log viewer, interactive layout inspector, and network inspector.

Extending Flipper

Flipper is built as a platform. In addition to using the tools already included, you can create your own plugins to visualize and debug data from your mobile apps. Flipper takes care of sending data back and forth, calling functions, and listening for events on the mobile app.

Contributing to Flipper

Both Flipper's desktop app and native mobile SDKs are open-source and MIT licensed. This enables you to see and understand how we are building plugins, and of course join the community and help improve Flipper. We are excited to see what you will build on this platform.

In this repo

This repository includes all parts of Flipper. This includes:

  • Flipper's desktop app built using Electron (/src)
  • native Flipper SDKs for iOS (/iOS)
  • native Flipper SDKs for Android (/android)
  • Plugins:
    • Logs (/src/device-plugins/logs)
    • Layout inspector (/src/plugins/layout)
    • Network inspector (/src/plugins/network)
    • Shared Preferences/NSUserDefaults inspector (/src/plugins/shared_preferences)
  • website and documentation (/website / /docs)

Getting started

Please refer to our Getting Started guide to set up Flipper.


  • macOS (Flipper works on Linux and Windows, too, but we only support macOS officially at the moment.)
  • node >= 8
  • yarn >= 1.5
  • iOS developer tools (for developing iOS plugins)
  • Android SDK and adb

Building from Source


Running from source

git clone
cd flipper
yarn start

NOTE: If you're on Windows, you need to use Yarn 1.5.1 until this issue is resolved.

Building standalone application

yarn build --mac --version $buildNumber

iOS SDK + Sample App

cd iOS/Sample
rm -f Podfile.lock
pod install --repo-update
open Sample.xcworkspace
<Run app from xcode>

You can omit --repo-update to speed up the installation, but watch out as you may be building against outdated dependencies.

Android SDK + Sample app

Start up an android emulator and run the following in the project root:

./gradlew :sample:installDebug


Find the full documentation for this project at

Our documentation is built with Docusaurus. You can build it locally by running this:

cd website
yarn start


See the CONTRIBUTING file for how to help out.


Flipper is MIT licensed, as found in the LICENSE file.

You can’t perform that action at this time.