Skip to main content

Top Fans

Top Fans is a per-creator leaderboard of the people who support them the most over a period (week / month / all-time), blended from three signals directed at the creator: virtual gifts, coin tips, and comments on the creator's posts. Creators can reward their top fans with coins or free access to paid content. It's distinct from Top Supporters/Tippers (tips-only, in the Coins wallet) — Top Fans blends gifts + tips + comments into a single score.

Each property has its own checkbox marking whether that specific piece is fully implemented and functional end to end (frontend + backend) — update these yourself as work lands; this page won't overwrite them.

  • Top-fans leaderboard for a period (topFans(period, limit)) — ranked list with per-fan gift coins/count, tip coins/count, comment count, total coins, and a blended score. Shown on the /top-fans page (TopFansPage.tsx).
  • Rank badges in comments/feed (topFanIds(userId, period, limit)) — returns the ranked fan IDs for any creator so the UI can badge them.
  • Reward a top fan (rewardTopFan) — send coins, grant free access to a group conversation (free_subscription), unlock a premium post (premium_post), or grant creator-subscription access. UI: RewardFanModal.tsx.
  • Giftable exclusive posts helper (myGiftablePosts) — the creator's paid posts that can be offered as a reward.

See the technical reference for GraphQL schemas, routes, source file links, and per-field wiring status.