flutter_insider 5.0.3

Flutter plugin wrapping the Insider mobile SDK for user tracking, custom events, push notifications, smart recommendations, and App Cards.

Insider Flutter SDK

Official Flutter plugin for the Insider marketing and growth platform. Wraps the native Insider SDK on Android and iOS and exposes its features — user identification, event tracking, product and purchase events, push notifications, smart recommendations, content optimizer, message center and App Cards — through a unified Dart API.

Installation

Add the plugin to your pubspec.yaml:

flutter pub add flutter_insider

Platform requirements

Platform	Minimum
Flutter	>=2.8.0
Dart	>=2.15.0 <4.0.0
Android	minSdk 24, compileSdk 36
iOS	deployment target 12.0

After adding the plugin on iOS, run:

cd ios && pod install

For Android, the plugin pulls in Firebase Messaging, Google Play Services location, and Huawei HMS push as transitive dependencies. No extra Gradle configuration is required.

Quick start

import 'package:flutter_insider/flutter_insider.dart';
import 'package:flutter_insider/enum/InsiderCallbackAction.dart';

Future<void> bootstrapInsider() async {
  await FlutterInsider.Instance.init(
    'YOUR_PARTNER_NAME',
    'group.com.example.app', // iOS App Group; pass any value on Android.
    (int actionType, dynamic data) {
      switch (actionType) {
        case InsiderCallbackAction.NOTIFICATION_OPEN:
          // Handle push tap.
          break;
        case InsiderCallbackAction.INAPP_BUTTON_CLICK:
          // Handle in-app button tap.
          break;
      }
    },
  );

  // Identify the user.
  FlutterInsider.Instance
      .getCurrentUser()
      ?.setName('Ada')
      .setEmail('[e-mail]')
      .setEmailOptin(true);

  // Tag a custom event with typed parameters.
  await FlutterInsider.Instance
      .tagEvent('add_to_favorites')
      .addParameterWithString('product_id', 'sku-123')
      .addParameterWithDouble('price', 29.99)
      .build();
}

Features

Area	API entry point
User attributes & login	FlutterInsider.getCurrentUser() → FlutterInsiderUser
Custom events	FlutterInsider.tagEvent → FlutterInsiderEvent
Product / purchase events	visitProductDetailPage, itemAddedToCart, itemPurchased, cartCleared, visitWishlistPage
Smart recommendations	getSmartRecommendation, getSmartRecommendationWithProduct, getSmartRecommendationWithProductIDs
Content optimizer	getContentStringWithName, getContentIntWithName, getContentBoolWithName
Push notifications	setPushToken, handleNotification, setForegroundPushCallback
Message center	getMessageCenterData, getMessageCenterDataWithIdentifiers
App Cards	FlutterInsider.appCards → FlutterInsiderAppCards
GDPR / privacy	setGDPRConsent, setMobileAppAccess, enableIDFACollection, enableIpCollection, enableLocationCollection

Full API reference: https://pub.dev/documentation/flutter_insider/latest

Documentation

• API reference: https://pub.dev/documentation/flutter_insider/latest
• Insider partner docs: https://useinsider.com
• Issue tracker: https://github.com/useinsider/flutter-insider/issues

License

See LICENSE.