ispect 4.1.3-dev12
ispect: ^4.1.3-dev12 copied to clipboard
A Handy Toolkit for Mobile App Debugging. ISpect is a simple yet versatile library inspired by web inspectors, tailored for mobile application development.
π Overview #
ISpect is the main debugging and inspection toolkit designed specifically for Flutter applications.
π Real-time Monitoring β’ π Debugging β’ π Inspection β’ β‘ Performance Tracking
ISpect empowers Flutter developers with a suite of debugging tools that seamlessly integrate into your development workflow. From monitoring HTTP requests in real-time to tracking performance metrics and managing application state, ISpect provides an intuitive interface that makes debugging efficient and insightful.
π― Key Features #
- π Network Monitoring: Detailed HTTP request/response inspection with error tracking
- π Comprehensive Logging: Advanced logging system with categorization and filtering
- β‘ Performance Analysis: Real-time performance metrics and monitoring
- π UI Inspector: Widget hierarchy inspection with color picker and layout analysis
- π± Device Information: System and app metadata collection
- π Bug Reporting: Integrated feedback system with screenshot capture
- ποΈ Cache Management: Application cache inspection and management
β¨ Features #
π Network Inspection #
- Real-time HTTP request/response monitoring
- Detailed request headers, body, and parameters
- Response data with status codes and timing
- Error logging with stack traces
- Support for both Dio and standard HTTP clients
π Advanced Logging #
- Structured log categorization (info, debug, warning, error)
- Custom log types with color coding
- Real-time log filtering and search
- Export functionality for logs
- BLoC event and state change tracking
π― UI Development Tools #
- Widget inspector with hierarchy visualization
- Color picker for design consistency
- Layout analysis and debugging
- Performance overlay with FPS monitoring
- Screenshot capture with annotation tools
π± Device & Environment Info #
- Device specifications and capabilities
- Application metadata and build information
- Cache usage monitoring and management
- System resource utilization
π Bug Reporting #
- Integrated feedback system
- Screenshot capture with drawing tools
- Automatic device and app context collection
- Jira integration for ticket creation
π Internationalization #
- Support for 12 languages: English, Russian, Kazakh, Chinese, Spanish, French, German, Portuguese, Arabic, Korean, Japanese, Hindi
- Extensible localization system
π± Interface Preview #










π¦ Installation #
Add ispect to your pubspec.yaml
:
dependencies:
ispect: ^4.1.3
π Quick Start #
import 'package:ispect/ispect.dart';
import 'package:ispectify/ispectify.dart';
void main() {
// Initialize ISpectify for logging
final ispectify = ISpectify();
// Wrap your app with ISpect
ISpect.run(
() => runApp(MyApp()),
ispectify: ispectify,
);
}
class MyApp extends StatelessWidget {
@override
Widget build(BuildContext context) {
return ISpectScopeWrapper(
child: MaterialApp(
// Add ISpect to your app
builder: (context, child) => ISpectBuilder(
child: child ?? const SizedBox.shrink(),
),
// Add navigation observer
navigatorObservers: [
ISpectNavigatorObserver(),
],
home: HomePage(),
),
);
}
}
βοΈ Advanced Configuration #
π¨ Custom Theming #
ISpectScopeWrapper(
theme: ISpectTheme(
logColors: {
'custom-log': Colors.purple,
},
logIcons: {
'http-request': Icons.send,
'http-response': Icons.receipt,
},
),
child: MaterialApp(/* ... */),
)
ποΈ Panel Customization #
ISpectScopeWrapper(
options: ISpectOptions(
panelButtons: [
('Custom Action', Icons.star, () {
// Custom action
}),
],
),
child: MaterialApp(/* ... */),
)
πΊοΈ Router Integration (GoRouter) #
For GoRouter, add a listener to track route changes:
_router.routerDelegate.addListener(() {
final location = _router.routerDelegate
.currentConfiguration.last.matchedLocation;
ISpect.route(location);
});
π Examples #
Complete example applications are available in the example/ directory demonstrating core functionality.
ποΈ Architecture #
ISpect is built as a modular system with specialized packages:
π€ Contributing #
Contributions are welcome! Please read our contributing guidelines and submit pull requests to the main branch.
π License #
This project is licensed under the MIT License - see the LICENSE file for details.
π Related Packages #
- ispectify - Foundation logging system
- ispectify_dio - Dio HTTP client integration
- ispectify_http - Standard HTTP client integration
- ispectify_bloc - BLoC state management integration
- ispect_jira - Jira ticket creation integration