React Native SDK

npm install @bugspulse/react-native
# or
yarn add @bugspulse/react-native
# or
pnpm add @bugspulse/react-native

cd ios && pod install

import { AppRegistry } from 'react-native';
import BugsPulse from '@bugspulse/react-native';
import App from './App';

BugsPulse.init({
  apiKey: 'bp_live_your_key_here',   // Required — from project settings
  environment: 'production',          // 'development' | 'staging' | 'production'
});

AppRegistry.registerComponent('MyApp', () => App);

import Constants from 'expo-constants';
import BugsPulse from '@bugspulse/react-native';

BugsPulse.init({
  apiKey: Constants.expoConfig?.extra?.bugspulseApiKey ?? '',
  environment: __DEV__ ? 'development' : 'production',
});

module.exports = {
  extra: {
    bugspulseApiKey: process.env.BUGSPULSE_API_KEY,
  },
};

import BugsPulse from '@bugspulse/react-native';

// Call after the user signs in
BugsPulse.setUser('user_abc123');

// Add structured context to the session
BugsPulse.setContext({
  plan: 'pro',
  appVersion: '2.4.1',
  featureFlags: { newCheckout: true },
});

// Clear identity when the user signs out
BugsPulse.clearUser();

import BugsPulse from '@bugspulse/react-native';

// Simple event
BugsPulse.track('checkout_started');

// Event with properties — all properties appear in the replay timeline
BugsPulse.track('checkout_completed', {
  plan: 'pro',
  amount_usd: 29,
  coupon_applied: true,
});

// Add 'screen' to any event to show which screen it happened on
BugsPulse.track('button_press', { screen: 'HomeScreen', buttonId: 'cta' });
BugsPulse.track('product_tap', { screen: 'CatalogScreen', productId: 'sku_123' });

// Track a screen transition
BugsPulse.track('navigate', { from: 'HomeScreen', to: 'CheckoutScreen' });

// Or use screen_view style
BugsPulse.track('screen_view', { screenName: 'ProductDetailScreen' });

import BugsPulse from '@bugspulse/react-native';

// Manual exception capture
async function processPayment(orderId: string) {
  try {
    await paymentService.charge(orderId);
  } catch (error) {
    // Capture with context — the context appears in the crash report
    BugsPulse.captureException(error as Error, {
      orderId,
      context: 'payment_processing',
      retryCount: 2,
    });

    // Re-throw if you want the app to handle it too
    throw error;
  }
}

import React from 'react';
import BugsPulse from '@bugspulse/react-native';

class ErrorBoundary extends React.Component<
  { children: React.ReactNode; fallback: React.ReactNode },
  { hasError: boolean }
> {
  state = { hasError: false };

  static getDerivedStateFromError() {
    return { hasError: true };
  }

  componentDidCatch(error: Error, info: React.ErrorInfo) {
    BugsPulse.captureException(error, {
      context: 'react_error_boundary',
      componentStack: info.componentStack ?? '',
    });
  }

  render() {
    return this.state.hasError ? this.props.fallback : this.props.children;
  }
}

export default ErrorBoundary;

BugsPulse.init({
  apiKey: 'bp_live_...',
  networkIgnorePatterns: [
    /analytics.example.com/,   // Regex pattern
    'cdn.example.com',           // Exact domain string
  ],
});

import axios from 'axios';
import { createAxiosInterceptor } from '@bugspulse/react-native';

const api = axios.create({ baseURL: 'https://api.example.com' });
createAxiosInterceptor(api);

export default api;

import { AppState, type AppStateStatus } from 'react-native';
import { useEffect, useRef } from 'react';
import BugsPulse from '@bugspulse/react-native';

export default function App() {
  const appState = useRef(AppState.currentState);

  useEffect(() => {
    const sub = AppState.addEventListener('change', (next: AppStateStatus) => {
      if (appState.current === 'active' && next.match(/background|inactive/)) {
        BugsPulse.endSession();
      }
      if (appState.current.match(/background|inactive/) && next === 'active') {
        BugsPulse.startSession(); // Start a new session on foreground
      }
      appState.current = next;
    });
    return () => sub.remove();
  }, []);

  return <RootNavigator />;
}

BugsPulse.init({
  apiKey: 'bp_live_...',
  redactedFields: [
    'ssn',
    'creditCard',
    'cvv',
    'dob',
    'socialSecurityNumber',
    /secret.*/i,   // Regex patterns also supported
  ],
});