Overview
shipd.config.ts by default).
Flag types
Boolean
Variant
Number
JSON
Normalized output
defineFlags returns { version: 1, flags: { ... } } with key, tags: string[], and lifecycle: "active" | "deprecated" on each flag (deprecated: true → lifecycle: "deprecated").
Typegen
shipd push, shipd pull, and shipd types gen write src/generated/flags.ts unless .shipd/config.json sets typesOut:
.shipd/config.json
createClient<FlagDefinitions> and createShipdReact<FlagDefinitions>().
Scope reminder
Guides: Define flags in code.