flutter_devlens 🔍

A premium, production-quality developer debugging toolkit for Flutter. Designed to feel like a high-end desktop devtool integrated directly into your mobile app.

✨ Why DevLens?

Most developer tools are cluttered or look like basic widget packages. DevLens is built for professional engineers who value both functionality and aesthetics. It provides a non-obtrusive, high-performance overlay with a beautiful glassmorphism interface.

🚀 Key Features

• 🌐 Network Inspector: Real-time Dio request/response tracking with collapsible payload inspection.
• 📝 Contextual Logger: Structured logging with severity levels (Info, Warn, Error) and millisecond timestamps.
• 🛣️ Navigation Timeline: Automatic tracking of route history to debug complex navigation flows.
• 📱 Device Metrics: Instant access to display dimensions, pixel ratios, and platform-specific metadata.
• 🎨 Elite UI: Modern dark-mode glassmorphism design with smooth 60fps animations.
• 🕹️ Draggable Overlay: A minimalist floating bubble that stays accessible but out of the way.

📸 Screenshots

Logs Panel	Network Inspector

📦 Installation

Add flutter_devlens to your pubspec.yaml:

dependencies:
  flutter_devlens: ^0.1.1

🛠️ Setup

1. Initialize

Call initialize() in your main() function. By default, it only activates in Debug mode.

void main() {
  DevLens.initialize();
  runApp(const MyApp());
}

2. Track Navigation

Add the DevLens.routeObserver to your MaterialApp:

MaterialApp(
  navigatorObservers: [DevLens.routeObserver],
  // ...
)

3. Track Network (Dio)

Add the DevLensDioInterceptor to your Dio instance:

final dio = Dio();
dio.interceptors.add(DevLensDioInterceptor());

🗺️ Roadmap

• State Inspector: Support for Provider, Riverpod, and Bloc.
• Storage Explorer: View SharedPreferences and Hive boxes.
• Feature Flags: Toggle remote config values on the fly.
• Performance Monitor: Real-time FPS and Memory usage graphs.

🤝 Contributing

Contributions are welcome! Check out our Contributing Guide.

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

---