HTTP traffic inspector with overlay UI: captures full request/response details (headers, body, status, timing), searchable color-coded list, shake-to-open panel, zero runtime cost when disabled.
A Kotlin Multiplatform Ktor HTTP traffic inspector with a Compose Multiplatform UI. Shake the device to open the inspector overlay. Zero overhead in release builds.
This is a Kotlin Multiplatform library targeting Android and iOS.
./gradlew :library:publishToMavenLocal
./gradlew :library:allTests
enable()| Minimum | |
|---|---|
| Android | API 24 |
// app/build.gradle.kts
dependencies {
debugImplementation("io.github.hazemafaneh:network-inspection-pro:0.1.0")
}
// shared/build.gradle.kts
kotlin {
listOf(
iosArm64(),
iosSimulatorArm64()
).forEach { iosTarget ->
iosTarget.binaries.framework {
baseName = "shared"
isStatic = true
export("io.github.hazemafaneh:network-inspection-pro:0.1.0") // (1)
}
}
sourceSets {
commonMain.dependencies {
api("io.github.hazemafaneh:network-inspection-pro:0.1.0") // (2)
}
androidMain.dependencies {
implementation("io.ktor:ktor-client-okhttp:3.1.3")
}
iosMain.dependencies {
implementation("io.ktor:ktor-client-darwin:3.1.3")
}
}
}
(1)
export()includes the library symbols in the generated.frameworkso Swift can importNetworkInspectionProdirectly. (2)api()instead ofimplementation()is required for the to take effect.
Add NetworkInspectorPlugin when building your HttpClient. This is what captures every request and response.
import io.github.hazemafaneh.networkinspectionpro.NetworkInspectorPlugin
import io.ktor.client.HttpClient
import io.ktor.client.plugins.contentnegotiation.ContentNegotiation
import io.ktor.serialization.kotlinx.json.json
val client = HttpClient {
install(NetworkInspectorPlugin)
install(ContentNegotiation) {
json()
}
}
NetworkInspectorOverlay renders your UI untouched. When enabled and the device is shaken, the inspector panel slides in over your content.
Android
import io.github.hazemafaneh.networkinspectionpro.internal.ui.NetworkInspectorOverlay
class MainActivity : ComponentActivity() {
override fun onCreate(savedInstanceState: Bundle?) {
super.onCreate(savedInstanceState)
setContent {
NetworkInspectorOverlay {
App()
}
}
}
}
iOS (KMP shared module)
import androidx.compose.ui.window.ComposeUIViewController
import io.github.hazemafaneh.networkinspectionpro.internal.ui.NetworkInspectorOverlay
fun MainViewController() = ComposeUIViewController {
NetworkInspectorOverlay {
App()
}
}
The library is opt-in — it does nothing until you call enable(). This lets you include it in all build types and only turn it on in debug.
Android — call init(context) in your Application
init() stores the application context (needed for shake detection) and calls enable() internally.
import io.github.hazemafaneh.networkinspectionpro.NetworkInspectionPro
import io.github.hazemafaneh.networkinspectionpro.init
class MyApp : Application() {
override fun onCreate() {
super.onCreate()
if (BuildConfig.DEBUG) {
NetworkInspectionPro.init(this)
}
}
}
iOS — call enable() from your SwiftUI App
import SwiftUI
import shared // your KMP framework name
@main
struct iOSApp: App {
init() {
#if DEBUG
NetworkInspectionPro.shared.enable()
#endif
}
var body: some Scene {
{
()
}
}
}
Once set up, make HTTP requests normally through your Ktor client. Then shake the device to open the inspector. You will see a list of all captured requests. Tap any entry to view full request/response details including headers, body, and timing.
Shake again (or press the back button) to dismiss the overlay.
Do not call init(context) (Android) or enable() (iOS) in release builds.
When disabled:
NetworkInspectorPlugin skips all work on every request — no allocations, no storage.NetworkInspectorOverlay renders only your content, adding no overhead.Learn more about Kotlin Multiplatform
Copyright 2025 Hazem Afaneh
Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance the License.
You may obtain a copy of the License at
https:
Unless applicable law agreed to writing, software
distributed under the License distributed an BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express implied.
See the License the specific language governing permissions
limitations under the License.
| iOS | iOS 14 |
| Kotlin | 2.1.21 |
| Ktor | 3.1.3 |
| Compose Multiplatform | 1.8.1 |
export()Surfaced from shared tags and platforms — no rankings paid for.