Skip to content

feat(donate): rewrite donation page with tier structure and mission framing#48

Open
TimeToBuildBob wants to merge 5 commits into
ActivityWatch:masterfrom
TimeToBuildBob:bob/update-donation-copy
Open

feat(donate): rewrite donation page with tier structure and mission framing#48
TimeToBuildBob wants to merge 5 commits into
ActivityWatch:masterfrom
TimeToBuildBob:bob/update-donation-copy

Conversation

@TimeToBuildBob
Copy link
Copy Markdown
Contributor

Updates the donation page per the Experiment 1 plan from ErikBjare/bob#336.

Changes:

  • Replace flat 'thanks' page with three-tier structure: Supporter ($5/mo), Champion ($25+ one-time), Believer ($50/yr)
  • Lead with privacy-first mission framing (Variant A/C hybrid)
  • Add 'Why donate' and 'Where does the money go' sections
  • Reorder donation methods
  • Keep existing crypto addresses and Patreon options

Baseline (from Open Collective, last 30 days):

  • 4 contributions, $274.67 total
  • 44 lifetime contributors, $8,465 all-time

Ref: ErikBjare/bob#336

…raming

- Replace flat thanks page with three-tier structure: Supporter (/mo), Champion (5+ one-time), Believer (0/yr)
- Lead with privacy-first mission framing (Variant A/C hybrid from bob#336 experiment plan)
- Add 'Why donate' and 'Where does the money go' sections with transparency link to Open Collective
- Reorder donation methods by preference (Open Collective + GitHub Sponsors first)
- Keep existing crypto addresses and Liberapay/Patreon options
@greptile-apps
Copy link
Copy Markdown

greptile-apps Bot commented Apr 30, 2026

Greptile Summary

This PR rewrites donate.md to replace the old flat "thanks for donating" page with a structured three-tier layout (Supporter/Champion/Believer), adds mission/rationale sections, and updates the donation Methods section with explicit fee comparisons for most platforms.

  • Tier structure: Three named tiers with amounts and sponsor-page listing promises are added above the fold; the old page had no tier concept.
  • Methods section: Fee detail is now explicit for Liberapay (0%) and Open Collective (10%); GitHub Sponsors correctly calls out the 10% Open Collective backend fee; Patreon still uses vague "platform fees apply" unlike the other entries.
  • Sponsors-page promises: All three tiers promise sponsors-page listing, but the existing sponsors page has a $10 total-donation floor and no tier-based "special recognition" column, creating a gap between the copy and the current implementation.

Confidence Score: 5/5

Safe to merge — this is a content-only rewrite of a single markdown page with no functional code changes.

The change is entirely copy and structure on a static marketing page. No application logic, data, or configuration is touched. The open items (sponsors-page listing threshold, Believer special-recognition, Patreon fee vagueness) are content accuracy concerns that can be addressed in follow-up without risk.

No files require special attention beyond the content accuracy gaps noted in donate.md.

Important Files Changed

Filename Overview
donate.md Full rewrite of donation page introducing tier structure, mission copy, and updated methods list; sponsors-page listing promises are slightly ahead of the current sponsors-page implementation.

Flowchart

%%{init: {'theme': 'neutral'}}%%
flowchart TD
    A[Visitor lands on /donate/] --> B{Choose tier}
    B --> C[Supporter — $5/month]
    B --> D[Champion — $25+ one-time]
    B --> E[Believer — $50/year]
    C --> F{Pick method}
    D --> F
    E --> F
    F --> G[Liberapay\n0% fee]
    F --> H[GitHub Sponsors\n10% OC fee]
    F --> I[Open Collective\n10% fee]
    F --> J[Patreon\nfee unclear]
    F --> K[Cryptocurrency\ndirect transfer]
    G --> L[Donation processed]
    H --> L
    I --> L
    J --> L
    K --> L
    L --> M{Total donated ≥ $10?}
    M -->|Yes| N[Listed on /sponsors/]
    M -->|No| O[Not listed\nbut copy promises listing]
    N --> P{Believer tier?}
    P -->|Yes| Q[Promise: special recognition\nNot yet implemented in sponsors page]
    P -->|No| R[Standard listing]
Loading

Reviews (5): Last reviewed commit: "fix(donate): address transparency review..." | Re-trigger Greptile

Comment thread donate.md Outdated
Comment thread donate.md Outdated
Comment thread donate.md Outdated
… all tiers

- Remove $120/3-year Believer option: no supported platform offers 3-year subscriptions
- Add sponsors-page listing to Supporter and Champion tiers (was silently dropped vs old page)
- Resolves Greptile P1 findings
@TimeToBuildBob
Copy link
Copy Markdown
Contributor Author

Addressed both Greptile P1 findings in the latest commit:

  • 3-year tier removed: $120/3-year dropped from the Believer tier — none of our listed platforms support multi-year subscriptions, so advertising it was a broken user flow. Now just $50/year.
  • Sponsors-page recognition restored for all tiers: The old page promised all donors would be listed on /sponsors/. That promise was silently missing from Supporter and Champion in this rewrite. Added it back to both, with Believers still called out for "special recognition".

…sors

- Liberapay (0% fee) listed first, matching old page preference order
- GitHub Sponsors now discloses OC 10% fee caveat (was missing vs old page)
- Open Collective fee shown explicitly in listing

Addresses Greptile P2 (ordering) and fee-disclosure finding.
@TimeToBuildBob
Copy link
Copy Markdown
Contributor Author

Follow-up commit addresses the remaining Greptile findings:

  • Methods reordered: Liberapay (0% fee) is now listed first, restoring the old page's preference order. Open Collective (10%) moved down.
  • GitHub Sponsors fee disclosure restored: Added the Open Collective fee caveat back — "backed by Open Collective, so their 10% fee may apply" — which the old page had but the rewrite dropped.

Comment thread donate.md Outdated
@TimeToBuildBob
Copy link
Copy Markdown
Contributor Author

Fixed the remaining Greptile P1/P2 findings (commit 9eca103):

  • GitHub Sponsors fee: "may apply" → "applies" — the OC 10% fee always applies on this path, not conditionally
  • Patreon fee disclosure: Added "(platform fees apply)" — Patreon charges creators 5–12% depending on plan plus payment processing; exact % varies by plan so this is the honest phrasing

@TimeToBuildBob
Copy link
Copy Markdown
Contributor Author

@greptileai review

@TimeToBuildBob
Copy link
Copy Markdown
Contributor Author

Friendly bump — this PR is 19 days old with no reviews.

Self-review recheck (2026-05-19):

  • Diff is still clean: 37+ 33- LOC, single file (donate.md)
  • Copy reads well — tier structure is clear, mission framing is on-point, donation methods are properly reordered
  • No code changes, so no build/test concerns

This is the simplest PR in the current ActivityWatch queue. Would appreciate a review when you have a moment.

Comment thread donate.md Outdated
Comment thread donate.md Outdated
Comment thread donate.md
@TimeToBuildBob
Copy link
Copy Markdown
Contributor Author

Addressed Erik's requested changes in 40b12f68 and replied inline on each thread.

Current state:

  • Transparency wording is narrowed to Open Collective-routed donations
  • The funding examples now mention Kerkko/Brayo plus out-of-pocket coverage when donations were short
  • The BTC/ETH wallet-location HTML comments are restored

All review threads show as resolved on my side. Please take another look when you have a moment.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants