Respectlytics Flutter SDK #

Official Respectlytics SDK for Flutter. Privacy-first analytics that respects your users.

Features #

• 🔒 No device identifiers - No IDFA, GAID, or fingerprinting
• 🎲 Random user IDs - Not linked to device or personal data
• 🗑️ Auto-cleanup - Uninstall clears all data
• 📱 Cross-platform - iOS, Android, macOS, Linux, Windows
• ⚡ Offline-first - Events queue and sync when online
• 💾 Never lose events - Persisted immediately, survives crashes

Installation #

Add to your pubspec.yaml:

dependencies:
  respectlytics_flutter: ^1.0.1

Or run:

flutter pub add respectlytics_flutter

Quick Start #

import 'package:flutter/material.dart';
import 'package:respectlytics_flutter/respectlytics_flutter.dart';

void main() async {
  WidgetsFlutterBinding.ensureInitialized();

  // 1. Configure (call once at app launch)
  await Respectlytics.configure(apiKey: 'your-api-key');

  // 2. Enable user tracking (optional)
  await Respectlytics.identify();

  runApp(MyApp());
}

// 3. Track events anywhere in your app
await Respectlytics.track('purchase', screen: 'CheckoutScreen');

API Reference #

`configure(apiKey:)` #

Initialize the SDK. Call once in your `main()` before `runApp()`.

`track(eventName, {screen})` #

Track an event with optional screen name. Custom properties are not supported (privacy by design).

`identify()` #

Enable cross-session user tracking. Generates and persists a random user ID.

`reset()` #

Clear the user ID. Call when user logs out.

`flush()` #

Force send queued events. Rarely needed - SDK auto-flushes.

Privacy by Design #

Event Queue Behavior #

Events are queued and sent automatically:

• Every 30 seconds
• When 10 events are queued
• When app goes to background
• When `flush()` is called

Events are NEVER lost: They are persisted to SharedPreferences immediately on every `track()` call, surviving force-quit, crashes, and app termination.

Platform Support #

Requirements #

• Flutter 3.10+
• Dart 3.0+

Getting Help #

• 📖 Documentation
• 🐛 Issue Tracker
• 💬 Support

License #

Proprietary. See LICENSE file.