capacitor-push-notifications

Configures Firebase Cloud Messaging push notifications in Capacitor apps for Android, iOS, and Web.

1|Updated Aug 25, 2026
One-click install
npx skills add https://github.com/involvex/ionic-everywhere --skill capacitor-push-notifications-involvex
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: capacitor-push-notifications
Source: https://github.com/involvex/ionic-everywhere/tree/main/.agents/skills/capacitor-push-notifications
Command: npx skills add https://github.com/involvex/ionic-everywhere --skill capacitor-push-notifications-involvex

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires @capacitor-firebase/messaging, firebase, and includes references (resource) components.

What problem does it solve? Setting up push notifications in a Capacitor app requires coordinating Firebase project configuration, platform-specific native changes (Gradle, AppDelegate.swift, capabilities), plugin installation, and permission handling across Android, iOS, and Web — a process that is error-prone and scattered across many documentation pages. ## Core Features & Use Cases - Guided Firebase Setup: Walks through registering apps in the Firebase console, downloading google-services.json / GoogleService-Info.plist, and creating APNs keys for iOS. - Platform Configuration: Applies Android manifest changes (notification icon, color), iOS AppDelegate methods and capabilities, and Web service worker plus VAPID key setup. - Implementation Code: Provides TypeScript code for requesting permissions, retrieving FCM tokens, listening for notifications and taps, topic subscriptions, and Android notification channels. - Use Case: A developer with an existing Capacitor 8 app wants to add push notifications. The skill auto-detects the android/ and ios/ directories, checks for conflicting plugins, then walks through Firebase setup, native configuration, and testing a notification from the Firebase console. ## Quick Start Set up Firebase Cloud Messaging push notifications in my Capacitor app for Android and iOS.

Frequently Asked Questions about capacitor-push-notifications

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I set up push notifications in a Capacitor app with Firebase?▼

Install @capacitor-firebase/messaging and firebase, then run npx cap sync. Register your app in the Firebase console, place google-services.json in android/app/ and GoogleService-Info.plist in ios/App/App/, then request permissions and call getToken() to retrieve the FCM token.

What is the difference between @capacitor-firebase/messaging and @capacitor/push-notifications?▼

@capacitor-firebase/messaging uses Firebase Cloud Messaging directly, while @capacitor/push-notifications is the core Capacitor plugin. They cannot coexist in the same project, so uninstall @capacitor/push-notifications before installing the Firebase plugin.

Does Firebase push notification work on iOS Simulator?▼

No, the iOS Simulator cannot receive push notifications. You must test on a physical iOS device with a paid Apple Developer Program membership, an APNs key uploaded to Firebase, and the Push Notifications capability enabled in Xcode.

Why does my Android push notification show a white square icon?▼

Android requires the notification icon to be white pixels on a transparent background. Application icons with color render as a white square, so add a dedicated push_notification_icon.png to each mipmap density folder and reference it in AndroidManifest.xml.

Why is the FCM token null when calling getToken()?▼

The token is null when requestPermissions() was not called first or did not return granted. On iOS, also verify you are on a physical device rather than a simulator, and on Web confirm the VAPID key and firebase-messaging-sw.js service worker are configured.

How do I test push notifications from the Firebase console?▼

Open the Firebase console, go to Messaging, create a Firebase Notification messages campaign, click Send test message, and paste the FCM token from getToken(). Foreground notifications fire the notificationReceived listener; background taps fire notificationActionPerformed.