# Push Notifications

> Implement push notifications across iOS (APNs), Android (FCM), and cross-platform frameworks

- Skill: `uitbreidenos/push-notifications` (Agent Skill)
- Install (CLI): `npx skillmds@latest add uitbreidenos/push-notifications`
- Raw SKILL.md: https://api.skillmd.com/api/skills/uitbreidenos/push-notifications/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: UitbreidenOS (https://skillmd.com/u/uitbreidenos)
- Updated: 2026-09-22
- Page: https://skillmd.com/skills/uitbreidenos/push-notifications

---


## When to activate

- Setting up push notification infrastructure
- Implementing notification handlers in mobile apps
- Configuring APNs certificates or FCM service accounts
- Designing notification payloads with actions and deep links
- Debugging notification delivery issues

## When NOT to use

- For email notification systems
- For in-app messaging only
- For SMS notification services

## Instructions

1. **Choose provider.** Firebase Cloud Messaging (FCM) for both platforms, or APNs + FCM separately for more control.
2. **iOS setup.** Generate APNs key (.p8) in Apple Developer Portal. Configure in FCM console or custom server.
3. **Android setup.** Create Firebase project, download `google-services.json`. Configure FCM in AndroidManifest.xml.
4. **Client implementation.** Request permission, register for token, handle foreground/background/killed states, implement action buttons.
5. **Server-side.** Token management, payload construction, scheduling, batching. Use topics for broadcast, tokens for targeted.
6. **Deep linking.** Include deep link URL in notification payload. App opens to specific screen on tap.
7. **Testing.** Test on real devices (simulators don't receive push). Use FCM console or Postman for test sends.

## Example

```json
{
  "notification": {
    "title": "New message from Alex",
    "body": "Hey, are you free for lunch today?",
    "image": "https://cdn.example.com/avatar/alex.jpg"
  },
  "data": {
    "type": "message",
    "conversationId": "conv_123",
    "deepLink": "app://chat/conv_123"
  },
  "android": {
    "priority": "high",
    "notification": { "channel_id": "messages" }
  },
  "apns": {
    "payload": {
      "aps": { "sound": "default", "badge": 1, "category": "MESSAGE" }
    }
  }
}
```