flags.json

{
  "_comment": "DEFAULT SEED / documentation only. Live per-platform flags are managed in the internal dashboard (Cloudflare KV, edited at https://dashboard.cumulusvpn.com/admin) and served at https://dashboard.cumulusvpn.com/api/flags, which the app fetches at launch. If the app can't fetch flags it fails closed to OFF. Seed KV from this file (values below, without the _comment keys).",
  "_comment_inAppUpgrade": "CRYPTO purchase UI (QR + wallet hand-off + FLUX price). A store-policy violation if shown in store builds (Apple 3.1.1 / Google Play Payments), so store builds MUST keep this OFF — when OFF the app shows no crypto purchase UI at all. Enable only for direct-APK / off-store Android builds, and NEVER while a Play build from the same binary is live (they share the flag endpoint). iOS is additionally hard-disabled at build level (clients/mobile/src/lib/flags.ts PURCHASE_UI_PLATFORMS), so 'ios': true would have no effect there.",
  "_comment_iapPurchase": "STORE-BILLING purchase UI (Apple IAP / Google Play Billing subscriptions via the payments bridge, docs/18-payments-bridge.md). Store-compliant by construction — this flag is a rollout/kill switch, NOT a compliance shield. It MUST be ON in KV for a platform BEFORE a build containing the subscribe UI is submitted for review (reviewers must find the declared subscriptions; fail-closed flags would hide them and cause a rejection), and may be flipped OFF afterwards only as an emergency kill switch (bridge outage).",
  "_comment_voucherRedeem": "In-app redeem box for OUR voucher/promo codes (docs/18). Direct-APK Android only: Apple 3.1.1 prohibits custom unlock codes (iOS is hard-off at build level in flags.ts VOUCHER_REDEEM_PLATFORMS), and Play policy matches — keep OFF in KV while a Play build is live (same binary). iOS/Play users redeem our codes on the web (Settings shows a Device code) or use the store-sanctioned offer-code sheets, which ride with iapPurchase, not this flag.",
  "inAppUpgrade": {
    "android": false,
    "ios": false
  },
  "iapPurchase": {
    "android": false,
    "ios": false
  },
  "voucherRedeem": {
    "android": false,
    "ios": false
  }
}