Connect a Flutter app

flutter pub add http shared_preferences
flutter pub add device_info_plus package_info_plus

shared_preferences holds the persistent anonymous Tester ID and the offline event queue. http posts the telemetry.

Open a terminal at your project root, then run:

flutter run \
  --dart-define=TESTER_API_URL=https://saraayab.shop \
  --dart-define=TESTER_APP_ID=my-flutter-app \
  --dart-define=TESTER_API_KEY=hk_your_key_here \
  --dart-define=TESTER_APP_VERSION=1.0.3

Copy the API key from Developer portal → your app → Copy key (it looks like hk_.... The x-api-key header is required in production; it may be empty in local dev. appId is the exact appId from the Developer portal. Create the app there first.

Use https://saraayab.shop. HTTPS avoids Android cleartext HTTP blocking.

Download the complete client Download the complete Flutter client and save it as lib/tester_analytics.dart. It creates the UUID v4 tester ID, sends register / app_opened, tracks screens, app foreground/background, crashes and bug reports, runs a ~60s heartbeat and queues events while offline.

import 'package:device_info_plus/device_info_plus.dart';
import 'package:flutter/material.dart';
import 'package:package_info_plus/package_info_plus.dart';

import 'tester_analytics.dart';

Future<void> main() async {
  WidgetsFlutterBinding.ensureInitialized();
  await TesterAnalytics.init(
    config: TesterConfig(
      apiUrl: const String.fromEnvironment('TESTER_API_URL'),
      appId: const String.fromEnvironment('TESTER_APP_ID'),
      apiKey: const String.fromEnvironment('TESTER_API_KEY'),
      appVersion: (await PackageInfo.fromPlatform()).version,
      device: await _buildDevice(),
    ),
  );
  runApp(const MyApp());
}

Future<Map<String, dynamic>> _buildDevice() async {
  final a = await DeviceInfoPlugin().androidInfo;
  return <String, dynamic>{
    'os': 'android',
    'osVersion': a.version.release,
    'systemVersion': a.version.sdkInt.toString(),
    'deviceModel': a.model,
    'deviceBrand': a.manufacturer,
    'manufacturer': a.manufacturer,
    'model': a.model,
    'brand': a.brand,
  };
}

MaterialApp(
  navigatorObservers: [TesterNavigatorObserver()],
  initialRoute: '/home',
  onGenerateRoute: (settings) => MaterialPageRoute(
    builder: (_) => HomeScreen(),
    settings: settings,
  ),
);

// Or track a screen manually:
TesterAnalytics.setScreen('Checkout');

TesterAnalytics.reportCrash('boom', stack.toString());

TesterAnalytics.reportBug(
  'Checkout button does nothing',
  params: <String, dynamic>{
    'title': 'Checkout dead button',
    'steps': 'Open cart -> tap Checkout',
    'screenName': 'CartScreen',
  },
);

Future<void> testerPrivacyExample() async {
  final id = TesterAnalytics.testerId; // show this in Settings if needed
  await TesterAnalytics.setContactName('Sara');
  await TesterAnalytics.setOptedOut(true);
  await TesterAnalytics.eraseMyData();
}

Crash capture is automatic: the client installs FlutterError.onError and PlatformDispatcher.instance.onError. Wrap runApp in runZonedGuardedto catch errors outside the Flutter zone.

Open a terminal at your project root, then run:

flutter run \
  --dart-define=TESTER_API_URL=https://saraayab.shop \
  --dart-define=TESTER_APP_ID=my-flutter-app \
  --dart-define=TESTER_API_KEY=hk_your_key_here \
  --dart-define=TESTER_APP_VERSION=1.0.3

1. Open the app once on the device or emulator.
2. Events appear under the app you created.
3. The tester shows as Active with version, device, opens, and activity history.

Local testing only: For local-only testing, use http://10.0.2.2:3000 on the Android emulator and allow cleartext HTTP in a debug build. Never use cleartext HTTP in production.