mcpField
I
ionic-local-notifications

ionic-local-notifications

github.com/erkamyamanDevelopment1643 installsUpdated 1w ago
Repository

About ionic-local-notifications

A reference skill for implementing device-scheduled notifications in Ionic apps with Capacitor Local Notifications. It covers permission timing and scheduling constraints, and distinguishes local alerts from backend-sent push notifications.

Key features

  1. 01Permission and scheduling guidance
  2. 02Rules for unique notification IDs
  3. 03iOS scheduling limit guidance
  4. 04Android 13+ permission behavior
  5. 05Recurring and action patterns referenced

Use cases

  1. 01Scheduling daily reminders on a device
  2. 02Sending follow-up prompts after onboarding
  3. 03Creating inactivity or post-purchase nudges

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/erkamyaman/ionic-capacitor-skills --skill ionic-local-notifications

After installing, type/ionic-local-notificationsin Claude Code to confirm it loaded.

Bundled filesreferences/patterns.mdreferences/setup-and-scheduling.md

Details

From the project README

Local Notifications

Notifications scheduled and fired by the device, not by a backend. Use cases: daily reminders, follow-up prompts after onboarding, post-purchase nudges, inactivity reminders.

For server-sent notifications (FCM / APNs), see ../ionic-shared/references/push-notifications.md. The two plugins are independent and can be used together.

When to consult

Hard rules

  • ✅ Request permission when the user opts in to a feature that uses notifications, not on app launch.
  • ✅ Always set a unique numeric id per notification — same id overwrites the previous one.
  • ✅ On Android 13+ the OS auto-prompts for POST_NOTIFICATIONS the first time you schedule.
  • ❌ Don't schedule more than ~64 simultaneous notifications on iOS — the OS silently drops the rest.
  • ❌ Don't rely on local notifications for time-critical delivery — they can be delayed by the OS for power management. Push is for "this must arrive."

Library

npm install @capacitor/local-notifications
npx cap sync

Comments

Markdown supported