# zicula-feature-flags-kit — free sample

Three real files from the full kit (11 files), each **trimmed to taste** — enough to
judge the quality, not enough to skip the buy:

- `evaluate-demo.mjs` — the evaluation engine cut from the real `worker/worker.mjs`:
  the deterministic bucketing functions and `evaluateFlag()` are copied verbatim,
  plus a tiny demo harness. **Run it now — no install:** `node evaluate-demo.mjs`
  and watch a 25% rollout split six users the same way every time. What the demo
  does NOT include is the other ~90% of the Worker: the HTTP routes (snapshot with
  ETag/304, single + batch evaluate, CORS), the fail-closed admin API (create /
  update / delete, import, export, publish-to-KV), the D1 source of truth and KV
  edge cache.
- `SETUP-steps-1-4.md` — steps 1–4 of the real `SETUP.md`, word-for-word: log in,
  create D1 + KV, apply the schema, set the admin token. See for yourself that the
  deploy really is copy-paste. The full guide continues from step 5 (deploy →
  verify → wire a client → a second env) to a live flag API in ~20–30 minutes,
  plus a troubleshooting table.
- `schema-preview.sql` — the `flags` table from the real `schema.sql`, verbatim:
  kill switch, rollout percent, typed values (boolean / string / number / json),
  idempotent. The full file adds the `audit_log` table behind the cut.

What the full kit adds (the rest of the 11 files):

- **The product:** the complete zero-dependency `worker.mjs` (~24 KB) — flag
  snapshot API, per-user and batch evaluation, admin CRUD, LaunchDarkly-style
  import, JSON export, KV snapshot publish, audit log, timing-safe auth
- **The dashboard:** a single-file private admin UI — kill switch, % rollout
  sliders, typed value editor, import/export, and a "check one user" simulator
- **The clients:** an OpenFeature Web SDK provider (`@openfeature/web-sdk`) and a
  Flutter/Dart client, both zero dependencies, both running the exact same
  bucketing math as the Worker — same user, same bucket, every platform
- **The deploy config:** `wrangler.jsonc` with 2 marked edits, and the idempotent
  D1 schema
- **The docs + license:** full `CUSTOMIZE.md` API/SDK reference, `SETUP.md`,
  `MANIFEST.md`, and a single-business commercial license

Runs on Cloudflare's free tier (1 Worker + 1 D1 + 1 KV) — no subscription,
no per-seat fee.

One-time purchase $42 · free updates for v1.x · 14-day full refund.