@capgo/capgo-skills/skills/capacitor-plugins/references/capacitor-local-notifications.md

55 agent skills for Capacitor mobile development

# Local Notifications

Schedule device notifications locally without server-based push.

**Platforms:** Android, iOS, Web

## Installation

```bash
npm install @capacitor/local-notifications
npx cap sync
```

## Configuration

### Android

- Android 13+: `checkPermissions()` / `requestPermissions()` required.
- Android 12+: `SCHEDULE_EXACT_ALARM` permission in `android/app/src/main/AndroidManifest.xml`.
- Android 14+: `USE_EXACT_ALARM` is auto-granted only for limited app categories and is subject to Google Play policy review. For most apps, prefer `SCHEDULE_EXACT_ALARM`, check exact-alarm access at runtime, and fall back to inexact scheduling when exact alarms are unavailable.
- Config options: `smallIcon` (drawable resource), `iconColor`, `sound` in `capacitor.config.ts`.

## Usage

```typescript
import { LocalNotifications } from '@capacitor/local-notifications';

const permission = await LocalNotifications.checkPermissions();
if (permission.display !== 'granted') {
  const request = await LocalNotifications.requestPermissions();
  if (request.display !== 'granted') {
    throw new Error('Local notification permission denied');
  }
}

await LocalNotifications.schedule({
  notifications: [
    {
      title: 'Reminder',
      body: 'Time to check in!',
      id: 1,
      schedule: { at: new Date(Date.now() + 1000 * 60) },
    },
  ],
});

LocalNotifications.addListener('localNotificationActionPerformed', (notification) => {
  console.log('Action:', notification.actionId);
});
```

## Notes

- Exact alarms during Doze fire max once per 9 min/app.
- Channel config on Android 8+ affects sound and cannot change post-install.
- Supports `createChannel()`, `deleteChannel()`, `listChannels()`.