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.