traze_flutter

Zero-config product intelligence SDK for Flutter. Auto-tracks 30 event types with 3 lines of code.

Built for Traze — AI-powered product intelligence that tells you what's working, what's broken, and what to fix next.

Quick Start

1. Install

dependencies:
  traze_flutter: ^0.1.0

flutter pub get

2. Initialize

import 'package:traze_flutter/traze_flutter.dart';

void main() async {
  await Traze.init(projectId: 'YOUR_PROJECT_ID');
  runApp(MyApp());
}

3. Add Navigator Observer

MaterialApp(
  navigatorObservers: [TrazeNavigatorObserver()],
)

That's it. Events start flowing automatically.

What Gets Tracked Automatically

Category Events
Navigation Screen pushes, pops, replaces with time on previous screen
Taps Widget type, text, rage taps (3+ in 1s), dead taps (non-interactive)
Network API calls, errors, status codes, duration
Errors Flutter framework errors, async errors with stack traces
Forms Field focus time, revisits, submission, abandonment
Scroll Max depth (0-100%) per screen
Lifecycle Cold start time, background/foreground, exit signals
Device OS, screen size, connectivity, app version
Session Frustration score, engagement score, pages visited, duration

Optional Manual Tracking

// Identify user
Traze.instance?.identify('user_123', traits: {'name': 'Jane'});

// Track deep link
MobileSignalTracker.trackDeepLink('myapp://product/123');

// Track push notification tap
MobileSignalTracker.trackPushNotification(action: 'opened', title: 'New message');

// Track permission result
MobileSignalTracker.trackPermission(permission: 'camera', result: 'granted');

// Track snackbar/toast
UiStateTracker.trackSnackBar('Item saved successfully');

Configuration

await Traze.init(
  projectId: 'YOUR_PROJECT_ID',
  apiUrl: 'https://api.yestraze.com',  // default
  debug: false,                          // enable console logs
);

Requirements

  • Flutter >= 3.10.0
  • Dart >= 3.0.0
  • iOS 12+ / Android API 21+

Get Your Project ID

Sign up at app.yestraze.com and create a project. Select "Mobile" as your platform and you'll get your project ID in the setup step.

License

MIT

Libraries

traze_flutter