Flags

A flag is a typed switch with a default value and an owner. flagctl supports two kinds: boolean (on/off) and multi-variant (one of N string values).

Boolean

checkout.v2:
type: bool
default: false
owner: payments
purpose: Roll out the new checkout flow.

Multi-variant

theme:
type: string
default: light
variants: [light, dark, system]
owner: design
purpose: Default UI theme for signed-out users.

Owners and purpose

owner is a team handle (e.g. payments, design). purpose is a one-line description shown in the dashboard and surfaced in PR comments. Both are required — flagctl rejects flag definitions without them.