Docs

How it works, how to run it, and where the limits are. The same files that ship in the repo.

1. How HonorBox works (and its limits)

   Three repos, no servers:

2. Setup: from fork to first sale

   Time: ~30 minutes, plus 10 if you add instant delivery in §6. Cost: $0/month. The arithmetic is in §7, not asserted. You need a GitHub account and an activated…

3. Selling a subscription

   Written for someone who has never run a subscription business. If you only sell one-time, you can close this page: subscriptions are off unless you switch them…

4. Least privilege: the two keys, scoped honestly

   "You want my Stripe secret key in a GitHub Action?" No. HonorBox never needs your full secret key, and it never needs a broad GitHub token. Delivering a sale…

5. Instant delivery

   HonorBox's default fulfillment is a poll every 30 minutes: zero infrastructure, zero accounts beyond Stripe + GitHub, and an invite a median of ~15 minutes…

6. Tax, without the hand-waving

   HonorBox is not a merchant of record. When you sell through Gumroad or Lemon Squeezy, they are legally the seller: they charge, collect, and remit VAT/sales…

7. The failure catalogue

   <!-- Generated. The body below is the output of node audit/audit.js --catalogue in HonorBox Pro, copied here verbatim so the catalogue is readable without…