Lazers/Documentation/Flutter SDK Guide
SDKs

Flutter SDK Guide

Client-safe mobile and web SDK for Flutter using write-only Client DSN credentials (laz_ci_...).

The Lazers Flutter SDK (`lazers_flutter`) is designed specifically for Flutter on iOS, Android, and Web.

Key Security Guardrails - **Write-Only Credential**: Uses `laz_ci_...` client DSNs. Client DSNs cannot read incident history, retrieve audit logs, or modify project settings. - **Privacy By Default**: Does NOT collect email, phone number, IMEI, advertising IDs, device location, or contacts. - **URL Query Stripping**: All captured HTTP URLs automatically strip query parameters to avoid leaking auth tokens in URLs.

Installation ```bash flutter pub add lazers_flutter ```

Or add to `pubspec.yaml`: ```yaml dependencies: lazers_flutter: ^0.1.0 ```

Integration Code Examples

Flutter main.dart
import 'package:flutter/material.dart';
import 'package:lazers_flutter/lazers_flutter.dart';

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

  // Initialize with write-only client DSN
  await LazersFlutter.init(
    dsn: 'https://laz_ci_example_token@api.lazers.app/prj_production_1',
    release: '1.4.2',
    appVersion: '104',
    appName: 'CheckoutApp',
  );

  // Automatically capture uncaught Flutter UI errors
  LazersFlutter.installFlutterErrorHook();
  LazersFlutter.installPlatformDispatcherErrorHook();

  runApp(const MyApp());
}

// In your application logic:
void onCheckoutError(Object error, StackTrace stackTrace) {
  LazersFlutter.captureError(
    error,
    stackTrace: stackTrace,
    correlationId: 'cart_9921',
  );
}

// Network failure monitoring (strips query parameters automatically):
void onApiTimeout() {
  LazersFlutter.captureNetworkFailure(
    method: 'POST',
    url: 'https://api.mysite.com/checkout?token=secret123', // query will be stripped!
    statusCode: 504,
  );
}

// Set actor context (only stable IDs, never raw phone or email):
void onUserLogin(String userId) {
  LazersFlutter.setActor(id: userId, type: 'user', label: 'Pro User');
}

void onUserLogout() {
  LazersFlutter.clearActor();
}

Ready to test with your service?

Create a project, generate an API key or Client DSN, and send a signal in 2 minutes.