flutter_devlens 🔍

Hero Banner

Pub Version License: MIT Flutter

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
Logs Network

📦 Installation

Add flutter_devlens to your pubspec.yaml:

dependencies:
  flutter_devlens: ^0.1.3

Or run:

flutter pub add flutter_devlens

🛠️ Setup

1. Initialize

Call DevLens.initialize() in your main() function. This attaches the overlay to your app. By default, it only activates in Debug mode.

import 'package:flutter_devlens/flutter_devlens.dart';

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

2. Track Navigation (Optional)

Add DevLens.routeObserver to your MaterialApp to enable the Navigation Timeline:

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

3. Track Network (Dio) (Optional)

Add DevLensDioInterceptor to your Dio instance to enable the Network Inspector:

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.

Libraries

flutter_devlens