Flutter SDK

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

void main() async {
WidgetsFlutterBinding.ensureInitialized();
await Sankofa.instance.init(
  apiKey: const String.fromEnvironment('SANKOFA_KEY'),
  endpoint: 'https://api.sankofa.dev',
  debug: !const bool.fromEnvironment('dart.vm.product'),
  enableSessionReplay: true,
  replayMode: ReplayMode.wireframe, // or ReplayMode.screenshot
);
runApp(const MyApp());
}

// Track an event
await Sankofa.instance.track('checkout_started', {
'cart_value': 49.99,
'item_count': 3,
});

// Tag a screen explicitly (auto-tracked when using SankofaNavigatorObserver)
await Sankofa.instance.screen('Checkout');

// Identify after sign-in
await Sankofa.instance.identify('user_123');

// Update profile via the dedicated People setter
await Sankofa.instance.peopleSet({
'plan': 'growth',
'role': 'operator',
});

// Or set the named common traits
await Sankofa.instance.setPerson(
name: 'Ada Lovelace',
email: '[email protected]',
avatar: null,
properties: {'company': 'Sankofa Ltd'},
);

// Logout — rotates session, clears identity
await Sankofa.instance.reset();

// Force-flush
await Sankofa.instance.flush();

MaterialApp(
navigatorObservers: [SankofaNavigatorObserver()],
// ...
)

// Capture a caught exception from anywhere — Sentry-style.
try {
await chargeCard(amount);
} catch (err, stack) {
Sankofa.captureException(err, stack);
}

// Capture a non-error event (warning-level).
Sankofa.captureMessage('Payment retry attempted');

// Crashlytics-style breadcrumb log — rides on the next captured
// event. Doesn't bill on its own.
Sankofa.log('checkout: applying coupon SUMMER25');

// Attach ambient context. Sticky — every subsequent event carries it.
Sankofa.setUser(CatchUserContext(id: 'user_123', email: '[email protected]'));
Sankofa.setTag('flow', 'checkout');
Sankofa.setExtra('cart_id', cart.id);

// Push a structured breadcrumb (HTTP, navigation, console, etc.).
Sankofa.addBreadcrumb(CatchBreadcrumb(
category: 'user-action',
message: 'Tapped checkout button',
));

Sankofa.withScope((scope) {
scope.setTag('checkout_step', 'payment');
scope.setExtra('cart_id', cart.id);
scope.setLevel(CatchLevel.warning);
Sankofa.captureException(err);
});
// Outside the closure, those tags / extras are gone.

await Sankofa.instance.init(
apiKey: '...',
endpoint: '...',
beforeSend: (event) {
  // Drop ResizeObserver-loop-limit-style noise.
  if (event.message?.contains('setState() called after dispose') ?? false) {
    return null;
  }
  // PII scrubbing — strip email from the user context.
  if (event.user?.email != null) {
    return event.copyWith(user: event.user!.copyWith(email: null));
  }
  return event;
},
);

import 'package:sankofa_flutter/sankofa_flutter.dart';

final flags = SankofaSwitch(defaults: {
'new_checkout': FlagDecision(value: false, reason: 'default'),
'dark_mode_default': FlagDecision(value: false, reason: 'default'),
});

await Sankofa.instance.init(
apiKey: 'sk_live_...',
endpoint: 'https://api.sankofa.dev',
);

// Boolean
if (flags.getFlag('new_checkout')) showNewCheckout();

// Variant
final variant = flags.getVariant('checkout_redesign', defaultValue: 'control');

// Full envelope
final decision = flags.getDecision('new_checkout');
print(decision?.reason); // "rollout", "cohort:pro", "default", "halted", etc.

// Subscribe to changes
final unsubscribe = flags.onChange('new_checkout', (decision) {
setState(() => _newCheckoutEnabled = decision.value as bool);
});

// Later
unsubscribe();

final config = SankofaConfig(defaults: {
'max_upload_mb': ItemDecision(value: 25, version: 1, reason: 'default'),
'support_email': ItemDecision(value: '[email protected]', version: 1, reason: 'default'),
});

await Sankofa.instance.init(/* ... */);

// Generic typed read — infers T from defaultValue
final maxMB = config.get<int>('max_upload_mb', 25);
final email = config.get<String>('support_email', '[email protected]');

// Decision envelope
final decision = config.getDecision('max_upload_mb');

// Inspect
final allKeys = config.getAllKeys();
final allValues = config.getAll();

// Subscribe to changes
final unsubscribe = config.onChange('max_upload_mb', (decision) {
setState(() => _maxMB = decision.value as int);
});

final registered = await SankofaPulse.instance.register();
if (!registered) {
print('Sankofa Core must be initialized before Pulse.');
}

await SankofaPulse.instance.show(context, 'srv_post_purchase_feedback');

// Programmatic dismiss
SankofaPulse.instance.dismiss();

final unsubscribe = SankofaPulse.instance.on(PulseEvent.completed, (event) {
print('Survey ${event.surveyId} completed');
});

final eligible = await SankofaPulse.instance.activeMatchingSurveys();
print('Eligible:', eligible.map((s) => s.id).toList());

void main() {
runApp(
  SankofaReplayBoundary(
    child: MyApp(),
  ),
);
}

SankofaMask(
child: Text('Account balance: \$4,238'),
)