unilitix 2.0.34

African-first mobile UX analytics for Flutter. Pure Dart SDK — track sessions, screens, events and crashes with a single line of code.

Unilitix Flutter SDK

African-first mobile UX analytics for Flutter. Track sessions, screens, events and crashes with a single line of code.

Install

dependencies:
  unilitix: ^2.0.34

Quick start

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

void main() async {
  WidgetsFlutterBinding.ensureInitialized();
  await Unilitix.init(config: const UnilitixConfig(apiKey: 'YOUR_API_KEY'));
  runApp(UnilitixGestureDetector(child: const MyApp()));
}

class MyApp extends StatelessWidget {
  @override
  Widget build(BuildContext context) {
    return UnilitixMaterialApp( // drop-in for MaterialApp
      home: const HomeScreen(),
    );
  }
}

Get your API key at app.unilitix.com → Settings → Apps.

Verify your integration

In debug mode you will see:

[Unilitix] SDK initialized ✅ v2.0.32
[Unilitix] Session started ✅ abc123…
[Unilitix] Screen → /home

Track custom events

Unilitix.track('loan_applied', {
  'amount': 50000,
  'loan_type': 'personal',
  'currency': 'NGN',
});

Identify users

// After login
Unilitix.identify('user_123', {
  'name': 'Ada Okafor',
  'plan': 'pro',
  'country': 'Nigeria',
});

// After logout
Unilitix.reset();

Configuration

await Unilitix.init(
  config: const UnilitixConfig(
    apiKey: 'YOUR_API_KEY',
    debug: false,
    captureSnapshots: true,            // session replay — widget tree
    captureScreenshots: false,         // pixel screenshots — Growth plan
    maskInputs: true,                  // mask text fields in replay
    flushIntervalSeconds: 30,          // upload frequency
    sessionTimeoutSeconds: 1800,       // idle timeout (30 min)
    uploadScreenshotsOnWifiOnly: true, // save mobile data
  ),
);

go_router / custom navigators

GoRouter(
  observers: [Unilitix.observer],
  routes: [...],
)

Privacy

Unilitix.optOut(); // user opts out
Unilitix.optIn();  // user opts back in

// Exclude sensitive widgets from recordings
UnilitixPrivate(child: CreditCardWidget())

Requirements

Platform	Minimum
Android	API 21 (Android 5.0)
iOS	In development
Web	✅ Supported

Support

• Docs: docs.unilitix.com
• Email: [e-mail]
• Issues: GitHub Issues