https://github.com/openflocon/flocon
A powerful desktop companion for Android apps — inspect, debug, mock and control your app in real time. Supports OkHttp, GraphQl, GRPC
https://github.com/openflocon/flocon
android apollo database flipper graphql grpc http interceptor kmp ktor mock network okhttp sharedpreferences
Last synced: 23 days ago
JSON representation
A powerful desktop companion for Android apps — inspect, debug, mock and control your app in real time. Supports OkHttp, GraphQl, GRPC
- Host: GitHub
- URL: https://github.com/openflocon/flocon
- Owner: openflocon
- License: mit
- Created: 2025-07-29T19:07:48.000Z (6 months ago)
- Default Branch: main
- Last Pushed: 2025-08-28T17:45:53.000Z (5 months ago)
- Last Synced: 2025-08-28T19:37:52.898Z (5 months ago)
- Topics: android, apollo, database, flipper, graphql, grpc, http, interceptor, kmp, ktor, mock, network, okhttp, sharedpreferences
- Language: Kotlin
- Homepage:
- Size: 8.95 MB
- Stars: 196
- Watchers: 0
- Forks: 7
- Open Issues: 19
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
**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](https://github.com/facebook/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
`This library is lightweight, contributing just 140KB to the overall app size`
in your module .kts
[](https://search.maven.org/artifact/io.github.openflocon/flocon)
```
debugImplementation("io.github.openflocon:flocon:LAST_VERSION")
releaseImplementation("io.github.openflocon:flocon-no-op:LAST_VERSION")
```
in your `Application.kt`
```kotlin
// android initialization
Flocon.initialize(this)
// desktop / ios
Flocon.initialize()
```
```toml
[versions]
flocon = "LASTEST_VERSION"
[libraries]
flocon = { module = "io.github.openflocon:flocon", version.ref = "flocon" }
```
## 📖 Documentation
Visit the full documentation site for setup guides, feature details, and advanced usage:
👉 **[openflocon.github.io/Flocon/](https://openflocon.github.io/Flocon/)**
### Table of Contents
- 🚀 **[Getting Started](https://openflocon.github.io/Flocon/setup)**
- [Installation Guide](https://openflocon.github.io/Flocon/setup#installation)
- [Basic Usage](https://openflocon.github.io/Flocon/setup#usage)
- [macOS Specifics](https://openflocon.github.io/Flocon/macos-install)
- 📡 **[Networking](https://openflocon.github.io/Flocon/network)**
- [HTTP Inspector](https://openflocon.github.io/Flocon/network#📡-network-request-inspector)
- [Request Mocking](https://openflocon.github.io/Flocon/network#🎭-http-request-mocking)
- [GraphQL](https://openflocon.github.io/Flocon/graphql)
- [gRPC](https://openflocon.github.io/Flocon/grpc)
- [WebSockets](https://openflocon.github.io/Flocon/websocket)
- 💾 **[Local Storage](https://openflocon.github.io/Flocon/database)**
- [Database Explorer (Room & SQLite)](https://openflocon.github.io/Flocon/database)
- [Shared Preferences (Android)](https://openflocon.github.io/Flocon/sharedpref)
- 🛠️ **[Advanced Debugging](https://openflocon.github.io/Flocon/dashboard)**
- [Custom Dashboards](https://openflocon.github.io/Flocon/dashboard)
- [Dynamic Data Tables](https://openflocon.github.io/Flocon/table)
- [Deeplink Launcher](https://openflocon.github.io/Flocon/deeplink)
- [File Explorer](https://openflocon.github.io/Flocon/files)
- [Analytics Viewer](https://openflocon.github.io/Flocon/analytics)
- [Image Previewer](https://openflocon.github.io/Flocon/image)
- ❓ **[Troubleshooting](https://openflocon.github.io/Flocon/troubleshooting)**
---
## ✨ Features at a Glance
| Feature | Android | KMP (JVM/iOS) |
|---|:---:|:---:|
| **Network (HTTP/Mocking)** | ✅ | ✅ |
| **Database (Room/SQLite)** | ✅ | ✅ |
| **Preferences** | ✅ | ❌ |
| **Dashboards & Tables** | ✅ | ✅ |
| **Analytics & Images** | ✅ | ✅ |
| **Deeplink & Files** | ✅ | ❌ |
---
## 🧰 Requirements
- **Android**: Device/Emulator with USB debugging + ADB.
- **KMP**: Kotlin 2.0.0+ in your app.
- **Desktop**: Flocon Desktop app (JVM-based).
For detailed platform-specific requirements, see the [Setup Guide](https://openflocon.github.io/Flocon/setup).
---
## 🤝 Contributors
Thanks to these amazing people for making Flocon better every day!
[See all contributors](https://openflocon.github.io/Flocon/contributors)
---
## License
Flocon is MIT licensed, as found in the [LICENSE](/LICENSE) file.