http_inspect_view

A debug-only HTTP inspector for Flutter apps. Intercepts every Dio request/response, shows OS notifications per request, and lets you shake the device to open a full log viewer — with no widget wrapper required.

Active only in debug and profile builds. Completely silent in release.

---

Features

• 🔌 Zero-widget setup — just add the Dio interceptor
• 📋 Full log viewer — method, status, headers, request & response body, duration
• 🔔 OS notifications per request (tap to open the inspector)
• 📳 Shake-to-open the log viewer at any time
• 🔗 Share logs as cURL, plain text, or JSON
• 🔍 Search & filter by URL or HTTP method
• 🔎 In-tab search — search, highlight, and jump through matches in headers and body
• ⚗️ Try Request — edit any logged request and re-send it directly from the inspector

---

Platform setup

iOS

1 — AppDelegate.swift

import Flutter
import UIKit
import flutter_local_notifications

@main
@objc class AppDelegate: FlutterAppDelegate {
  override func application(
    _ application: UIApplication,
    didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?
  ) -> Bool {
    GeneratedPluginRegistrant.register(with: self)
    UNUserNotificationCenter.current().delegate = self as? UNUserNotificationCenterDelegate
    // Required for flutter_local_notifications background isolate
    FlutterLocalNotificationsPlugin.setPluginRegistrantCallback { registry in
      GeneratedPluginRegistrant.register(with: registry)
    }
    return super.application(application, didFinishLaunchingWithOptions: launchOptions)
  }
}

2 — Info.plist

Add the motion permission for shake-to-open:

<key>NSMotionUsageDescription</key>
<string>This app uses motion sensors to open the HTTP inspector by shaking the device.</string>

---

Android

AndroidManifest.xml

Add the notification permission for Android 13+ (API 33+):

<!-- Required for local notifications on Android 13+ -->
<uses-permission android:name="android.permission.POST_NOTIFICATIONS"/>

---

Usage

1 — Add the Dio interceptor

import 'package:http_inspect_view/http_inspect_view.dart';

dio.interceptors.add(
  HttpInspectorInterceptor(
    // Pass a getter — evaluated at tap/shake time, not at DI setup time.
    // This avoids a stale reference if NavigationService.navigatorKey is
    // reassigned to AppRouterConfig.navigatorKey after runApp().
    navigatorKey: () => NavigationService.navigatorKey,
  ),
);

Disable notifications but keep shake-to-open:

dio.interceptors.add(
  HttpInspectorInterceptor(
    navigatorKey: () => NavigationService.navigatorKey,
    showNotification: false,
  ),
);

2 — Optional: HttpInspector widget

Wrap your root widget if you need explicit hot-reload safety or lifecycle control. Not required for normal use — the interceptor starts everything automatically.

HttpInspector(
  navigatorKey: () => NavigationService.navigatorKey,
  child: MyApp(),
)

---

How it works

Trigger	Behaviour
Every request completes	OS notification appears (tap to open inspector)
Shake the device	Inspector list slides up as a fullscreen dialog
Tap any log entry	Full detail view: Overview · Request · Response tabs
🔍 icon in detail page	Animated search bar slides in — highlights & navigates matches in headers and body
⚗️ icon in detail page	Opens Try Request: edit method, URL, headers, body and send — result shown inline and logged to the list
Share button	cURL command · full text · JSON export

---

Try Request

The Try Request screen lets you replay and modify any captured request without leaving the app:

• Pre-filled from the tapped log entry (method, full URL, all headers, body)
• Change any field — switch method via the colored badge dropdown, edit headers row-by-row (add / remove), rewrite the body in a dark code editor
• Tap Send — the request fires immediately and:
  • The response appears inline (status badge, duration, pretty-printed JSON body or error)
  • The request is added to the inspector list as a normal entry — tap it to view full details, share, or try again

---

Additional information

• All data is stored in memory only — cleared when the app restarts.
• To clear logs at runtime, tap the 🗑 button in the inspector list.
• The inspector is a no-op in release builds — no tree-shaking required.