Optional Paid Unlocks Setup

Setup Gumroad for optional convenience unlocks. Enable only when users request features.

⚠️ When to Setup Payments

Don't Rush

  • • Build traffic first (3-6 months of SEO)
  • • Enable ads at 1,000+ visitors (primary revenue)
  • • Only add paid unlocks if users request features

When to Enable

  • • 1,000+ visitors/month
  • • Users asking for bulk processing, exports, or history
  • • Clear unlock pattern identified

Remember

Paid unlocks are secondary revenue (10-30%). Ads are primary (70-90%). Most users will never pay, and that's okay.

Recommended: Gumroad

We recommend Gumroad for its simplicity. Setup takes 10 minutes.

Fees10% + payment processing (~3%)
Setup Time~10 minutes
License Keys✅ Built-in, automatic
VAT Handling✅ Automatic
Best ForSmall tools, quick start, indie builders

Note: LemonSqueezy has lower fees (5% vs 10%) but requires more setup. Start with Gumroad, switch later if needed.

Gumroad Setup

Fees:10% + payment processing (~3%)
Best For:Simple setup, quick start

Setup Steps

1. Create Gumroad Account

2. Create Product

  • • Click "Products" → "New Product"
  • • Name: "[Your Tool] - Convenience Unlock"
  • • Set your price: Start at $5 (increase later based on data)
  • • Enable "Generate license keys" in settings

3. Get Product Details

  • • Product ID: Found during set up of a license key on product page in the content section
  • • Checkout URL: Your product link (e.g., https://yourname.gumroad.com/l/yourapp)

5. Add to .env.local

NEXT_PUBLIC_PAYMENT_PROVIDER="gumroad"
NEXT_PUBLIC_GUMROAD_PRODUCT_ID="abc123"
NEXT_PUBLIC_GUMROAD_CHECKOUT_URL="https://yourname.gumroad.com/l/yourapp"
How License Verification Works

User Flow After Purchase

  1. User clicks "Unlock" button in your tool
  2. Redirects to Gumroad/Lemon Squeezy checkout page
  3. User completes payment on Gumroad/Lemon Squeezy and gets its license key
  4. User opens the license modal and fill the data, then clicks "Activate License" to verify
  5. License is validated via Gumroad/Lemon Squeezy API and stored in local storage
  6. User sees unlocked features immediately

License Modal Component

The boilerplate includes a LicenseModal component that:

  • • Accepts license key and email input
  • • Validates email format
  • • Calls Gumroad/Lemon Squeezy API to verify the license
  • • Stores verified license in local storage
  • • Shows success/error messages
Best Practices

Start with Gumroad

Easiest setup - switch to Lemon Squeezy later for lower fees

Test Pricing

  • • Start at $5 (low barrier to entry)
  • • Increase to $7-10 if conversion rate stays above 1%
  • • Don't expect high conversions - 0.5-2% is normal

Offer Refunds

7-day money-back guarantee builds trust

Test the Full Flow

  • • Make a test purchase (Gumroad and Lemon Squeezy allow test mode)
  • • Verify redirect works correctly
  • • Test license activation in your tool
  • • Confirm unlocked features appear
💡 Implementation Priority

Phase 1 (Months 0-3): Launch free, build SEO, no payments needed

Phase 2 (1,000+ visitors): Enable ads (primary revenue)

Phase 3 (If requested): Setup Gumroad for optional unlocks

Start with Gumroad. Switch to Lemon Squeezy later if you want to save 5% on fees.