obsly_flutter 0.2.1

Advanced Flutter SDK for comprehensive user behavior analytics, UI event tracking, and automatic screenshot capture with debug tools.

Changelog

All notable changes to this project will be documented in this file.

The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.

0.2.1 - 2025-01-03

Fixed

• Fixed .gitignore patterns for Android gradle build artifacts
• Fixed setState warning in rules_helpers.dart debug component
• Removed erroneously tracked gradle cache files from repository

Changed

• Improved repository cleanliness for pub.dev publishing
• Enhanced code quality and linting compliance

0.2.0 - 2025-01-03

Added

• Advanced Flutter SDK for comprehensive user behavior analytics
• Automatic UI, navigation, network, console and crash capture
• Optional screenshot capture on UI and rage-click events
• Performance transactions and steps tracking
• Custom metrics (counter, gauge, histogram timer)
• Tags, context, session and user identification
• Rate limiting system with configurable limits per event type
• Request body and headers whitelist configuration
• Debug tools with overlay for development
• Comprehensive rules engine with JavaScript compatibility
• Multi-platform support (iOS, Android, Web, macOS)
• Automatic interceptors for HTTP requests, crashes, and UI events
• Screenshot capture with boundary management
• Session management with automatic rotation
• Storage system with Hive backend
• Device and app information collection
• Defensive wrapper ensuring stability

Features

• Initialization: Easy SDK setup with comprehensive configuration options
• App Wrapping: Required wrapper for global UI and navigation interception
• Configuration: Extensive config options matching JavaScript Browser SDK API
• Developer Methods: Complete API for session, client, and application management
• Rate Limiting: Configurable per-event-type rate limits with bucket system
• Request Monitoring: Whitelist-based request/response body and headers capture
• Debug Tools: Development overlay for event inspection and testing
• Rules Engine: JavaScript-compatible rules processing with Dart implementation
• Multi-platform: Cross-platform support with platform-specific optimizations

Technical

• Flutter >= 3.0.0 compatibility
• Dart >= 3.4.0 support
• Comprehensive test suite with >90% coverage
• Performance optimizations and memory management
• Defensive programming patterns preventing app crashes
• Modular architecture with clear separation of concerns

[Unreleased]

Planned

• Enhanced analytics dashboards
• Additional metric types
• Extended platform support
• Performance optimizations
• Documentation improvements

---

For more information about releases and migration guides, see our documentation.