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('ada@example.com')
      .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: pub.dev/documentation/flutter_insider/latest

Documentation

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

License

See LICENSE.