Custom axes¶

Axes are the recommended way to model domain-specific targeting dimensions. Use them when your rules depend on values like environment, product line, tenant, or region.

Define the axis values¶

An axis value is an enum that implements AxisValue<T>.

import io.amichne.konditional.context.axis.AxisValue

enum class Environment : AxisValue<Environment> {
    DEV,
    PROD,
}

You can derive the axis handle later with Axis.of<Environment>() when you need typed access to the grouped values.

Add the axis to the context¶

Expose the selection through the context's axes property.

import io.amichne.konditional.context.Context
import io.amichne.konditional.context.axis.axes

data class RuntimeContext(
    val environment: Environment,
) : Context {
    override val axes = axes(environment)
}

Target the axis in a rule¶

Use constrain(...) in the rule DSL to target one or more axis values.

object RuntimeFlags : Namespace("runtime") {
    val diagnostics by boolean<RuntimeContext>(default = false) {
        enable {
            constrain(Environment.PROD)
        }
    }
}

That rule only matches contexts whose environment axis includes PROD.

Next steps¶

After you add a custom axis, the next useful task is usually testing. The testing guide shows how to prove that axis targeting and other invariants stay stable.

• Read the testing guide