> ## Documentation Index > Fetch the complete documentation index at: https://mintlify.com/ivangonzalezg/react-native-background-guardian/llms.txt > Use this file to discover all available pages before exploring further. # React Native Background Guardian

Keep Your React Native Apps Alive in the Background

Prevent Android from killing background processes with Wake Locks, battery optimization exemptions, and OEM-specific protections. iOS-safe with no-op implementation. 

              
                {`import BackgroundGuardian from
                                'react-native-background-guardian';

                                // Acquire wake lock
                                await BackgroundGuardian
                                .acquireWakeLock('MyTask');

                                // Check battery optimization
                                const isIgnoring = await
                                BackgroundGuardian
                                .isIgnoringBatteryOptimizations();

                                // Request exemption
                                if (!isIgnoring) {
                                await BackgroundGuardian
                                  .requestBatteryOptimization
                                  Exemption();
                                }`}

Quick start

Get your app protected from background restrictions in minutes

Add React Native Background Guardian to your project using your preferred package manager: ```bash npm theme={null} npm install react-native-background-guardian ``` ```bash yarn theme={null} yarn add react-native-background-guardian ``` ```bash pnpm theme={null} pnpm add react-native-background-guardian ``` For iOS, install pods: ```bash theme={null} cd ios && pod install ``` Import the library and acquire a wake lock to keep the CPU running during background tasks: ```typescript theme={null} import BackgroundGuardian from 'react-native-background-guardian'; // Acquire wake lock before starting background work const acquired = await BackgroundGuardian.acquireWakeLock('MyBackgroundTask'); if (acquired) { // Perform your background work await doBackgroundWork(); // Release when done await BackgroundGuardian.releaseWakeLock(); } ``` Check if your app is exempt from battery optimizations and request exemption if needed: ```typescript theme={null} // Check current status const isIgnoring = await BackgroundGuardian.isIgnoringBatteryOptimizations(); if (!isIgnoring) { // Show the system dialog to request exemption await BackgroundGuardian.requestBatteryOptimizationExemption(); } ``` Google Play has restrictions on using `REQUEST_IGNORE_BATTERY_OPTIMIZATIONS`. Only use this if your app genuinely requires background execution (messaging, health tracking, device management, etc.). Many manufacturers (Xiaomi, Huawei, Samsung) have additional battery optimization. Guide users to whitelist your app: ```typescript theme={null} const manufacturer = await BackgroundGuardian.getDeviceManufacturer(); if (['xiaomi', 'huawei', 'oppo', 'vivo'].includes(manufacturer ?? '')) { // Open OEM-specific settings await BackgroundGuardian.openOEMSettings(); } ```

Explore by topic

Everything you need to keep your app running reliably in the background

Keep the CPU running during background tasks with partial and screen wake locks. Request exemption from Doze mode and App Standby restrictions. Navigate manufacturer-specific battery savers from Xiaomi, Samsung, Huawei, and more. Understand Android's power-saving features and how to work with them.

Key features

Wake Lock Management

Keep CPU running during background tasks with partial and screen wake locks.

Battery Exemption

Request Doze mode whitelist to run background tasks more freely.

OEM-Specific Settings

Navigate to manufacturer battery settings for Xiaomi, Samsung, Huawei, and more.

Cross-Platform

iOS-safe implementation with no-op methods that return safe defaults.

TypeScript Support

Full type definitions included for excellent IDE autocomplete and type safety.

New Architecture Ready

Built as a Turbo Module for React Native's new architecture.

Resources

Real-world examples for audio players, location tracking, and kiosk mode. Understand how the library behaves on Android vs iOS. Test Doze mode with ADB and debug wake lock issues. Complete list of supported manufacturers and their settings. Common issues and solutions for wake locks and battery optimization. Frequently asked questions about background execution.

Ready to get started?

Install React Native Background Guardian and start protecting your app from aggressive battery optimization today.