App platform

PushEngage for Flutter

Add push notifications and in-app messages to a Flutter app on Android and iOS with the PushEngage Flutter SDK. One Dart package covers both platforms, and campaigns for both run from the same PushEngage dashboard.

What you can do with Flutter

One package for Android and iOS

A single Dart API sits on top of the PushEngage Android and iOS SDKs, delivering through Firebase Cloud Messaging on Android and Apple Push Notification service on iOS.

Deep links as a Dart stream

Listen to a stream that emits the deep link when a notification is tapped, and read the notification that launched the app from a terminated state on iOS.

Segments, attributes, and triggered campaigns

Add subscribers to static or dynamic segments, set custom attributes, and send trigger events, goals, and price drop or inventory alerts from Dart.

In-app messages

Show banners, modals, and full-screen messages designed on the dashboard. No Dart-side setup is needed once the SDK has your App ID.

Platform-specific notification settings

Set an icon, image, groups, and channels for Android, and a media image, sound, category, thread, and badge for iOS, all from the dashboard.

How to set it up

  1. Add pushengage_flutter_sdk to pubspec.yaml and run flutter pub get.
  2. For Android, add the JitPack repository, set up Firebase Cloud Messaging, and enter your Sender ID and Service Account JSON in PushEngage under Site Settings > Installation > Android SDK.
  3. For iOS, open the Runner workspace in Xcode, add Push Notifications and Background Modes, and upload your APNs certificate under the iOS SDK tab in PushEngage.
  4. Add a Notification Service Extension to the iOS project. A Notification Content Extension is optional.
  5. Add the App Groups capability to the Runner target and the extension.
  6. Initialize the SDK in lib/main.dart with your App ID, and add the PushEngage lines to AppDelegate.swift for iOS.
  7. Run on a physical Android or iOS device and send a test from Campaign > Push Broadcasts.

Full guide: Flutter quickstart

Good to know

  • App push and this SDK are listed on every PushEngage plan, including the free plan. Goal tracking, custom triggered campaigns, and in-app messages need a paid plan.
  • The SDK needs Flutter 3.22.2 or later. iOS builds need a deployment target of iOS 15.0 or later.
  • Android needs a Firebase project, and iOS needs an Apple Developer account with an App ID and an APNs certificate.
  • The native Android SDK is pulled from JitPack, so the JitPack repository has to be in your Android Gradle settings.
  • The deep link stream does not fire for taps that launch a terminated app on iOS. Read those with getInitialNotification.
  • Native setup is still required on both sides: Gradle and Firebase for Android, Xcode capabilities and a Notification Service Extension for iOS.

About this connection

  • PushEngage builds and maintains this SDK. It is not a partnership with Google or the Flutter project.
  • The source is public on GitHub in the awesomemotive/pushengage-flutter-sdk repository under the MIT license.
  • The package is published on pub.dev as pushengage_flutter_sdk.
  • PushEngage also publishes open-source Agent Skills, so an AI coding agent such as Claude Code or Cursor can run the integration and diagnose a broken setup.

PushEngage Partner Directory

Ready to add push to your Flutter app? Start with the setup guide.

PushEngage has a free plan, so you can install it and send your first campaign before you pay anything.