Flutter Remote Config

Supported on: iOS SDK 1.0.61+ · Android SDK 1.0.33+ · Flutter SDK 1.0.3+

The remote config module delivers key-value pairs from the AppDNA Console to your app. Reads are served from an in-memory cache populated at SDK launch, so they return quickly without a network round trip.

Get a Config Value

final value = await AppDNA.remoteConfig.get("welcome_message");
final welcome = (value as String?) ?? "Hello!";

get returns Future<dynamic> — the value type matches whatever you configured in the Console (string, number, boolean, or JSON map). Cast to the type you expect and supply a fallback for the null case.

Reading Other Types

final retries = (await AppDNA.remoteConfig.get("max_retries") as int?) ?? 3;
final discount = (await AppDNA.remoteConfig.get("discount_rate") as double?) ?? 0.1;
final promoOn = (await AppDNA.remoteConfig.get("show_promo") as bool?) ?? false;

// JSON values arrive as Map<dynamic, dynamic> from the platform channel.
final raw = await AppDNA.remoteConfig.get("hero_banner");
final banner = raw is Map ? Map<String, dynamic>.from(raw) : null;

Get All Values

final all = await AppDNA.remoteConfig.getAll();
print("Loaded ${all.length} config keys");

getAll returns a Map<String, dynamic> containing every key the SDK currently has cached.

Force a Refresh

await AppDNA.remoteConfig.refresh();

refresh pulls the latest config from the server. The SDK already refreshes automatically (see below) — call this explicitly only when you need fresh values right now (e.g. after a user changes their preferences in another tab).

Module Access

final remoteConfig = AppDNA.remoteConfig;

Module Methods

Method	Signature	Description
`get`	`Future<dynamic> get(String key)`	Read a single config value (cast to the expected type)
`getAll`	`Future<Map<String, dynamic>> getAll()`	Read every cached key/value pair
`refresh`	`Future<void> refresh()`	Force a refresh from the server
`onChanged`	`void onChanged(Function callback)`	Register a callback that fires when values change

Typed Helpers

If you prefer typed accessors at the call site, add a Dart extension on the module. This keeps the SDK surface small while giving your codebase a typed feel.

extension TypedRemoteConfig on AppDNARemoteConfigModule {
  Future<String> getString(String key, {String fallback = ''}) async {
    final v = await get(key);
    return (v as String?) ?? fallback;
  }

  Future<int> getInt(String key, {int fallback = 0}) async {
    final v = await get(key);
    if (v is int) return v;
    if (v is num) return v.toInt();
    return fallback;
  }

  Future<double> getDouble(String key, {double fallback = 0.0}) async {
    final v = await get(key);
    if (v is double) return v;
    if (v is num) return v.toDouble();
    return fallback;
  }

  Future<bool> getBool(String key, {bool fallback = false}) async {
    final v = await get(key);
    return (v as bool?) ?? fallback;
  }

  Future<Map<String, dynamic>?> getJson(String key) async {
    final v = await get(key);
    if (v is Map) return Map<String, dynamic>.from(v);
    return null;
  }
}

Call them like this:

final welcome =
    await AppDNA.remoteConfig.getString("welcome_message", fallback: "Hello!");
final retries =
    await AppDNA.remoteConfig.getInt("max_retries", fallback: 3);

When Config Refreshes

The SDK refreshes remote config automatically:

At configure — once the bootstrap succeeds, the native SDK fetches the config, whatever the cache’s age. If the bootstrap failed (for example, offline at launch), the fetch runs when a retry of the bootstrap succeeds — the SDK retries it when the network comes back, on foreground and after a backoff (Offline-first).
When the TTL elapses — after each successful fetch the native SDK fetches again once the config is older than the TTL (default 1 hour)
On Android, in the background — a WorkManager job fetches every 15 minutes while the device is online; it skips a run when the SDK is not configured in that process

The SDK does not fetch on return from the background (on either platform) and does not listen for Console changes in real time. AppDNA.remoteConfig.refresh() (or AppDNA.forceRefreshConfig()) fetches at once, bypassing the TTL. If the fetch fails, the SDK continues using cached values. On first launch with no connectivity, bundled config defaults are used.

The config TTL is configurable via AppDNAOptions(configTTL: 7200) (in seconds). When you do not set it, the value the server returns with the SDK’s bootstrap request applies once the bootstrap succeeds, if it is positive; otherwise 3600 seconds (1 hour).

Listen for Config Changes

onChanged fires after each config fetch from the server, whether or not a value changed: on iOS once per successful fetch, on Android once or more per fetch. Re-read the keys you care about inside the callback.

AppDNA.remoteConfig.onChanged(() async {
  final show =
      (await AppDNA.remoteConfig.get("show_promo") as bool?) ?? false;
  updatePromoBanner(visible: show);
});

Full Example

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

class HomeScreen extends StatefulWidget {
  @override
  State<HomeScreen> createState() => _HomeScreenState();
}

class _HomeScreenState extends State<HomeScreen> {
  String _title = "Welcome";
  bool _showBanner = false;
  String _bannerText = "";

  @override
  void initState() {
    super.initState();
    AppDNA.remoteConfig.onChanged(_loadConfig);
    _loadConfig();
  }

  Future<void> _loadConfig() async {
    final title =
        (await AppDNA.remoteConfig.get("home_title") as String?) ?? "Welcome";
    final showBanner =
        (await AppDNA.remoteConfig.get("show_promo_banner") as bool?) ?? false;
    final bannerText =
        (await AppDNA.remoteConfig.get("promo_banner_text") as String?) ?? "";

    if (!mounted) return;
    setState(() {
      _title = title;
      _showBanner = showBanner;
      _bannerText = bannerText;
    });
  }

  @override
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(title: Text(_title)),
      body: Column(
        children: [
          if (_showBanner)
            MaterialBanner(
              content: Text(_bannerText),
              actions: [
                TextButton(onPressed: () {}, child: const Text("Learn More")),
              ],
            ),
          // Rest of the home screen
        ],
      ),
    );
  }
}

Remote config values are managed in the Console under Settings → SDK → Config Bundle, in the Remote Config card (Add Flag, then Save & Sync). Changes take effect on the next SDK config refresh.

​Get a Config Value

​Reading Other Types

​Get All Values

​Force a Refresh

​Module Access

​Module Methods

​Typed Helpers

​When Config Refreshes

​Listen for Config Changes

​Full Example

Get a Config Value

Reading Other Types

Get All Values

Force a Refresh

Module Access

Module Methods

Typed Helpers

When Config Refreshes

Listen for Config Changes

Full Example