Install

The SDK ships as a single pub.dev package: insito_flutter. It works in any Flutter app — iOS, Android, and the other Flutter targets.

Requirements

Dependency	Minimum version
Flutter	3.27
Dart	3.6

The package pulls in http and shared_preferences transitively — no extra setup is required. shared_preferences backs the persistent response queue, so responses survive bad networks and app cold-starts.

flutter pub add insito_flutter

dependencies:
  insito_flutter: ^0.1.1

Then run flutter pub get (the flutter pub add command does this for you).

Initialise the SDK

MicroSurvey.init() boots the singleton. Call it once, as early as possible — the top of main() is ideal. It’s async because it seeds the offline queue, screen-map timer, and per-install counters.

main.dart

import 'package:flutter/material.dart';
import 'package:insito_flutter/insito_flutter.dart';

Future<void> main() async {
  WidgetsFlutterBinding.ensureInitialized();

  await MicroSurvey.init(
    const InsitoConfig(
      apiKey: 'proj_xxx',
      debug: true, // set from kDebugMode in real apps
    ),
  );

  runApp(const MyApp());
}

init() validates the key (proj_xxx format) and throws if it’s malformed — easier to catch in development than a delayed network error.

Wire up the provider

InsitoProvider is the widget that renders the survey modal above your app. Wrap it around your MaterialApp (or WidgetsApp/CupertinoApp).

main.dart

class MyApp extends StatelessWidget {
  const MyApp({super.key});

  @override
  Widget build(BuildContext context) {
    return InsitoProvider(
      child: MaterialApp(
        home: const HomeScreen(),
      ),
    );
  }
}

InsitoProvider renders the modal as a sibling of your app and supplies its own Directionality, MediaQuery, Localizations, Theme, and Overlay, so it works no matter where you mount it in the tree.

Identify your user

Once a user signs in (or as early as you have a stable userId), call identify(). The SDK caches identity for 24 hours, so repeat sessions are free.

await MicroSurvey.identify(
  const UserProperties(
    userId: 'user-from-your-auth-system',
    platform: 'ios',
    appVersion: '1.0.0',
  ),
);

Fire a trigger

At any key moment, fire a trigger by name. The server decides whether a survey is eligible; if it is, the modal renders inside InsitoProvider.

MicroSurvey.trigger('checkout_completed');

See Configure for the full InsitoConfig schema, API reference for every method, and the example app for a working MaterialApp setup with screen tracking.

Get started

Concepts

React Native SDK

Flutter SDK

Dashboard

MCP server

Install

Requirements

Install

Initialise the SDK

Wire up the provider

Identify your user

Fire a trigger

​Requirements

​Install

​Initialise the SDK

​Wire up the provider

​Identify your user

​Fire a trigger

Requirements

Install

Initialise the SDK

Wire up the provider

Identify your user

Fire a trigger