Screenshot reports
v1.0.0Detect screenshots, request permissions and attach images to bug reports.
Automatic screenshot detection
When users take a screenshot, BugScreen automatically shows the bug report screen. That's it — no extra wiring.
Reporter settings load asynchronously through the native SDK. If the screen opens before they arrive, it shows a loading indicator and keeps any attached screenshot. If they cannot be loaded, it shows a Retry action instead of opening the form with default settings.
Permissions
iOS: add an NSPhotoLibraryUsageDescription string to your Info.plist so the SDK can attach screenshots. The Expo config plugin adds this automatically; for bare React Native, add it yourself:
<key>NSPhotoLibraryUsageDescription</key>
<string>Used to attach screenshots to bug reports.</string>Android: the required permissions merge into your app automatically from the native library — no manifest changes needed. On Android 13 and below, request the media-read permission once at startup so screenshot detection works:
import { useEffect } from 'react';
import { BugScreen } from '@bugscreen/react-native';
useEffect(() => {
BugScreen.shouldRequestPermission().then((needed) =>
needed ? BugScreen.requestScreenshotPermission() : true
);
}, []);Platform.OS check.