impaktfull/xrayLight logoxRay (inspector)

xRay (inspector)

A comprehensive Flutter debugging toolkit for inspecting network calls, logs, and key-value storage in development.

Disclaimer: This is a commercial package. To use this package, you need to have either a commercial xRay license or a free xRay Community License. The xRay macOS, iOS, and Android apps are the authorized UI clients for this library. For more details, please check the LICENSE file.

Architecture overview

Your Flutter app
       │
       ├── XRayNetworkInspector   ◄── XRayNetworkDioInterceptor
       ├── XRayLogInspector
       ├── XRaySharedPreferencesInspector
       └── XRaySecureStorageInspector
                        │
              XRayInspectorServer  (HTTP + WebSocket + UDP discovery)
                        │
                  xRay Inspector App / Web App

The inspector server runs inside your app and broadcasts data over HTTP/WebSocket. Connect to it using the xRay app or web app.

Design principles

  • No singletons — all dependencies are passed explicitly via constructors.
  • No disk I/O — all captured data lives in memory only.
  • Composable — add only the inspectors you need.

Quick links

Edit this page on GitHub
🚀 Quick Start