Agent-skills-standard flutter-notifications

Integrate push and local notifications using FCM and flutter_local_notifications. Use when adding push or local notifications to Flutter apps. (triggers: **/*notification*.dart, **/main.dart, FirebaseMessaging, FlutterLocalNotificationsPlugin, FCM, notification, push)

install
source · Clone the upstream repo
git clone https://github.com/HoangNguyen0403/agent-skills-standard
Claude Code · Install into ~/.claude/skills/
T=$(mktemp -d) && git clone --depth=1 https://github.com/HoangNguyen0403/agent-skills-standard "$T" && mkdir -p ~/.claude/skills && cp -r "$T/skills/flutter/flutter-notifications" ~/.claude/skills/hoangnguyen0403-agent-skills-standard-flutter-notifications && rm -rf "$T"
manifest: skills/flutter/flutter-notifications/SKILL.md
source content

Flutter Notifications

Priority: P1 (OPERATIONAL)

Implementation Workflow

  1. Set up packages — Add
    firebase_messaging
    (Push) and
    flutter_local_notifications
    (Local/Foreground).
  2. Request permission — Prime users with custom dialog explaining benefits before system prompt.
  3. Handle all lifecycle states — Implement handlers for Foreground, Background, and Terminated states.
  4. Validate payloads — Strictly validate notification data before navigating to screens.
  5. Clear badges — Manually clear iOS app badges when visiting relevant screens.

Lifecycle Handlers Example

See implementation examples for foreground, background, and terminated state notification handling.

Implementation Details

Anti-Patterns

  • No Early Permission Popups: Show primer dialog explaining value first
  • No Missing
    getInitialMessage()
    : Always handle "open from terminated" startup state
  • No Uncleared Badges: Manually clear notification badges upon related screen visits
  • No Unvalidated Payloads: Validate all JSON data before navigating on click

Related Topics

flutter-navigation | mobile-ux-core | firebase/fcm