PrimoDev/ apps

IcarusWork in progress

A desktop app to run, inspect and debug React Native apps

  • macOS
  • iOS Simulator
  • Android
  • Free
  • Open source
View on GitHub

What is Icarus?

Icarus (RNStudio) is a desktop app that pulls the scattered parts of React Native debugging into one place: Metro, logs, network, component tree, storage, performance and navigation. It also has a bring-your-own-key Anthropic assistant that answers from the context it captured from your app.

There is no public release and no license in the repository yet. To run it, clone the repo, then use pnpm install and the desktop app's dev script (Electron) with Node 22 or newer.

What it does

  1. 01Detects the project, starts Metro and launches the app on a simulator
  2. 02Unified Metro, native and console logs with search and filters
  3. 03Network inspector with headers and opt-in request bodies
  4. 04React component tree with name search and props
  5. 05AsyncStorage and MMKV inspectors to list, read and delete keys
  6. 06Performance (JS heap, render hot-spots) and navigation inspectors
  7. 07BYOK AI assistant that redacts secrets before anything is sent
  8. 08iOS simulator plus Android device or emulator via adb

FAQ

How do I install Icarus?
There is no published installer yet. The pipeline builds a macOS .dmg from a tag, but the first public release is gated on design-partner validation. For now you can run it from source with Node 22+ and pnpm 9+.
Which platforms does it support?
The desktop app is Electron and currently targets macOS. It connects to the iOS simulator and to Android devices or emulators via adb. Windows is not a target yet.
What is the license?
The repository has no license yet.
How is it different from Flipper, Reactotron or React Native DevTools?
The goal is to put what those tools do separately into one window, built on Hermes' CDP protocol, and make that context available to an AI assistant. The AI is optional, uses your own key and shows the redacted payload before sending.
What is the project status?
In development, pre-1.0. Milestones M0 through M3 landed in July 2026, covering the inspectors, the AI assistant and Android support. The README still says planning phase, but the code and changelog show a working app.

Documentation

README from the lucianodiisouza/icarus repository, refreshed on every deploy.

"Fly next to the sun when doing ReactNative work."

A desktop application that aims to become the single place where developers run, inspect, debug, understand, and interact with their React Native applications.

Status: Planning (Phase 0). No application code yet — the current focus is building the project's foundation correctly.

Documentation

All planning and engineering documentation lives in docs/ — start there. Highlights:

Process

Plan before code; deliver incrementally (Milestone → Epic → Story → Task); every decision records its rationale; every uncertainty is a tracked Open Question. See the Contribution Guide.