Skip to content

Commit 89dd9f3

Browse files
feat: release v1.4.0 with clarity integration
Merge release/v1.4.0 with clarity integration, STMR logo, and modern lint rules
1 parent 66f2473 commit 89dd9f3

26 files changed

+661
-1384
lines changed

CHANGELOG.md

Lines changed: 31 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -5,6 +5,37 @@ All notable changes to this project will be documented in this file.
55
The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
66
and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
77

8+
## [1.4.0] - 2025-01-24
9+
10+
### Added
11+
- **🎥 Microsoft Clarity Integration**: Complete integration with official Clarity Flutter SDK for behavioral analytics
12+
- **EngineClarityConfig**: Configuration class for Microsoft Clarity with Project ID, User ID, and LogLevel support
13+
- **Masking Widgets**: `EngineMaskWidget` and `EngineUnmaskWidget` for protecting sensitive content
14+
- **Example App**: Complete example demonstrating Clarity integration with masking examples
15+
16+
### Enhanced
17+
#### Microsoft Clarity Features
18+
- **Session Recordings**: Automatic capture of user sessions for replay
19+
- **Heatmaps**: Visual representation of user interactions
20+
- **User Insights**: Automatic detection of rage taps, dead taps, excessive scrolling
21+
- **Auto-tracking**: Automatic capture of navigation and user interactions
22+
- **Zero Configuration Events**: No manual event logging needed - Clarity captures automatically
23+
24+
#### Architecture Updates
25+
- **EngineAnalyticsModel**: Added `clarityConfig` property for Clarity configuration
26+
- **EngineAnalytics**: Added `isClarityInitialized`
27+
- **Widget Exports**: Added Clarity masking widgets to widget exports
28+
- **Adapter Pattern**: Adapted Clarity's unique widget-based initialization to Engine Tracking architecture
29+
30+
### Dependencies
31+
- **clarity_flutter: ^1.0.0**: Official Microsoft Clarity Flutter SDK
32+
33+
### Technical Details
34+
- **Unique Implementation**: Clarity requires wrapping the app with ClarityWidget instead of static methods
35+
- **LogLevel Support**: Automatic production optimization (LogLevel.None in release builds)
36+
- **User ID Validation**: Base-36 format validation for Clarity user IDs
37+
- **Session Recording**: ~30 minutes for real-time viewing, ~2 hours for complete processing
38+
839
## [1.3.0] - 2025-01-23
940

1041
### Added

0 commit comments

Comments
 (0)