Skip to content

FeatureFlip Module

A Kotlin Multiplatform library for managing feature flags (feature toggles) with a built-in UI for toggling and managing features at runtime.

Overview

FeatureFlip enables runtime control of feature flags for development, QA, and experimentation. It supports both local and remote features, persistent state, and a ready-to-use Compose UI.

Features

  • Local and remote feature flags
  • Persistent state with DataStore (Android/iOS)
  • Built-in Compose UI: search, filter, toggle, tri-state controls
  • Type-safe API
  • Multiplatform support

Installation

Add to your build.gradle.kts: 

dependencies {
    implementation(projects.devviewFeatureflip)
}

Integration Example

Add FeatureFlip to your DevView modules list: 

val modules = rememberModules {
    module(FeatureFlip)
    // ...other modules...
}

Quick Start

Defining Features

val darkMode = Feature.LocalFeature(
    name = "dark_mode",
    description = "Enable dark theme",
    isEnabled = false
)
val newCheckout = Feature.RemoteFeature(
    name = "new_checkout_flow",
    description = "Enable the redesigned checkout experience",
    defaultRemoteValue = true,
    state = FeatureState.REMOTE
)

Using the UI

val featureHandler = rememberFeatureHandler(features)
CompositionLocalProvider(LocalFeatureHandler provides featureHandler) {
    // FeatureFlipScreen is rendered automatically by DevView when FeatureFlip is registered.
    // State changes are handled internally by the DevView UI.
}

Usage

  • Use FeatureHandler to manage features programmatically.
  • Use FeatureFlipScreen for a ready-made UI.
  • Features are persisted using DataStore.

Best Practices

  1. Use descriptive names and add descriptions.
  2. Start with REMOTE for remote features, override only for testing.
  3. Persist state for reliability.
  4. Monitor overrides for QA.

Troubleshooting / FAQ

  • Why isn't my feature state persisting?
  • Ensure you use FeatureHandler and DataStore correctly.
  • Check DataStore permissions and initialisation on both Android and iOS.
  • How do I reset a remote feature to remote config?
  • Set its state to FeatureState.REMOTE.
  • Can I use this on iOS?
  • Yes, DataStore is supported on both Android and iOS. Ensure platform-specific initialisation is correct.
  • Feature UI not updating?
  • Confirm you are using Compose state correctly and updating the feature list.
  • Integration issues?
  • Verify module is included in your DevView modules list and dependencies are present.

API Reference

Dokka API Reference