flipper-common is a core utility package within the Facebook Flipper debugging platform, designed to provide shared functionalities and interfaces for `flipper-ui`, `flipper-server`, and Flipper plugins. It encapsulates common logic and types used across different components of the Flipper ecosystem, ensuring consistency and reducing code duplication. The package is currently at version 0.273.0 and maintains a rapid release cadence, often seeing multiple updates per month to align with the active development of the broader Flipper project. Its key differentiators lie in its deep integration within the Flipper architecture, serving as a foundational layer for building robust mobile (iOS/Android) and web/Node.js debugging plugins and server-side interactions, rather than being a general-purpose, standalone utility library.
npm install flipper-commonVerified import paths — ran on the pinned version, not inferred.
This quickstart demonstrates how to initialize and use core utilities like `Logger` and `Id` within a simulated Flipper plugin context, leveraging TypeScript types such as `FlipperClient` for illustrative purposes.
Review the Flipper main repository's `desktop/static/CHANGELOG.md` for specific breaking changes and migration steps before upgrading. Ensure your `flipper-common` version aligns with other `flipper-*` packages you are using.
For Flipper Zero development, refer to the Flipper Zero JavaScript SDK (e.g., `@flipperdevices/fz-sdk`) and documentation specific to that hardware platform.
Ensure your project is configured for ES Modules (e.g., `"type": "module"` in `package.json` or using `.mjs` files) and use `import { Logger } from 'flipper-common';` syntax. If truly stuck in CommonJS, you might need dynamic `import()` or a bundler to transpile.Always import symbols directly from the main package entry point: `import { Logger } from 'flipper-common';`. Do not attempt to import from `flipper-common/lib/Logger` or similar internal paths.Consult the official Flipper documentation or the package's type definitions (`.d.ts` files) to verify the correct names and availability of exported members. Flipper's internal nature means not all internal types or functions are exposed publicly.
No dependency data recorded yet.