Flipper — Mobile App Debugging Platform by Meta

Introduction

Flipper is an extensible desktop debugging platform built by Meta for inspecting mobile apps running on iOS, Android, and React Native. It provides a plugin-based architecture that surfaces runtime data from connected devices through a unified desktop interface.

What Flipper Does

• Inspects network traffic with request/response details and timing
• Previews UI layout hierarchy and component properties in real time
• Browses on-device databases (SQLite, SharedPreferences, UserDefaults)
• Displays structured application logs with filtering
• Supports custom plugins for project-specific debugging workflows

Architecture Overview

Flipper consists of a desktop Electron application that communicates with mobile SDKs over a local socket connection. The mobile SDK embeds lightweight client plugins that serialize runtime data and send it to the desktop app. Each plugin runs in its own sandbox, and the architecture supports both first-party and community-built plugins via a standard API.

Self-Hosting & Configuration

• Download the desktop app from the Flipper GitHub releases page
• Integrate the mobile SDK into your iOS (CocoaPods) or Android (Gradle) project
• React Native projects add react-native-flipper and configure plugins in the native entry point
• Custom plugins are authored as npm packages following the Flipper plugin template
• Configure device connections via USB or Wi-Fi through the desktop settings panel

Key Features

• Plugin ecosystem with layout inspector, network debugger, database browser, and crash reporter
• Framework-agnostic mobile SDK for iOS, Android, and React Native
• Desktop application with hot-reloading plugin development support
• Supports both physical devices and emulators/simulators
• Extensible via community plugins or internal custom plugins

Comparison with Similar Tools

• React DevTools — focused on React component tree; Flipper covers network, databases, and native layers
• Charles Proxy — specializes in network debugging; Flipper adds layout and database inspection
• Reactotron — React Native-specific; Flipper also supports native iOS and Android apps
• Xcode Instruments — Apple-only profiling; Flipper is cross-platform with a plugin model
• Android Studio Profiler — Android-only; Flipper provides a unified interface across platforms

FAQ

Q: Does Flipper work with both iOS and Android simultaneously? A: Yes. The desktop app can connect to multiple devices at once, showing data from each in separate tabs.

Q: Is Flipper still maintained after Meta reduced its bundling with React Native? A: Flipper remains open source and functional as a standalone tool. The React Native team shifted default debugging to Chrome DevTools, but Flipper's plugin ecosystem continues to serve teams with custom inspection needs.

Q: Can I build custom Flipper plugins? A: Yes. Flipper provides a plugin development kit with TypeScript support and hot-reload for rapid iteration.

Q: Does Flipper work on Linux? A: Yes. Flipper desktop is available for macOS, Windows, and Linux.

Sources

• https://github.com/facebook/flipper
• https://fbflipper.com/docs/getting-started/