flutter_analytics_manager 1.0.0

flutter_analytics_manager: ^1.0.0 copied to clipboard

🎉 Initial Release #

Flutter Analytics Manager - A comprehensive, multi-provider analytics solution for Flutter applications.

✨ Features #

Core Analytics Interface

• Universal Analytics Interface: Clean, provider-agnostic analytics interface for consistent implementation across different analytics services
• Type-Safe Event Tracking: Strongly typed event tracking with custom properties and user identification
• User Properties Management: Comprehensive user property setting and management capabilities

Supported Analytics Providers

• Firebase Analytics: Full integration with Firebase Analytics including automatic screen tracking, custom events, and user properties
• Mixpanel Analytics: Complete Mixpanel integration with event tracking, user identification, and custom properties
• Multi-Provider Support: Simultaneously send analytics data to multiple providers with a single API call

Event Management

• Analytics Event Model: Structured event model with name, properties, and timestamp
• Event Type Enums: Predefined event types for common analytics scenarios (login, purchase, custom, etc.)
• Custom Properties: Support for custom event properties with flexible data types

User Management

• User Properties Model: Comprehensive user properties model with common fields (name, email, age, etc.)
• User Identification: Set user IDs and associate events with specific users
• User Property Updates: Update user properties across all configured analytics providers

Utilities & Helpers

• Analytics Utilities: Helper functions for common analytics operations
• Validation Helpers: Built-in validation for event names, properties, and user data
• Error Handling: Robust error handling with detailed logging and fallback mechanisms

Multi-Analytics Manager

• Unified Interface: Single interface to manage multiple analytics providers simultaneously
• Provider Management: Add, remove, and configure multiple analytics providers
• Batch Operations: Efficiently send events and user properties to all configured providers

🛠️ Technical Highlights #

• Clean Architecture: Follows interface-based design patterns for easy testing and maintenance
• Type Safety: Full type safety with proper null safety implementation
• Performance Optimized: Efficient batch processing and minimal overhead
• Framework Integration: Seamless integration with Flutter applications
• Extensible Design: Easy to add new analytics providers through the common interface

📦 Package Contents #

• Core analytics interface and implementations
• Firebase Analytics integration
• Mixpanel Analytics integration
• Event and user property models
• Utility functions and helpers
• Comprehensive example application

🚀 Getting Started #

// Initialize with multiple providers
final analyticsManager = MultiAnalyticsManager([
  FirebaseAnalyticsManager(),
  MixpanelAnalyticsManager(token: 'your-token'),
]);

// Track events
await analyticsManager.trackEvent(
  AnalyticsEvent(
    name: 'user_login',
    properties: {'method': 'email'},
  ),
);

// Set user properties
await analyticsManager.setUserProperties(
  UserProperties(
    userId: 'user123',
    email: 'user@example.com',
  ),
);

📱 Example Application #

• Complete example Flutter app demonstrating all features
• Analytics dashboard with real-time event tracking
• User profile management
• Settings configuration
• Multiple screen implementations

🧪 Testing #

• Comprehensive unit tests for all components
• Integration tests for provider implementations
• Example app for manual testing and validation

---

Note: This is the initial stable release of Flutter Analytics Manager. The package provides a solid foundation for analytics integration in Flutter applications with support for multiple providers and a clean, extensible architecture.