React Native SDK

import { Sankofa } from "@sankofa/react-native";

Sankofa.initialize(process.env.EXPO_PUBLIC_SANKOFA_KEY!, {
endpoint: "https://api.sankofa.dev",
recordSessions: true,
maskAllInputs: true,
debug: __DEV__,
});

import { Sankofa, useSankofaScreen } from "@sankofa/react-native";

function CheckoutScreen() {
// Hook tags the current screen on mount; powers heatmaps + replay context.
useSankofaScreen("Checkout");

return (
  <Pressable onPress={() => Sankofa.track("pay_clicked", { amount: 29.99 })}>
    <Text>Pay</Text>
  </Pressable>
);
}

// On sign-in
Sankofa.identify("user_123");

// Update profile traits
Sankofa.setPerson({ email: "ada@example.com", plan: "pro" });

// On logout
Sankofa.reset();

// Force-flush
Sankofa.flush();

import { NavigationContainer, useNavigationContainerRef } from "@react-navigation/native";
import { Sankofa, useSankofaNavigationTracking } from "sankofa-react-native";

export default function App() {
const navRef = useNavigationContainerRef();
useSankofaNavigationTracking(navRef);

return (
  <NavigationContainer ref={navRef}>
    <RootStack />
  </NavigationContainer>
);
}

import { Sankofa } from "@sankofa/react-native";

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

// 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({ id: "user_123", email: "ada@example.com" });
Sankofa.setTag("flow", "checkout");
Sankofa.setExtra("cart_id", cart.id);

// Structured breadcrumb (HTTP, navigation, console, etc.).
Sankofa.addBreadcrumb({ category: "user-action", message: "Tapped checkout" });

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

Sankofa.initialize("sk_live_...", {
endpoint: "https://api.sankofa.dev",
beforeSend: (event) => {
  // Drop ResizeObserver-loop-limit-style noise.
  if (event.message?.includes("setState() called after unmount")) return null;
  // PII scrubbing — strip email from the user context.
  if (event.user?.email) {
    return { ...event, user: { ...event.user, email: undefined } };
  }
  return event;
},
});

import React from "react";
import { Sankofa } from "@sankofa/react-native";

class RootBoundary extends React.Component<{ children: React.ReactNode }> {
componentDidCatch(error: Error, errorInfo: React.ErrorInfo) {
  Sankofa.withScope((scope) => {
    scope.setExtra("componentStack", errorInfo.componentStack ?? "");
    Sankofa.captureException(error);
  });
}
// ... render fallback
}

import { Sankofa, SankofaSwitch } from "@sankofa/react-native";

const flags = new SankofaSwitch({
defaults: { new_checkout: false, dark_mode_default: false },
});

Sankofa.initialize("sk_live_...", { endpoint: "https://api.sankofa.dev" });

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

// Variant
const variant = flags.getVariant("checkout_redesign", "control");

// Full envelope
const decision = flags.getDecision("new_checkout");
console.log(decision?.reason);  // "rollout", "cohort:pro", "default", "halted", etc.

// Subscribe to changes (e.g. halt-webhook fire)
const unsubscribe = flags.onChange("new_checkout", (decision) => {
setNewCheckoutEnabled(decision.value as boolean);
});

import { Sankofa, SankofaConfig } from "@sankofa/react-native";

const config = new SankofaConfig({
defaults: { max_upload_mb: 25, support_email: "help@example.com" },
});

Sankofa.initialize("sk_live_...");

// Generic typed read
const maxMB = config.get<number>("max_upload_mb", 25);
const email = config.get<string>("support_email", "help@example.com");

// Decision envelope
const decision = config.getDecision("max_upload_mb");

// Subscribe to changes
const unsubscribe = config.onChange("max_upload_mb", (decision) => {
setMaxMB(decision.value as number);
});

import { SankofaPulse, SurveyModal } from "@sankofa/react-native";

const pulse = new SankofaPulse();

// Show a survey
await pulse.show("srv_post_purchase_feedback");

// Programmatic dismiss
pulse.dismiss();

// Listen for events
const unsubscribe = pulse.on("completed", (event) => {
console.log("Survey", event.surveyId, "completed");
});

// Set per-user eligibility context (passed back to engine on next handshake)
pulse.setContext({ tenantId: "acme", plan: "pro" });

import { SurveyModal } from "@sankofa/react-native";

export default function App() {
return (
  <NavigationContainer>
    {/* ... your screens */}
    <SurveyModal />
  </NavigationContainer>
);
}

import { SankofaDeploy } from "@sankofa/react-native";

const deploy = new SankofaDeploy({
apiKey: "sk_live_...",
serverUrl: "https://api.sankofa.dev",
checkOnResume: true,
});

// Confirm successful boot — prevents auto-rollback.
deploy.notifyAppReady();

// Check for updates
const update = await deploy.checkForUpdate();

if (update.updateAvailable) {
if (update.isMandatory) {
  await deploy.downloadAndApply(update);
} else {
  await deploy.downloadInBackground(update);
}
}