appdna_sdk 1.0.21

AppDNA SDK for Flutter — analytics, experiments, paywalls, surveys, and more.

AppDNA SDK for Flutter

The official Flutter SDK for AppDNA — the growth console for subscription apps.

⚠️ Proprietary software. A Commercial Agreement with AppDNA AI, Inc. is required to use this SDK. See LICENSE and NOTICE.md.

Migrating from MIT-licensed v1.0.0 or earlier? See DEPRECATION_NOTICE.md. MIT versions stop receiving server support after 15 May 2026.

What it does

AppDNA gives you a single drop-in SDK for the growth surfaces every subscription app needs, on both iOS and Android from one Dart codebase:

• Analytics & events — track user behavior with batched, offline-resilient delivery.
• Experiments & feature flags — server-driven A/B tests with deterministic variant assignment.
• Paywalls — render console-designed paywall layouts with native StoreKit 2 / Google Play Billing.
• Onboarding flows — multi-step onboarding with form inputs, async hooks, conditional branching, and rich media.
• Surveys & feedback — NPS, CSAT, free text, multi-choice with scheduling and frequency caps.
• In-app messages — modal, banner, fullscreen messages with audience targeting.
• Push notifications — rich content, action buttons, deep links, and delivery analytics.
• Web entitlements & deep links — server-validated entitlements and deferred deep linking.

Requirements

• Flutter 3.10+
• Dart 3.0+
• iOS 16.0+ (when targeting iOS)
• Android API 24+ (when targeting Android)

Installation

Add to your pubspec.yaml:

dependencies:
  appdna_sdk:
    git:
      url: https://github.com/appdna-ai-inc/appdna-sdk-flutter.git
      ref: v1.0.21

Then run:

flutter pub get

For iOS, also run:

cd ios && pod install

Quick start

import 'package:appdna_sdk/appdna_sdk.dart';

await AppDNA.configure('YOUR_API_KEY');

Track an event:

await AppDNA.track('subscription_viewed', {'plan_id': 'premium_monthly'});

Identify a user (after sign-in):

await AppDNA.identify('user-123', {'plan': 'premium'});

Present a paywall:

final result = await AppDNA.presentPaywall(id: 'default');
switch (result) {
  case PaywallResult.purchased:
    print('Purchased');
  case PaywallResult.dismissed:
    print('Dismissed');
  case PaywallResult.failed:
    print('Failed');
}

Native host setup

The SDK renders on the native layer, so a few host-side assets/declarations are required. Full copy-paste instructions are in the docs; the essentials:

Firebase config asset (required for online config + push)

AppDNA loads paywalls, onboarding, experiments, flags, and push over a dedicated Firebase app. Place the config file(s) AppDNA gives you (Settings → SDK → Download Config) as native assets — nothing config-driven loads without them:

• iOS — GoogleService-Info-AppDNA.plist in ios/Runner/.
• Android — google-services-appdna.json in android/app/src/main/assets/.

A cross-platform app downloads both in one ZIP.

Offline-first config bundle (optional)

To ship config for a first launch without network, place appdna-config.json where the native SDK reads it: ios/Runner/ (added to the Runner target's Copy Bundle Resources) and android/app/src/main/assets/, not under flutter: assets:. The native SDK uses it for the sections it has no cached config for; a remote fetch replaces it.

Host permissions (only for flows that use them)

Onboarding flows that request a permission need the matching OS declaration in the host app — e.g. NSCameraUsageDescription / NSCalendarsFullAccessUsageDescription in ios/Runner/Info.plist, or <uses-permission android:name="android.permission.CAMERA"/> in AndroidManifest.xml. A missing declaration doesn't crash — the permission is simply unavailable, so the flow step can't advance. See the docs for the full per-permission table.

Embedded screen slots

Most surfaces (onboarding, paywalls, surveys, messages) present natively over your app. For an inline server-driven screen region, embed the platform-view widget:

AppDNAScreenSlot(name: 'home_hero', height: 220)

Documentation

Full integration guide, configuration reference, and API docs at docs.appdna.ai/sdks/flutter.

Support

• Technical questions: [e-mail]
• Sales / commercial: [e-mail]
• Licensing: [e-mail]

Reporting issues

• 🐞 SDK bug or rendering issue → open an issue using the bug report template.
• 🆕 Missing capability / configuration gap → use the capability gap template on the same page.
• 🔒 Security vulnerability → report privately — see SECURITY.md. Never in a public issue.
• 🖥️ Console / platform issue (not the SDK) → use the Support widget in the console.

This repository is a read-only release mirror — development happens in our internal repository, so we don't accept pull requests here. Issues are very welcome and are triaged into our internal backlog; you'll see a comment on your issue when a fix ships.

License

⚠️ The AppDNA SDK is proprietary software, not open source. This repository is publicly visible for marketing, evaluation, and reference purposes only.

You may NOT download, install, run, modify, or use the SDK without a Commercial Agreement with AppDNA AI, Inc. See LICENSE and NOTICE.md for the full terms.

You MAY view the source on GitHub and read the documentation at https://docs.appdna.ai for evaluation purposes.

To use the SDK in your application, sign up at https://appdna.ai (self-serve) or contact [e-mail] (enterprise).

Existing customers: your Terms of Service or Statement of Work governs your use of the SDK.

Versions before v1.0.1 were distributed under the MIT License — see DEPRECATION_NOTICE.md for the migration timeline (deadline: 15 May 2026).

---

© 2026 AppDNA AI, Inc. All rights reserved. "AppDNA" and the AppDNA logo are trademarks of AppDNA AI, Inc.