Skip to main content
Supported on: iOS SDK 1.0.61+ · Android SDK 1.0.33+ · React Native SDK 1.0.4+
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

import { AppDNA } from '@appdna/react-native-sdk';

const value = await AppDNA.remoteConfig.get('welcome_message');
const welcome = (value as string | undefined) ?? 'Hello!';
get returns Promise<unknown> — the value type matches whatever you configured in the Console (string, number, boolean, or JSON object). Cast to the type you expect and supply a fallback for the undefined case.

​
Reading Other Types

const retries = ((await AppDNA.remoteConfig.get('max_retries')) as number | undefined) ?? 3;
const discount = ((await AppDNA.remoteConfig.get('discount_rate')) as number | undefined) ?? 0.1;
const promoOn = ((await AppDNA.remoteConfig.get('show_promo')) as boolean | undefined) ?? false;

// JSON values arrive as plain JS objects across the bridge.
const raw = await AppDNA.remoteConfig.get('hero_banner');
const banner = typeof raw === 'object' && raw !== null
  ? (raw as Record<string, unknown>)
  : null;

​
Get All Values

const all = await AppDNA.remoteConfig.getAll();
console.log(`Loaded ${Object.keys(all).length} config keys`);
getAll returns a Record<string, unknown> 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

const remoteConfig = AppDNA.remoteConfig;

​
Module Methods

MethodSignatureDescription
getget(key: string): Promise<unknown>Read a single config value (cast to the expected type)
getAllgetAll(): Promise<Record<string, unknown>>Read every cached key/value pair
refreshrefresh(): Promise<void>Force a refresh from the server
onChangedonChanged(callback: (config: Record<string, unknown>) => void): () => voidRegister a callback that fires when values change. Returns an unsubscribe function.

​
Typed Helpers

If you prefer typed accessors at the call site, add a small helper module. This keeps the SDK surface small while giving your codebase a typed feel. 
import { AppDNA } from '@appdna/react-native-sdk';

export const TypedRemoteConfig = {
  async getString(key: string, fallback = ''): Promise<string> {
    const v = await AppDNA.remoteConfig.get(key);
    return typeof v === 'string' ? v : fallback;
  },

  async getInt(key: string, fallback = 0): Promise<number> {
    const v = await AppDNA.remoteConfig.get(key);
    if (typeof v === 'number') return Math.trunc(v);
    return fallback;
  },

  async getDouble(key: string, fallback = 0.0): Promise<number> {
    const v = await AppDNA.remoteConfig.get(key);
    return typeof v === 'number' ? v : fallback;
  },

  async getBool(key: string, fallback = false): Promise<boolean> {
    const v = await AppDNA.remoteConfig.get(key);
    return typeof v === 'boolean' ? v : fallback;
  },

  async getJson(key: string): Promise<Record<string, unknown> | null> {
    const v = await AppDNA.remoteConfig.get(key);
    return typeof v === 'object' && v !== null ? (v as Record<string, unknown>) : null;
  },
};
Call them like this: 
const welcome = await TypedRemoteConfig.getString('welcome_message', 'Hello!');
const retries = await TypedRemoteConfig.getInt('max_retries', 3);

​
When Config Refreshes

The SDK refreshes remote config automatically:
  • On app launch — if the cached config has expired (default TTL: 1 hour)
  • On return from background — same TTL check
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). The default is 3600 seconds (1 hour).

​
Listen for Config Changes

onChanged fires once per refresh whenever the SDK receives updated config from the server. Re-read the keys you care about inside the callback. Returns an unsubscribe function. 
const unsubscribe = AppDNA.remoteConfig.onChanged(async () => {
  const show = ((await AppDNA.remoteConfig.get('show_promo')) as boolean | undefined) ?? false;
  updatePromoBanner(show);
});

​
Full Example

import React, { useEffect, useState } from 'react';
import { View, Text } from 'react-native';
import { AppDNA } from '@appdna/react-native-sdk';

export function HomeScreen() {
  const [title, setTitle] = useState('Welcome');
  const [showBanner, setShowBanner] = useState(false);
  const [bannerText, setBannerText] = useState('');

  useEffect(() => {
    loadConfig();
    const unsubscribe = AppDNA.remoteConfig.onChanged(loadConfig);
    return unsubscribe;
  }, []);

  async function loadConfig() {
    const t = ((await AppDNA.remoteConfig.get('home_title')) as string | undefined) ?? 'Welcome';
    const sb = ((await AppDNA.remoteConfig.get('show_promo_banner')) as boolean | undefined) ?? false;
    const bt = ((await AppDNA.remoteConfig.get('promo_banner_text')) as string | undefined) ?? '';

    setTitle(t);
    setShowBanner(sb);
    setBannerText(bt);
  }

  return (
    <View>
      <Text style={{ fontSize: 24, fontWeight: 'bold' }}>{title}</Text>
      {showBanner ? <Text>{bannerText}</Text> : null}
      {/* Rest of the home screen */}
    </View>
  );
}
Remote config values are managed in the Console under Settings > Remote Config. Changes take effect on the next SDK config refresh.