AppAmbit Flutter SDK

Track. Debug. Distribute. AppAmbit: track, debug, and distribute your apps from one dashboard.

Lightweight SDK for analytics, events, logging, crashes, and offline support. Simple setup, minimal overhead.

Full product docs live here: docs.appambit.com

Contents

Features

  • Session analytics with automatic lifecycle tracking
  • Event tracking with custom properties
  • Error logging for quick diagnostics
  • Crash capture with stack traces and threads
  • Offline support with batching, retry, and queue
  • Create mutliple app profiles for staging and production
  • Small footprint

Requirements

  • Flutter SDK >=3.3.0
  • Dart SDK >=3.9.0
  • Android SDK with:
    • Android 5.0+
    • compileSdkVersion 34
    • targetSdkVersion 34
    • minSdkVersion 21
  • iOS SDK with:
    • Xcode 15+ (for iOS)
    • macOS 13+

Install

Add the AppAmbit Flutter SDK to your app’s pubspec.yml.

dependencies:
  flutter:
    sdk: flutter
  appambit_sdk_flutter: ^0.0.1

and then

flutter pub get

Or add it using

flutter pub add appambit_sdk_flutter

Quickstart

Initialize the SDK with your API key.

Dart

void main() async {
  WidgetsFlutterBinding.ensureInitialized();

  AppambitSdk.start(appKey: '<YOUR-APPKEY>');

  runApp(const MyApp());
}

Android App Requirements

Add these permissions to your AndroidManifest.xml:

<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
<uses-permission android:name="android.permission.INTERNET" />

Usage

  • Session activity – automatically tracks user session starts, stops, and durations
  • Track events – send structured events with custom properties

Dart

await AppambitSdk.trackEvent('ButtonClicked', <String, String>{'Count': '41'});

Dart

try {
    throw Exception('Test with Properties');
} catch (e, st) {
    await AppambitSdk.logError(
    exception: e,
    stackTrace: st,
    properties: <String, String>{'user_id': '1'}
    );
}
  • Crash Reporting: uncaught crashes are automatically captured and uploaded on next launch

Release Distribution

  • Push the artifact to your AppAmbit dashboard for distribution via email and direct installation.

Privacy and Data

  • The SDK batches and transmits data efficiently
  • You control what is sent — avoid secrets or sensitive PII
  • Supports compliance with Google Play policies

For details, see the docs: docs.appambit.com

Troubleshooting

  • No data in dashboard → check API key, endpoint, and network access
  • Flutter dependency not resolving → run flutter clean and flutter pub get and verify again
  • Crash not appearing → crashes are sent on next launch

Contributing

We welcome issues and pull requests.

  • Fork the repo
  • Create a feature branch
  • Add tests where applicable
  • Open a PR with a clear summary

Please follow Dart API design guidelines and document public APIs.

Versioning

Semantic Versioning (MAJOR.MINOR.PATCH) is used.

  • Breaking changes → major
  • New features → minor
  • Fixes → patch

Security

If you find a security issue, please contact us at hello@appambit.com rather than opening a public issue.

License

Open source under the terms described in the LICENSE file.

Libraries

appambit_sdk_flutter
appambit_sdk_flutter_method_channel
appambit_sdk_flutter_platform_interface