# Li Lance Android Seraphim Framework Flutter Notifications

> Flutter Notifications

- Skill: `tomevault-io/li-lance-android-seraphim-framework-flutter-notifications` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add tomevault-io/li-lance-android-seraphim-framework-flutter-notifications`
- Raw SKILL.md: https://api.skillmd.com/api/skills/tomevault-io/li-lance-android-seraphim-framework-flutter-notifications/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: tomevault-io (https://skillmd.com/u/tomevault-io)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/tomevault-io/li-lance-android-seraphim-framework-flutter-notifications

---


# Flutter Notifications

## **Priority: P1 (OPERATIONAL)**

Push and local notification handling using `firebase_messaging` and `flutter_local_notifications`.

## Implementation Workflow

1. **Set up packages** — Add `firebase_messaging` (Push) and `flutter_local_notifications` (
   Local/Foreground).
2. **Request permission** — Prime users with a custom dialog explaining benefits _before_ the 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](references/implementation.md) for foreground, background, and
terminated state notification handling.

[Implementation Details](references/implementation.md)

## Anti-Patterns

- ❌ Requesting permission on startup without context — show a primer dialog first
- ❌ Missing `getInitialMessage()` handler — breaks "open from terminated" state
- ❌ Leaving badges un-cleared — frustrates users; clear on relevant screen visits
- ❌ Navigating from raw JSON payloads without validation — causes crashes on malformed data

## Related Topics

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

---
> Source: [li-lance/android-seraphim-framework](https://github.com/li-lance/android-seraphim-framework) — distributed by [TomeVault](https://tomevault.io).
<!-- tomevault:4.0:skill_md:2026-06-16 -->