React Native LastCrash SDK

⚠️ Beta Notice: This SDK is currently in beta and intended for development use only. APIs may change before the stable release. Do not use in production applications. Version 1.0 is expected in August 2025. Please wait for the stable release before deploying to production applications.

A React Native SDK for LastCrash - a comprehensive crash reporting and analytics solution that captures screenshots, monitors app state, and uploads crash reports with visual context.

Features

• Screenshot Capture: Automatically captures screenshots at regular intervals
• Crash Reporting: Integrates with native crash reporting (KSCrash on iOS)
• Network Monitoring: Tracks network requests and responses
• Event Tracking: Custom event tracking and analytics
• ANR Detection: Application Not Responding detection
• Freeze Detection: Detects UI freezes and performance issues
• Cross-Platform: Works on both iOS and Android

Installation

npm install react-native-lastcrash
# or
yarn add react-native-lastcrash

iOS

After installing, run:

npx pod-install

That’s it! No need to edit your Podfile.

Android

No additional steps required—autolinking will handle everything.

---

Note: If you are using a monorepo, custom Podfile, or an older version of React Native (<0.60), see the troubleshooting section below.

---

Usage

Basic Setup

import LastCrash from 'react-native-lastcrash';

// Configure LastCrash with your API key
LastCrash.configure('your-api-key-here');

// Set up crash delegate (optional)
LastCrash.setCrashReportSenderDelegate();

// Mark app as initialized
LastCrash.applicationInitialized();

App.js Example

import React, { useEffect } from 'react';
import { View, Text, Button } from 'react-native';
import LastCrash from 'react-native-lastcrash';

const App = () => {
  useEffect(() => {
    // Configure LastCrash
    LastCrash.configure('your-api-key-here');

    // Set up crash delegate
    LastCrash.setCrashReportSenderDelegate();

    // Mark app as initialized
    LastCrash.applicationInitialized();

    // Enable logging (iOS only)
    LastCrash.enableLogging();

    // Track app open event
    LastCrash.event('app_open');
  }, []);

  const handlePause = () => {
    LastCrash.pause();
    console.log('Video capture paused');
  };

  const handleUnpause = () => {
    LastCrash.unpause();
    console.log('Video capture resumed');
  };

  const handleCustomEvent = () => {
    LastCrash.event('button_clicked', 'test_button');
  };

  const handleCrash = () => {
    // Simulate a crash for testing
    throw new Error('Test crash');
  };

  return (
    <View style={{ flex: 1, justifyContent: 'center', alignItems: 'center' }}>
      <Text>LastCrash Demo</Text>
      <Button title="Pause Capture" onPress={handlePause} />
      <Button title="Resume Capture" onPress={handleUnpause} />
      <Button title="Track Event" onPress={handleCustomEvent} />
      <Button title="Test Crash" onPress={handleCrash} />
    </View>
  );
};

export default App;

API Reference

Methods

configure(apiKey: string)

Configure LastCrash with your API key.

setCrashReportSenderDelegate()

Set up a delegate to handle crash callbacks.

enableLogging() / disableLogging()

Enable or disable LastCrash logging (iOS only).

pause() / unpause()

Pause or resume screenshot capture.

sendCrashes()

Manually send crash reports.

event(name: string, value?: string)

Track a custom event.

applicationInitialized()

Mark the application as initialized.

addNetworkTrackingToDefaultSession()

Add network tracking to the default URL session (iOS only).

addMaskView(viewTag: number)

Mask a specific view.

removeMaskView(viewTag: number)

Remove a mask from a specific view.

removeAllMaskViews()

Remove all view masks.

addMaskRect(x: number, y: number, width: number, height: number, maskId: string)

Mask a specific rectangle.

removeMaskRect(maskId: string)

Remove a specific rectangle mask.

removeAllMaskRects()

Remove all rectangle masks.

Events

LastCrashDidCrash

Emitted when a crash is detected.

import { DeviceEventEmitter } from 'react-native';

DeviceEventEmitter.addListener('LastCrashDidCrash', (reports) => {
  console.log('Crash detected:', reports);
});

Troubleshooting

Monorepos, Custom Podfiles, or Old React Native (<0.60)

• If your Podfile does not include use_native_modules!, or you are using a monorepo, you may need to manually add the pod to your Podfile:

  pod 'react-native-lastcrash', :path => '../node_modules/react-native-lastcrash'

• Then run npx pod-install again.
• For Android, if autolinking does not work, add the project manually to settings.gradle and build.gradle as described in the React Native docs.

Support

For support, please contact support@lastcrash.io or visit our documentation at https://docs.lastcrash.io.