# maikub/flutter_local_notifications architecture

> Architecture diagram of the GitHub repository maikub/flutter_local_notifications, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-09-23). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/maikub/flutter_local_notifications
- Repository: https://github.com/maikub/flutter_local_notifications

## Overview

Flutter Local Notifications is a cross-platform Flutter plugin for displaying and managing local notifications. Its main workflow is an app request becoming a platform notification, optionally scheduled, then surfaced to the user; notification activation can return action or payload data to the app. The README also identifies Linux and Windows implementations. The supplied tree and excerpts omit the Dart-facing API, platform interface, Linux implementation, and most platform source, so those components are represented only where the README or tree supports them; some wiring is necessarily omitted.

Main entry points: [`flutter_local_notifications_platform_interface`](https://github.com/maikub/flutter_local_notifications/tree/master/flutter_local_notifications_platform_interface) (Platform interface), [`flutter_local_notifications/android/src/main/java/com/dexterous/flutterlocalnotifications/FlutterLocalNotificationsPlugin.java`](https://github.com/maikub/flutter_local_notifications/blob/master/flutter_local_notifications/android/src/main/java/com/dexterous/flutterlocalnotifications/FlutterLocalNotificationsPlugin.java) (Android plugin), [`flutter_local_notifications_windows/src`](https://github.com/maikub/flutter_local_notifications/tree/master/flutter_local_notifications_windows/src) (Windows plugin), [`flutter_local_notifications/android/src/main/java/com/dexterous/flutterlocalnotifications/ScheduledNotificationReceiver.java`](https://github.com/maikub/flutter_local_notifications/blob/master/flutter_local_notifications/android/src/main/java/com/dexterous/flutterlocalnotifications/ScheduledNotificationReceiver.java) (Schedule receivers)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_api["Flutter interface"]
  node_plugin["Plugin API"]
  node_interface["Platform interface"]
end

subgraph group_mobile["Mobile platforms"]
  node_android["Android plugin"]
  node_android_models["Notification models"]
  node_android_schedule["Schedule receivers"]
  node_android_boot["Boot recovery"]
  node_android_actions["Action receiver"]
  node_foreground["Foreground service"]
  node_ios["iOS plugin"]
end

subgraph group_desktop["Desktop platforms"]
  node_macos["macOS plugin"]
  node_windows["Windows plugin"]
  node_windows_ffi["Windows toast API<br/>[ffi_api.cpp]"]
  node_linux["Linux implementation"]
end

subgraph group_web["Web platform"]
  node_web["Web implementation"]
  node_worker["Click service worker"]
end

node_app(("Flutter app"))
node_os["Platform notification system"]

node_app -->|"requests notifications"| node_plugin
node_plugin -->|"uses interface"| node_interface
node_interface -->|"dispatches platform calls"| node_android
node_interface -->|"dispatches platform calls"| node_ios
node_interface -->|"dispatches platform calls"| node_macos
node_interface -->|"dispatches platform calls"| node_windows
node_interface -.->|"dispatches platform calls"| node_linux
node_interface -->|"dispatches platform calls"| node_web
node_android -->|"parses details"| node_android_models
node_android -->|"schedules notifications"| node_android_schedule
node_android -->|"handles actions"| node_android_actions
node_android -->|"starts service"| node_foreground
node_android_schedule -->|"receives alarms"| node_os
node_android_boot -->|"restores schedules"| node_android_schedule
node_android -->|"posts notifications"| node_os
node_ios -->|"schedules and presents"| node_os
node_macos -->|"schedules and presents"| node_os
node_windows -->|"uses native API"| node_windows_ffi
node_windows_ffi -->|"shows and schedules"| node_os
node_windows -->|"registers activation"| node_os
node_web -->|"requests browser notifications"| node_os
node_os -->|"dispatches click"| node_worker
node_worker -->|"forwards click data"| node_app
node_os -->|"dispatches action"| node_android_actions
node_os -->|"delivers response"| node_ios
node_os -->|"delivers response"| node_macos
node_os -->|"activates callback"| node_windows

click node_plugin "https://github.com/maikub/flutter_local_notifications/tree/master/flutter_local_notifications"
click node_interface "https://github.com/maikub/flutter_local_notifications/tree/master/flutter_local_notifications_platform_interface"
click node_android "https://github.com/maikub/flutter_local_notifications/blob/master/flutter_local_notifications/android/src/main/java/com/dexterous/flutterlocalnotifications/FlutterLocalNotificationsPlugin.java"
click node_android_models "https://github.com/maikub/flutter_local_notifications/blob/master/flutter_local_notifications/android/src/main/java/com/dexterous/flutterlocalnotifications/models/NotificationDetails.java"
click node_android_schedule "https://github.com/maikub/flutter_local_notifications/blob/master/flutter_local_notifications/android/src/main/java/com/dexterous/flutterlocalnotifications/ScheduledNotificationReceiver.java"
click node_android_boot "https://github.com/maikub/flutter_local_notifications/blob/master/flutter_local_notifications/android/src/main/java/com/dexterous/flutterlocalnotifications/ScheduledNotificationBootReceiver.java"
click node_android_actions "https://github.com/maikub/flutter_local_notifications/blob/master/flutter_local_notifications/android/src/main/java/com/dexterous/flutterlocalnotifications/ActionBroadcastReceiver.java"
click node_foreground "https://github.com/maikub/flutter_local_notifications/blob/master/flutter_local_notifications/android/src/main/java/com/dexterous/flutterlocalnotifications/ForegroundService.java"
click node_ios "https://github.com/maikub/flutter_local_notifications/tree/master/flutter_local_notifications/ios/flutter_local_notifications/Sources/flutter_local_notifications"
click node_macos "https://github.com/maikub/flutter_local_notifications/blob/master/flutter_local_notifications/macos/flutter_local_notifications/Sources/flutter_local_notifications/FlutterLocalNotificationsPlugin.swift"
click node_windows "https://github.com/maikub/flutter_local_notifications/tree/master/flutter_local_notifications_windows/src"
click node_windows_ffi "https://github.com/maikub/flutter_local_notifications/blob/master/flutter_local_notifications_windows/src/ffi_api.cpp"
click node_web "https://github.com/maikub/flutter_local_notifications/tree/master/flutter_local_notifications_web"
click node_worker "https://github.com/maikub/flutter_local_notifications/blob/master/flutter_local_notifications_web/web/notifications_service_worker.js"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_plugin,node_interface toneBlue
class node_android,node_android_models,node_android_schedule,node_android_boot,node_android_actions,node_foreground,node_ios toneAmber
class node_macos,node_windows,node_windows_ffi,node_linux toneMint
class node_web,node_worker toneRose
class node_app,node_os toneIndigo
```

## Components

### Flutter interface

- [Plugin API](https://github.com/maikub/flutter_local_notifications/tree/master/flutter_local_notifications): `flutter_local_notifications`
- [Platform interface](https://github.com/maikub/flutter_local_notifications/tree/master/flutter_local_notifications_platform_interface): `flutter_local_notifications_platform_interface`

### Mobile platforms

- [Android plugin](https://github.com/maikub/flutter_local_notifications/blob/master/flutter_local_notifications/android/src/main/java/com/dexterous/flutterlocalnotifications/FlutterLocalNotificationsPlugin.java): `flutter_local_notifications/android/src/main/java/com/dexterous/flutterlocalnotifications/FlutterLocalNotificationsPlugin.java`
- [Notification models](https://github.com/maikub/flutter_local_notifications/blob/master/flutter_local_notifications/android/src/main/java/com/dexterous/flutterlocalnotifications/models/NotificationDetails.java): `flutter_local_notifications/android/src/main/java/com/dexterous/flutterlocalnotifications/models/NotificationDetails.java`
- [Schedule receivers](https://github.com/maikub/flutter_local_notifications/blob/master/flutter_local_notifications/android/src/main/java/com/dexterous/flutterlocalnotifications/ScheduledNotificationReceiver.java): `flutter_local_notifications/android/src/main/java/com/dexterous/flutterlocalnotifications/ScheduledNotificationReceiver.java`
- [Boot recovery](https://github.com/maikub/flutter_local_notifications/blob/master/flutter_local_notifications/android/src/main/java/com/dexterous/flutterlocalnotifications/ScheduledNotificationBootReceiver.java): `flutter_local_notifications/android/src/main/java/com/dexterous/flutterlocalnotifications/ScheduledNotificationBootReceiver.java`
- [Action receiver](https://github.com/maikub/flutter_local_notifications/blob/master/flutter_local_notifications/android/src/main/java/com/dexterous/flutterlocalnotifications/ActionBroadcastReceiver.java): `flutter_local_notifications/android/src/main/java/com/dexterous/flutterlocalnotifications/ActionBroadcastReceiver.java`
- [Foreground service](https://github.com/maikub/flutter_local_notifications/blob/master/flutter_local_notifications/android/src/main/java/com/dexterous/flutterlocalnotifications/ForegroundService.java): `flutter_local_notifications/android/src/main/java/com/dexterous/flutterlocalnotifications/ForegroundService.java`
- [iOS plugin](https://github.com/maikub/flutter_local_notifications/tree/master/flutter_local_notifications/ios/flutter_local_notifications/Sources/flutter_local_notifications): `flutter_local_notifications/ios/flutter_local_notifications/Sources/flutter_local_notifications`

### Desktop platforms

- [macOS plugin](https://github.com/maikub/flutter_local_notifications/blob/master/flutter_local_notifications/macos/flutter_local_notifications/Sources/flutter_local_notifications/FlutterLocalNotificationsPlugin.swift): `flutter_local_notifications/macos/flutter_local_notifications/Sources/flutter_local_notifications/FlutterLocalNotificationsPlugin.swift`
- [Windows plugin](https://github.com/maikub/flutter_local_notifications/tree/master/flutter_local_notifications_windows/src): `flutter_local_notifications_windows/src`
- [Windows toast API](https://github.com/maikub/flutter_local_notifications/blob/master/flutter_local_notifications_windows/src/ffi_api.cpp): `flutter_local_notifications_windows/src/ffi_api.cpp`
- **Linux implementation**

### Web platform

- [Web implementation](https://github.com/maikub/flutter_local_notifications/tree/master/flutter_local_notifications_web): `flutter_local_notifications_web`
- [Click service worker](https://github.com/maikub/flutter_local_notifications/blob/master/flutter_local_notifications_web/web/notifications_service_worker.js): `flutter_local_notifications_web/web/notifications_service_worker.js`

### Other components

- **Flutter app**
- **Platform notification system**

## Connections

- Flutter app → Plugin API: requests notifications
- Plugin API → Platform interface: uses interface
- Platform interface → Android plugin: dispatches platform calls
- Platform interface → iOS plugin: dispatches platform calls
- Platform interface → macOS plugin: dispatches platform calls
- Platform interface → Windows plugin: dispatches platform calls
- Platform interface → Linux implementation: dispatches platform calls
- Platform interface → Web implementation: dispatches platform calls
- Android plugin → Notification models: parses details
- Android plugin → Schedule receivers: schedules notifications
- Android plugin → Action receiver: handles actions
- Android plugin → Foreground service: starts service
- Schedule receivers → Platform notification system: receives alarms
- Boot recovery → Schedule receivers: restores schedules
- Android plugin → Platform notification system: posts notifications
- iOS plugin → Platform notification system: schedules and presents
- macOS plugin → Platform notification system: schedules and presents
- Windows plugin → Windows toast API: uses native API
- Windows toast API → Platform notification system: shows and schedules
- Windows plugin → Platform notification system: registers activation
- Web implementation → Platform notification system: requests browser notifications
- Platform notification system → Click service worker: dispatches click
- Click service worker → Flutter app: forwards click data
- Platform notification system → Action receiver: dispatches action
- Platform notification system → iOS plugin: delivers response
- Platform notification system → macOS plugin: delivers response
- Platform notification system → Windows plugin: activates callback
