Changed #

• Breadcrumbs on All Logs: Activity trail (breadcrumbs) are now attached to ALL log types, not just crash logs
  • Provides user activity context for general logs, analytics, errors, and performance logs
  • Helps debug any issue by seeing what the user was doing leading up to the logged event

Added #

• Structured Stack Traces: Stack traces are now parsed into structured frames using the stack_trace package.
  • New stackTraceElements field in log events contains parsed frames with file, line, column, method, and class
  • Dashboard displays clean, readable stack frames instead of raw text
  • Backwards compatible: raw stackTrace string still included for older dashboards
• Improved Crash Debugging: Cleaner stack traces with internal Dart frames filtered out via .terse

Added #

• Snooze for Optional Updates: New snoozeUpdate() method to suppress update prompts for 1-3 days when users skip optional updates.
• minVersion Tracking: VersionCheckResult now includes minVersion field for snooze tracking.
• Internal Update Analytics: Automatic tracking of update-related events:
  • update_check_completed - Logged on every checkVersion() call
  • update_prompted - Logged when an update is required (not snoozed)
  • update_snoozed - Logged when snoozeUpdate() is called
  • update_accepted - Logged when new acceptUpdate() method is called
• acceptUpdate() Method: New helper method to call before opening the store URL, ensuring the update acceptance event is captured.

Removed #

• TellingForceUpdateScreen: Removed built-in update screen widget. Developers now build their own UI and use checkVersion() + snoozeUpdate().

Fixed #

• Server Response: Backend now returns minVersion in version check response for proper snooze tracking.

Added #

• Remote Config Support: New checkVersion() API to check for app updates against backend rules.
• Force Update UI: New TellingForceUpdateScreen widget for plug-and-play update enforcement.
• Backend Integration: Direct integration with Telling Server's public version check endpoint.

Added #

• Batch-by-Size: Logs now auto-flush when buffer reaches 20 events for more responsive sending.
• Breadcrumbs: Automatic activity trail (max 20 events) captured and attached to crash logs for better debugging context.
• Lifecycle Events: Auto-logs first_open (new install), app_update (version change), and app_open (each launch).

Improved #

• Efficiency: Reduced unnecessary network calls with smarter batch flushing.
• Debugging: Crash logs now include breadcrumb trail showing user activity before the crash.

Fixed #

• Documentation: Updated README to reflect simplified LogType enum (4 types: general, analytics, crash, performance).

Added #

• Exception Capture: New captureException() method for reporting handled exceptions from try-catch blocks.

  try {
    await riskyOperation();
  } catch (e, stackTrace) {
    Telling.instance.captureException(
      error: e,
      stackTrace: stackTrace,
      context: 'checkout_flow',
    );
  }
  

• TellingTryCatch Mixin: Convenient wrapper for async operations with automatic error capture.

  class MyService with TellingTryCatch {
    Future<User?> fetchUser(String id) async {
      return tryRun(
        context: 'fetch_user',
        func: () async => await api.getUser(id),
        onError: (e, stack) => showToast('Failed'),
      );
    }
  }
  

• Exponential Backoff: Failed log submissions now retry with increasing delays (5s → 10s → 20s → 40s → 80s).
• Buffer Size Limits: Log buffer capped at 500 entries to prevent memory issues.

Changed #

• Named Parameters: captureException() and setUserProperty() now use named parameters for better readability.
• Improved Retry Logic: Logs are preserved across app sessions when network is unavailable.

Fixed #

• Log ID Collisions: Unique IDs now use microsecond precision + counter to prevent duplicates.
• Deduplication Consistency: SDK and server now use identical hash algorithms.
• Persisted Log Context: Reloaded logs now retain userId, deviceMetadata, and sessionId.

Improved #

• LogType Simplification: Reduced from 9 overlapping types to 4 clear types:
  • general (absorbs: log, error, network, security, custom)
  • analytics (absorbs: event)
  • crash (absorbs: exception)
  • performance
• Backward Compatibility: Old log types are automatically mapped to new types via LogTypeExtensions.fromString().

Performance #

• Network Efficiency: Added GZIP compression for log payloads > 1KB (~60-70% size reduction).
• Estimated ~85% reduction in log payload size for typical batches.

Added #

• Documentation: Comprehensive funnel tracking guide in README with examples and best practices.

Added #

• Documentation: Comprehensive funnel tracking guide in README with examples and best practices.

Changed #

• Funnel Analysis: Added required funnelName and stepName parameter to trackFunnel() method.

Changed #

• Timestamps: Updated to use UTC time consistently across all logging operations.

Added #

• Funnel Analysis: Added comprehensive funnel tracking capabilities for analyzing user conversion flows.

Changed #

• Documentation: Updated dashboard URL in README.

Added #

• Debug Logs Control: Added optional enableDebugLogs parameter to init() method.
  • Allows developers to explicitly control debug log output
  • Defaults to true in debug mode (kDebugMode), false in release mode
  • Can be set to false to disable debug logs even in debug builds

Improved #

• Developer Experience: Better control over console output during development.

Added #

• Debug Logs Control: Added optional enableDebugLogs parameter to init() method.
  • Allows developers to explicitly control debug log output
  • Defaults to true in debug mode (kDebugMode), false in release mode
  • Can be set to false to disable debug logs even in debug builds

Improved #

• Developer Experience: Better control over console output during development.

Improved #

• Developer Experience: Better control over console output during development.

Added #

• Debug Logs Control: Added optional enableDebugLogs parameter to init() method.
  • Allows developers to explicitly control debug log output
  • Defaults to true in debug mode (kDebugMode), false in release mode
  • Can be set to false to disable debug logs even in debug builds

Improved #

• Developer Experience: Better control over console output during development.

Added #

• Debug Logs Control: Added optional enableDebugLogs parameter to init() method.
  • Allows developers to explicitly control debug log output
  • Defaults to true in debug mode (kDebugMode), false in release mode
  • Can be set to false to disable debug logs even in debug builds

Improved #

• Developer Experience: Better control over console output during development.

Added #

• Example: Added initial Flutter example project with platform configurations.
• Session Management: Implemented session timeout logic based on app lifecycle state changes.

Improved #

• Lifecycle: Refined app lifecycle observer for better session tracking.

Changed #

• API: Removed rate_limiter export to simplify public API.

Improved #

• General: Minor fixes and improvements.

Fixed #

• Documentation: Updated README installation instructions to reflect the correct version.

Improved #

• Error Logging: Sanitized network error messages to be less revealing and more user-friendly.

Changed #

• Internal: Updated backend API URL to point to the new server instance.

Improved #

• Documentation: Enhanced README with improved structure and clarity
  • Refined feature descriptions and usage examples
  • Better organization of sections

Improved #

• Documentation: Added "Get Your API Key" section to README
  • Clear instructions on how to obtain API keys from the dashboard
  • Added direct link to the Telling Dashboard

Improved #

• Streamlined Documentation: Simplified README for better clarity
  • Removed verbose sections to focus on core features
  • Cleaner, more concise documentation
• Updated Contact Information: Updated support email and author details

Changed #

• Production-Safe Logging: All debug print statements now wrapped with kDebugMode checks
  • Debug logs are automatically stripped from release builds (tree-shaken)
  • Zero performance overhead in production
• Simplified API: Removed configurable rate limiting and baseUrl parameters
  • Rate limiting now uses optimal fixed values (5s deduplication, 5s crash throttle, 10 logs/sec)
  • Backend URL is now fixed internally
  • Cleaner, simpler initialization - just provide your API key

Improved #

• Documentation: Comprehensive README with 600+ lines covering all features
  • Added widget tracking extension documentation
  • Included best practices and troubleshooting sections
  • Added performance benchmarks and optimization details

Initial Release #

Features

• Automatic Crash Reporting: Catch and report unhandled Flutter errors and platform errors
• Manual Logging: Support for multiple log levels (debug, info, warning, error, fatal)
• Event Tracking: Track analytics events with custom properties
• Session Management: Automatic session tracking with start/end events
• Screen Tracking: Built-in NavigatorObserver for automatic screen view tracking
• User Context: Set and track user information across logs
• Device Metadata: Automatic collection of platform, OS, device, and app information
• Rate Limiting: Smart deduplication and throttling to prevent log spam
• Offline Support: Buffer logs when offline and send when connection is restored
• Batch Sending: Efficient batching of logs to reduce network requests

Supported Platforms

• ✅ iOS
• ✅ Android
• ✅ Web
• ✅ macOS
• ✅ Windows
• ✅ Linux

Log Types

• General logs
• Analytics events
• Crashes
• Network tracking
• Performance monitoring

Configuration

• Customizable rate limiting
• Adjustable deduplication window
• Configurable crash throttling
• Custom base URL support