A comprehensive Flutter development toolkit that provides production-ready capabilities for logging, analytics, performance monitoring, and telemetry. Built with a Firebase-like architecture where all packages work locally by default, with optional cloud syncing through OpenTelemetry.
VooFlutter follows a plugin-based architecture similar to Firebase:
voo_core- Central initialization package (like Firebase Core)- Local packages - Work independently without cloud requirements
voo_telemetry- Optional cloud syncing via OpenTelemetry
The foundation package that provides:
- Central app initialization (like Firebase Core)
- Plugin registration system
- Shared utilities and base classes
- Multi-app support
Comprehensive local logging with:
- Persistent storage using Sembast
- Real-time filtering and search
- DevTools integration
- Network request logging
- Multiple log levels
Local analytics and user interaction tracking:
- Touch event capture
- Heat map generation
- Route-aware analytics
- Event logging
- User properties
Local performance monitoring:
- Custom performance traces
- Network performance metrics
- Dio interceptor integration
- Performance statistics
OpenTelemetry integration for cloud syncing:
- OTLP protocol support
- Traces, metrics, and logs
- Automatic batching
- Integration with other Voo packages
- Works with any OpenTelemetry backend
import 'package:voo_core/voo_core.dart';
import 'package:voo_logging/voo_logging.dart';
import 'package:voo_analytics/voo_analytics.dart';
import 'package:voo_performance/voo_performance.dart';
void main() async {
WidgetsFlutterBinding.ensureInitialized();
// Initialize Voo Core (like Firebase Core)
await Voo.initializeApp(
options: VooOptions.development(
appName: 'MyApp',
appVersion: '1.0.0',
),
);
// Initialize local packages
await VooLoggingPlugin.initialize();
await VooAnalyticsPlugin.initialize();
await VooPerformancePlugin.initialize();
// Use the packages - all data stays local
await VooLogger.info('App started');
await VooAnalyticsPlugin.instance.logEvent('app_opened');
runApp(MyApp());
}import 'package:voo_telemetry/voo_telemetry.dart';
void main() async {
// ... previous initialization code ...
// Add cloud syncing capability
await VooTelemetryPlugin.initialize(
endpoint: 'https://your-otlp-endpoint.com',
apiKey: 'your-api-key',
);
// Now all Voo packages automatically sync to the cloud
// while still maintaining local functionality
}- Similar to Firebase's modular approach
- Each package can be used independently
- Automatic plugin discovery and registration
- All packages work without internet connection
- Data persisted locally using Sembast
- No cloud dependency for core functionality
- Add cloud capabilities with one line of code
- OpenTelemetry standard compliance
- Works with any OTLP-compatible backend
- Real-time log monitoring
- Performance metrics visualization
- Analytics event tracking
- Network request inspection
- Battle-tested in production apps
- Comprehensive error handling
- Automatic cleanup and memory management
- Configurable retention policies
Add the packages you need to your pubspec.yaml:
dependencies:
# Core package (required)
voo_core: ^0.2.0
# Add the packages you need (all optional)
voo_logging: ^0.2.0
voo_analytics: ^0.2.0
voo_performance: ^0.2.0
# Add cloud syncing (optional)
voo_telemetry: ^0.2.0This project uses Melos for managing the monorepo.
# Install Melos globally
dart pub global activate melos
# Bootstrap the workspace
melos bootstrap# Run tests for all packages
melos run test_all
# Analyze all packages
melos run analyze
# Build DevTools extensions
melos run build_devtools_extension
# Run the example app
melos run run_example| Package | Version | Description |
|---|---|---|
| voo_core | 0.2.0 | Core foundation and plugin system |
| voo_logging | 0.2.0 | Local logging with DevTools |
| voo_analytics | 0.2.0 | Local analytics and heat maps |
| voo_performance | 0.2.0 | Local performance monitoring |
| voo_telemetry | 0.2.0 | Cloud syncing via OpenTelemetry |
The apps/voo_example directory contains a complete example demonstrating:
- Package initialization
- Local-only mode
- Cloud sync integration
- DevTools usage
- Performance monitoring
- Analytics tracking
Version 0.2.0 introduces a new architecture:
- voo_core no longer handles cloud syncing
- Each package works locally by default
- Cloud syncing moved to voo_telemetry
- Firebase-like initialization pattern
See the migration guide for detailed instructions.
Contributions are welcome! Please read our contributing guidelines before submitting PRs.
This project is licensed under the MIT License - see the LICENSE file for details.