🛡️ A React Native library to prevent and detect for screen capture, screenshots and app switcher for enhanced security. Fully compatible with both Expo and CLI.
npm install react-native-capture-protectionA React Native library to prevent screen capture, screenshots, and app switcher previews—providing enhanced security for your app.
Fully compatible with React Native CLI and Expo (Dev Client only).
---
| Screenshot Protection | App Switcher Protection |
| -------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------ |
| !Screen Recording | !App Switcher |
---
- 🔒 iOS: Screenshot, Screen Recording & App Switcher protection
- 🔒 Android: Screenshot & Screen Recording protection
- 📡 Event listeners for capture events
- 🧩 Hooks & Provider support
- 📱 Android 14 support
---
> ⚠️ Using React Native < 0.70?
> The latest v2.x version may not be compatible with versions below 0.70.
> It is recommended to use v1.9.17 for better stability with older React Native projects.
``sh`
npm install react-native-capture-protection
`sh`
yarn add react-native-capture-protection
> ⚠️ Expo Dev Client only
> This library includes native code, so it does not work with Expo Go. You must use a custom dev client.
`sh`
npx expo install react-native-capture-protection
If you're developing for iOS, don't forget to install CocoaPods dependencies after installing the package.
`sh`
cd ios && pod install
By default, it supports capture prevention, capture permission, and capture detection on Android 14 and above.
If you want capture detection(not prevent, only listener) support for versions below 14 (Android 10–13), please refer to the Support Below Android 14, Capture Detection (Optional) below.
add to android/app/build.gradle
`gradle`
defaultConfig {
...
missingDimensionStrategy "react-native-capture-protection", "base"
}
add to app.json
`json`
{
...
"plugins": [
...,
[
"react-native-capture-protection",
{
"captureType": "base"
}
]
]
}
On Android versions below 14, it detects screen captures using the sensitive READ_MEDIA_IMAGES permission.
If you want detection to work on Android versions below 14, please configure the settings as follows.
If publishing to the Play Store, explain the usage of READ_MEDIA_IMAGES like this:
`
Used by the application to detect screenshots, by checking for screenshot files in the user’s media storage.
add to android/app/build.gradle
`gradle`
defaultConfig {
...
missingDimensionStrategy "react-native-capture-protection", "callbackTiramisu"
}
add to app.json
`json`
{
...
"plugins": [
...,
[
"react-native-capture-protection",
{
"captureType": "callbackTiramisu"
}
]
]
}
`js
import {
CaptureProtection,
useCaptureProtection,
CaptureEventType
} from 'react-native-capture-protection';
const Component = () => {
const { protectionStatus, status } = useCaptureProtection();
React.useEffect(() => {
// Prevent all capture events
CaptureProtection.prevent();
// Or prevent specific events
CaptureProtection.prevent({
screenshot: true,
record: true,
appSwitcher: true
});
}, []);
React.useEffect(() => {
// Check if any capture is prevented
console.log('Prevent Status:', protectionStatus);
// Check current protection status
console.log('Protection Status:', status);
}, [protectionStatus, status]);
// Allow all capture events
const onAllow = async () => {
await CaptureProtection.allow();
};
// Allow specific events
const onAllowSpecific = async () => {
await CaptureProtection.allow({
screenshot: true,
record: false,
appSwitcher: true
});
};
// Check if screen is being recorded
const checkRecording = async () => {
const isRecording = await CaptureProtection.isScreenRecording();
console.log('Is Recording:', isRecording);
};
return (
// Your component JSX
);
};
`
1. Add to your jest.config.js:
`javascript`
module.exports = {
setupFilesAfterEnv: ['
};
2. Create jest.setup.js:
`javascript`
jest.mock('react-native-capture-protection', () =>
require('react-native-capture-protection/jest/capture-protection-mock')
);
`typescript
import { CaptureProtection } from "react-native-capture-protection/jest/capture-protection-mock";
...
test("prevent is called", async () => {
await CaptureProtection.prevent();
expect(CaptureProtection.prevent).toHaveBeenCalled();
});
``
🧪 Methods – All available API methods
📘 Types – Type definitions and interfaces
🛠 Migration Guide – From v1.x to v2.x
See CONTRIBUTING.md for details on contributing to this project.
MIT
---
Made with create-react-native-library