justanalytics_flutter 0.1.0

Official Flutter SDK for JustAnalytics — crash reporting, performance monitoring, HTTP tracing, and analytics for Flutter apps.

justanalytics_flutter

Official Flutter SDK for JustAnalytics — crash reporting, performance monitoring, HTTP tracing, and analytics for Flutter apps.

Features

• Crash Reporting — Captures Flutter framework errors, platform errors, and uncaught async errors
• HTTP Tracing — Auto-instruments Dio and package:http requests with W3C traceparent propagation
• Navigation Tracking — Tracks screen transitions via NavigatorObserver
• Performance Monitoring — App startup time and screen render measurements
• Custom Events — Track business events with arbitrary properties
• Batched Transport — Efficient in-memory queue with periodic flush

Quick Start

import 'package:justanalytics_flutter/justanalytics_flutter.dart';

void main() {
  JustAnalytics.instance.init(JustAnalyticsOptions(
    siteId: 'your-site-id',
    apiKey: 'ja_sk_your_api_key',
    environment: 'production',
    release: '1.0.0',
  ));

  // Wrap your app to catch uncaught errors
  JustAnalytics.instance.runApp(
    const MyApp(),
  );
}

Manual Error Capture

try {
  await riskyOperation();
} catch (error, stackTrace) {
  JustAnalytics.instance.captureException(
    error,
    stackTrace,
    tags: {'module': 'checkout'},
  );
}

HTTP Instrumentation

Dio

final dio = Dio();
dio.interceptors.add(JustAnalyticsDioInterceptor());

package:http

final client = JustAnalyticsHttpClient(http.Client());
final response = await client.get(Uri.parse('https://api.example.com/data'));

Navigation Tracking

MaterialApp(
  navigatorObservers: [
    JustAnalyticsNavigationObserver(),
  ],
);

License

MIT