# zicula-shortlink-kit — free sample

Three real files from the full kit (14 files), each **trimmed to taste** —
enough to judge the quality, not enough to run your links on:

- `SETUP-sample.md` — the opening of the SETUP guide, verbatim: the
  requirements table (what you need, and what you deliberately don't), the
  terminal/wrangler login step, and creating the D1 database — the exact
  copy-paste commands. The full guide continues from deploy to your first
  printed QR in 8 sections, plus a 7-row troubleshooting table where every
  common symptom has its fix (summarized at the end of the sample).
- `CUSTOMIZE-sample.md` — two complete chapters of the customization
  guide, verbatim: **redirect behavior** (why the kit uses 302, never 301 —
  and why paused links serve 410) and **destination screening** (the
  always-on local checks + optional Google Safe Browsing). The other five
  chapters — wrangler config, dashboard branding, privacy defaults, the
  full 9-endpoint management API, and extras like multi-domain — are
  summarized at the end.
- `worker-sample.mjs` — the opening of the actual product file: the route
  map and bindings doc, the constants, and the complete utils block
  (constant-time token compare, HTML escaping, the GDPR-style IP
  truncation at /24 or /48). This excerpt even passes `node --check` —
  the full worker is 478 lines and adds the screening engine, the
  redirect + click-ingest handler, and the whole management API.

What the full kit adds (the other 11 files):

- The complete `worker/worker.mjs` (478 lines, zero dependencies) —
  redirector, privacy-minimized click analytics, abuse screening, and the
  admin API behind one ADMIN_TOKEN.
- `worker/public/dashboard.html` — the private dashboard: create/edit/
  pause/delete links, printable PNG QR codes (dynamic — they encode the
  short URL, never the destination), CSV export, and per-link 14-day
  analytics (daily chart, countries, referrers, devices). Self-contained:
  no CDN, no external script, no cookie.
- `worker/wrangler.jsonc` — the deploy config with 4 marked values to edit.
- `schema.sql` — the two D1 tables (links + clicks), additive and safe to
  re-run.
- `README-buyer.md` and `MANIFEST.md` — the novice-friendly quickstart
  (with a "what success looks like" check after every step) and the file
  map.
- `LICENSE.txt` — single-business commercial license.
- `screenshots/` — five real captures from the kit's own files (the
  quickstart, the SETUP guide, CUSTOMIZE, and the dashboard's create and
  analytics views), so you can see every step before you run it.

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