@capacitor-community/keep-awake

Keep Awake

@capacitor-community/keep-awake

⚡️ Capacitor plugin to prevent devices from dimming or locking the screen.

Maintainers

Maintainer	GitHub	Social
Kevin Boosten	kevinboosten	@kevinboosten
Robin Genz	robingenz	@robin_genz

Installation

npm install @capacitor-community/keep-awake
npx cap sync

Configuration

No configuration required for this plugin.

Demo

A working example can be found in example-app folder.

Usage

import { KeepAwake } from '@capacitor-community/keep-awake';

const keepAwake = async () => {
  await KeepAwake.keepAwake();
};

const allowSleep = async () => {
  await KeepAwake.allowSleep();
};

const isSupported = async () => {
  const result = await KeepAwake.isSupported();
  return result.isSupported;
};

const isKeptAwake = async () => {
  const result = await KeepAwake.isKeptAwake();
  return result.isKeptAwake;
};

API

• keepAwake()
• allowSleep()
• isSupported()
• isKeptAwake()
• Interfaces

keepAwake()

keepAwake() => Promise<void>

Prevent the device from dimming the screen.

allowSleep()

allowSleep() => Promise<void>

Allow the device to dim the screen.

isSupported()

isSupported() => Promise<IsSupportedResult>

Whether keep awake is supported or not.

Returns: Promise<IsSupportedResult>

isKeptAwake()

isKeptAwake() => Promise<IsKeptAwakeResult>

Check if the device is kept awake.

Returns: Promise<IsKeptAwakeResult>

Interfaces

IsSupportedResult

Prop	Type
isSupported	boolean

IsKeptAwakeResult

Prop	Type
isKeptAwake	boolean

Changelog

See CHANGELOG.md.

License

See LICENSE.

Changelog

7.1.0 (2025-06-20)

Features

• ios: Add SPM support (#55) (ffeb13e)