AGENT SKILL
flutter-notifications
Push and local notifications for Flutter using FCM and flutter_local_notifications. Use when integrating push or local notifications in Flutter apps. (triggers: **/*notification*.dart, **/main.dart, FirebaseMessaging, FlutterLocalNotificationsPlugin, FCM, notification, push)
- License 许可
- MIT
- 最近更新
- 2026-06-24
- Stars
- ★ 66
- Forks
- 24
01 前言 Front Matter
- name
- flutter-notifications
- description
- Push and local notifications for Flutter using FCM and flutter_local_notifications. Use when integrating push or local notifications in Flutter apps. (triggers: **/*notification*.dart, **/main.dart, FirebaseMessaging, FlutterLocalNotificationsPlugin, FCM, notification, push)
03 SKILL.md 正文
Flutter Notifications
Priority: P1 (OPERATIONAL)
Push and local notifications interactions.
Guidelines
- Stack: Use
firebase_messaging(Push) +flutter_local_notifications(Local/Foreground). - Lifecycle: Handle all 3 states explicitly: Foreground, Background, Terminated.
- Permissions: Prime users with a custom dialog explaining benefits before system request.
- Navigation: Validate notification payload data strictly before navigating.
- Badges: Manually clear iOS app badges when visiting relevant screens.
Anti-Patterns
- No Unconditional Permission: Don't ask on startup without context.
- No Missing State Handlers: Forgetting
getInitialMessage()breaks "open from terminated". - No Forgotten Badge Clear: Leaving notifications un-cleared frustrates users.
- No Direct Navigation: Parsing JSON payloads without validation leads to crashes.
Related Topics
flutter-navigation | mobile-ux-core | firebase/fcm
