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

   Every way this architecture is known to lose money without telling you.

8. Bring your own store: what Pro runs, and what skips

   You made your payment links in the Stripe dashboard. You deliver by inviting the buyer to a private repo, with glue you wrote or by hand. Before spending $29…