Create a boolean flag

Overview

Add a boolean flag (toggle / switch / gate) named new-checkout to Fieldkit’s web-app, push it, and branch on it.

Steps

Define it

shipd.config.ts

import { defineFlags } from "shipdit/config";

export default defineFlags({
  "new-checkout": {
    type: "boolean",
    default: false,
    description: "Redesigned checkout flow",
    tags: ["checkout"],
  },
});

Push

shipd push --project web-app --env production --yes

Evaluate

if (shipd.isEnabled("new-checkout", { userId: "usr_8f2k19" })) {
  return renderNewCheckout();
}
return renderLegacyCheckout();

const on = useFlag("new-checkout");

Off by default until a dashboard rule or fallthrough serves true. Targeting is not in shipd.config.ts — see Target users. CLI one-off (no config file):

shipd flags create --key new-checkout --type boolean --description "Redesigned checkout flow"

Prefer defineFlags + shipd push so the repo stays source of truth.

⌘I

Getting started

Guides

How-to

Concepts

Reference

Create a boolean flag

Overview

Steps

​Overview

​Steps

Overview

Steps