Skip to main content

Desktop App

Flipper helps you debug in the following environments:

  • Android and iOS.
  • Web apps running in an emulator/simulator.
  • Connected physical development devices.
  • Your browser.

Flipper consists of two parts:

  • The desktop app.
  • The native mobile SDKs for Android and iOS, the client for JavaScript, or even a third-party client you could implement yourself or find on the web.

Once you start Flipper and launch an emulator/simulator or connect a device, you'll start to see the device logs (and any other device-level plugins that work with your device). Currently, there are no plugins available for web apps.

To see app-specific data, you need to integrate the Flipper SDK into your app (see the 'Adding Flipper to your app' within the 'Getting Started' section of the SideBar).

Installation

note

The desktop part of Flipper doesn't need a setup. Simply download the latest build for Mac, Linux or Windows and launch it.

If you're on macOS, you can run brew install --cask flipper to let homebrew manage installation and upgrades (simply run brew upgrade to upgrade when a new version is released, although it might take a few hours up to a day for the package to be upgraded on homebrew).

To work properly with mobile apps, Flipper requires the following:

  • Working installation of Android development tools
  • [Where applicable] Working installation of iOS development tools
  • OpenSSL binary on your $PATH. A compatible OpenSSL for Windows can be downloaded from slproweb.com or from Chocolatey with choco install openssl.

If you are hacking a JS app, you should be good to go without any extra dependencies installed.

rmation

[Experimental] Alternatively, it is possible to run a browser based version of Flipper directly from NPM by using npx flipper-server.

Troubleshooting

If you run into problems, take a look at the troubleshooting section. Failing that, check GitHub Issues.