SDKs
Flutter SDK Guide
Client-safe mobile and web SDK for Flutter using write-only Client DSN credentials (laz_ci_...).
Important Safety & Auth Policy
NEVER use server API keys (laz_live_) in Flutter apps. Always configure with a write-only client DSN (laz_ci_) created under Settings -> Client Credentials.
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();
}