iOS Feature Flags

Supported on: iOS SDK 1.0.61+

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.

Check a Flag

if AppDNA.features.isEnabled("dark_mode") {
    enableDarkMode()
}

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

Module Access

let features = AppDNA.features

Module Methods

Method	Signature	Description
`isEnabled`	`isEnabled(_ flag: String) -> Bool`	Check if a feature flag is enabled
`getVariant`	`getVariant(_ flag: String) -> Any?`	Get the variant value for a flag

Using Flags with Experiments

Feature flags and experiments work together. A common pattern is to gate a feature behind a flag, then run an experiment to test its impact:

// Flag controls whether the feature is available at all
if AppDNA.features.isEnabled("new_workout_ui") {
    // Experiment controls which variant of the feature to show
    let variant = AppDNA.experiments.getVariant("workout_ui_test")

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

Listen for Flag Changes

Register a closure that is called on the main thread once after every successful config fetch — at configure, when the config TTL expires, and on AppDNA.remoteConfig.refresh() — whether or not a flag changed. Re-read the flags you care about:

AppDNA.features.onChanged {
    // Feature flags were updated
    let isPremium = AppDNA.features.isEnabled("premium_features")
}

Full Example

import AppDNASDK

class FeatureGate {
    func checkAccess(feature: String, onLocked: () -> Void, onUnlocked: () -> Void) {
        if AppDNA.features.isEnabled(feature) {
            onUnlocked()
        } else {
            onLocked()
        }
    }
}

// Usage
let gate = FeatureGate()

gate.checkAccess(feature: "ai_suggestions",
    onLocked: {
        // Show upgrade prompt or paywall
        AppDNA.paywall.present("premium_paywall", from: self, context: PaywallContext(placement: "feature_gate"))
    },
    onUnlocked: {
        showAISuggestions()
    }
)

Feature flags are managed in the Console under Settings > Feature Flags. Toggle a flag on or off and it takes effect on the next SDK config refresh (within the TTL window, default 1 hour).

​Check a Flag

​Module Access

​Module Methods

​Using Flags with Experiments

​Listen for Flag Changes

​Full Example

Check a Flag

Module Access

Module Methods

Using Flags with Experiments

Listen for Flag Changes

Full Example