React Native Feature Flags

Supported on: iOS SDK 1.0.70+ · Android SDK 1.0.42+ · React Native SDK 1.0.7+ (New Architecture only)

The feature flags module lets you enable or disable features remotely from the AppDNA Console. Flags are evaluated locally from cached config — no network call, no latency on the hot path.

Check a Flag

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

declare function enableDarkMode(): void;

if (await AppDNA.features.isEnabled('dark_mode')) {
  enableDarkMode();
}

isEnabled() returns false by default if the flag does not exist or config has not loaded.

What counts as enabled

A flag’s stored value is not always a boolean — the server treats a string-typed flag as first-class — so isEnabled() coerces, identically on both platforms:

Stored value	`isEnabled()`
a boolean	that boolean
a number	`true` when it is non-zero
a string	`true` for `true`, `1`, `yes` or `on` — trimmed and case-insensitive; anything else is `false`
missing, or any other type	`false`

Use getVariant() when you need the raw value rather than this coercion — a string flag carrying a variant name, for example, where isEnabled() would answer false for every name that is not one of the four above.

Multi-Variant Flags

For flags that carry a string, number, or JSON payload (rather than a simple on/off), read the value with getVariant:

declare function showCompactHome(): void;
declare function showDetailedHome(): void;
declare function showDefaultHome(): void;

const variant = await AppDNA.features.getVariant('home_layout');

switch (variant) {
  case 'compact':
    showCompactHome();
    break;
  case 'detailed':
    showDetailedHome();
    break;
  default:
    showDefaultHome();
}

getVariant returns unknown — cast to the type you configured in the Console.

Module Access

const features = AppDNA.features;

Module Methods

Method	Signature	Description
`isEnabled`	`isEnabled(flag: string): Promise<boolean>`	Check if a feature flag is enabled
`getVariant`	`getVariant(flag: string): Promise<unknown>`	Get the variant payload for a multi-variant flag
`onChanged`	`onChanged(callback: () => void): () => void`	Register a callback that fires after each remote config fetch, whether or not a flag value changed (on iOS once per fetch; on Android once or more per fetch). The callback receives no arguments — re-read the flags you care about. Returns an unsubscribe function.

Using Flags with Experiments

Gate a feature behind a flag, then run an experiment to test its impact:

declare function showCompactWorkoutUI(): void;
declare function showDetailedWorkoutUI(): void;
declare function showDefaultWorkoutUI(): void;
declare function showLegacyWorkoutUI(): void;

if (await AppDNA.features.isEnabled('new_workout_ui')) {
  const variant = await AppDNA.experiments.getVariant('workout_ui_test');

  switch (variant) {
    case 'compact':
      showCompactWorkoutUI();
      break;
    case 'detailed':
      showDetailedWorkoutUI();
      break;
    default:
      showDefaultWorkoutUI();
  }
} else {
  showLegacyWorkoutUI();
}

React to Flag Changes

declare function reloadHomeScreen(): void;

// The callback receives NO arguments — re-read the flags you care about.
const unsubscribe = AppDNA.features.onChanged(() => {
  // Reload any UI that depends on feature flags.
  reloadHomeScreen();
});

// Later, when you no longer need updates:
unsubscribe();

The callback fires once per refresh, not per flag. Re-read the flags you care about inside the callback.

Full Example

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

declare function showAISuggestions(): void;

export class FeatureGate {
  async checkAccess(
    feature: string,
    options: { onLocked: () => void; onUnlocked: () => void },
  ): Promise<void> {
    if (await AppDNA.features.isEnabled(feature)) {
      options.onUnlocked();
    } else {
      options.onLocked();
    }
  }
}

// Usage
const gate = new FeatureGate();

await gate.checkAccess('ai_suggestions', {
  onLocked: () => {
    void AppDNA.paywall.present('premium_paywall', { placement: 'feature_gate' });
  },
  onUnlocked: () => {
    showAISuggestions();
  },
});

// React to remote changes
AppDNA.features.onChanged(() => {
  // Re-evaluate gates when flags refresh.
});

Feature flags are managed in the Console under Settings > Feature Flags. Toggle a flag and it takes effect on the next SDK config refresh — when the TTL elapses (default 1 hour), at Android’s background refresh every 15 minutes, or immediately if you call AppDNA.remoteConfig.refresh(), which bypasses the TTL. iOS runs no background fetch, so there the TTL and that call are the only two.

​Check a Flag

​What counts as enabled

​Multi-Variant Flags

​Module Access

​Module Methods

​Using Flags with Experiments

​React to Flag Changes

​Full Example

Check a Flag

What counts as enabled

Multi-Variant Flags

Module Access

Module Methods

Using Flags with Experiments

React to Flag Changes

Full Example