Flocon is an advanced debugging and inspection tool built with Kotlin Multiplatform (KMP), designed to work seamlessly across Android and desktop environments.

Inspired from Flipper by Meta, while leveraging modern Kotlin multiplatform architecture for networking, databases, analytics, and UI data visualization.

It allows developers to connect a Kotlin Multiplatform or Android app to their computer and launch a desktop interface that can observe, inspect, and interact with the running app in real time — across shared Kotlin code and platform-specific implementations.

---

Getting Started

Since 2.0, the SDK is split into one module per feature: add the core and the plugins you need, each with its -no-op version for release builds.

debugImplementation("io.github.openflocon:flocon:LAST_VERSION")
releaseImplementation("io.github.openflocon:flocon-no-op:LAST_VERSION")

// for example, the network inspector with OkHttp
debugImplementation("io.github.openflocon:flocon-network-core:LAST_VERSION")
releaseImplementation("io.github.openflocon:flocon-network-core-no-op:LAST_VERSION")
debugImplementation("io.github.openflocon:flocon-okhttp-interceptor:LAST_VERSION")
releaseImplementation("io.github.openflocon:flocon-okhttp-interceptor-no-op:LAST_VERSION")

in your Application.kt

startFlocon(FloconContext(this)) {
    install(FloconNetwork)
    install(FloconDatabase) { room() }
    install(FloconAnalytics)
}

// then, anywhere in your app
Flocon.analyticsPlugin.log(AnalyticsEvent("button_clicked", "events"))

On desktop use FloconContext(appName, packageName), on iOS FloconContext().

Coming from 1.x? See the 👉 migration guide.

📖 Documentation

Visit the full documentation site for setup guides, feature details, and advanced usage:
👉 openflocon.github.io/Flocon/

Table of Contents

• 🚀 Getting Started
  • Migrating to 2.0
  • Installation Guide
  • Basic Usage
  • macOS Specifics
• 📡 Networking
  • HTTP Inspector
  • Request Mocking
  • GraphQL
  • gRPC
  • WebSockets
• 💾 Local Storage
  • Database Explorer (Room & SQLite)
  • Shared Preferences (Android)
• 🛠️ Advanced Debugging
  • Custom Dashboards
  • Dynamic Data Tables
  • Deeplink Launcher
  • File Explorer
  • Analytics Viewer
  • Feature Flags Viewer
  • Crash Reporter
  • Image Previewer
• 🤖 AI Agents (MCP) — let Claude Code, Cursor, Codex, Gemini CLI or Antigravity inspect your network calls, mock them, simulate a bad network, read your app files, analytics events, feature flags and databases
• ❓ Troubleshooting

---

✨ Features at a Glance

Feature	Android	KMP (JVM/iOS)
Network (HTTP/Mocking)	✅	✅
Database (Room/SQLite)	✅	✅
Preferences	✅	❌
Dashboards & Tables	✅	✅
Analytics & Images	✅	✅
Feature Flags	✅	✅
Deeplink & Files	✅	❌
AI Agents (MCP)	✅	✅

---

🧰 Requirements

• Android: Device/Emulator with USB debugging + ADB.
• KMP: a recent Kotlin version in your app (the SDK is built with Kotlin 2.4).
• Desktop: Flocon Desktop app (JVM-based).

For detailed platform-specific requirements, see the Setup Guide.

---

🤝 Contributors

Thanks to these amazing people for making Flocon better every day!

See all contributors

---

License

Flocon is MIT licensed, as found in the LICENSE file.