Skip to main content

​
🟠 Release v2.493.0

⭐⭐ Moderate Complexity • 3 commits • 51 files changed
This release adds leaderboard exclusion management for campaign managers and locks in the Meta feed story-card system for social marketing. Campaign managers can now exclude specific users from rankings during defined periods via CSV upload, while the documentation layer standardizes branded social card production with reusable templates and 3D assets.

​
What’s New

  • Leaderboard User Exclusions — Exclude specific users from leaderboard rankings during defined time windows, uploaded via CSV for bulk management
  • Exclusions Management UI — Edit exclusion windows directly from the rankings page without leaving the leaderboard view
  • Meta Feed Story Cards — Locked-in HTML rendering pipeline for branded social media cards with pre-designed 3D assets and examples
  • Timezone-Aware Exclusions — All exclusion periods are calculated in your organisation’s calendar timezone for accuracy

​
Apps Updated

User App

— No changes

API

✓ Updated - Timezone support, exclusion service methods

Admin

✓ Updated - Leaderboard exclusions UI

MCP Server

— No changes

Website

✓ Updated - Meta card templates and docs

Games

— No changes

​
Detailed Changes

Leaderboard Exclusions Management
  • New exclusions dialog for viewing and editing exclusion windows per user
  • CSV upload component for bulk exclusion imports with validation
  • Exclusion list display showing all active and upcoming exclusions
  • Direct access to exclusion management from the rankings page (no modal redirect)
  • Support for defining exclusion windows with start and end dates
  • Timezone-aware period calculations (uses organisation calendar timezone)
Leaderboard Configuration & Data
  • New timezone field in leaderboard config (response-only, automatically populated)
  • Timezone passed through both config and ranking data responses for consistency
  • New leaderboard exclusion service methods for CRUD operations
  • Exclusion window period resolution utilities
  • Support for querying active exclusions within a time range
Brand & Documentation
  • Meta feed story-card HTML rendering system locked in with reusable templates
  • 14 pre-designed 3D asset icons (coin, gem, heart, fire, star, trophy, rocket, sparkles, question, megaphone, gift, gamepad, moneybag, party)
  • Example cards for 10 common use cases (discounts, games, questions, referrals, spreadsheets, streaks, loyalty tiers, etc.)
  • Stable card template system for consistent social media presence
  • License documentation for 3D assets

​
For Campaign Managers

Manage Who Appears on Your Leaderboards You can now exclude users from leaderboard rankings during any time period. Common use cases:
  • Test Users & Admins — Prevent internal testing from affecting real rankings
  • VIP Segments — Run separate leaderboards for different user tiers without overlap
  • Suspended Users — Temporarily hide users while investigating suspicious activity
  • Scheduled Exclusions — Plan exclusion windows in advance for seasonal campaigns
How to Use:
  1. Open any leaderboard’s rankings page
  2. Click the Exclusions button to open the management panel
  3. Upload a CSV file with user IDs and exclusion windows, or add them one by one in the dialog
  4. Exclusions take effect immediately and are calculated in your organisation’s timezone
  5. View all active and upcoming exclusions in a sortable list
CSV Format:

​
For Developers & Partners

API Changes:
  • Leaderboard config and ranking data responses now include timezone (the organisation’s IANA timezone)
  • This allows clients to calculate period windows without querying organisation data separately
  • All exclusion operations are scoped to leaderboard permissions
Meta Feed Card Templates: The template system (docs/brand/templates/social/meta-cards.html + render pipeline) is now locked in and ready for production use. The template supports both 4:5 (portrait) and square aspect ratios with:
  • Automatic responsive scaling
  • 14 reusable 3D icon assets with blur and opacity effects
  • Pre-computed background gradients and geometric shapes
  • Optimized for Meta/Instagram feeds and stories
See docs/brand/templates/ for the full render pipeline and example implementations.

​
Detailed Feature Breakdown

​
Leaderboard Exclusions

What Problem Does This Solve? Leaderboards are powerful engagement tools, but sometimes you need to exclude certain users — whether they’re internal testers, VIPs on a separate tier, or flagged for fraud review. Previously, this required manual data cleanup in your database. Now it’s a first-class feature with a dedicated UI. How It Works:
  • Each exclusion defines a userId, startsAt, and expiresAt date
  • During the exclusion window, that user’s data is excluded from ranking calculations
  • Exclusions are always calculated using your organisation’s timezone (not UTC)
  • You can upload up to 1,000 exclusions per CSV file
  • Duplicates are detected and merged automatically
What Gets Excluded:
  • The user is removed from the visible rankings table
  • Their score does not count toward leaderboard statistics (totals, averages, position changes)
  • Reward distribution skips excluded users
  • Historical rankings are recalculated if you later add an exclusion retroactively

​
Meta Feed Story Cards

What Problem Does This Solve? Creating branded social media content for Meta/Instagram takes design time and coordination. The story-card template system standardizes this process with pre-designed layouts, reusable 3D assets, and a locked rendering pipeline that ensures brand consistency. What’s Included:
  • HTML Template — A production-ready card template with responsive layouts
  • 3D Assets — 14 pre-rendered icon illustrations (fire, star, coin, gem, etc.) optimized for social media
  • Render Pipeline — A Node.js MJS script that converts card data to PNG images
  • Example Gallery — 10 complete card examples showing different messaging scenarios
Use Cases:
  • Challenge launch announcements (with challenge icon)
  • Reward highlights (coin/gift assets)
  • Leaderboard winners (trophy asset)
  • Streak achievements (fire asset)
  • Game launches (game asset)
  • Referral campaigns (megaphone asset)
  • Point/tier milestones (star/gem assets)
  • Special promotions (party asset)

​
Breaking Changes

None. All changes are backwards compatible.

​
Technical Notes

  • Exclusions are enforced at the aggregation layer (before leaderboard data is returned to clients)
  • Timezone resolution is automatic from leaderboard config; no client-side calculation needed
  • CSV parsing includes validation for date formats, duplicate detection, and row count limits
  • The Meta card render pipeline is idempotent and can be run repeatedly without side effects

​
Contributors

jamescockayne@jamescockayne1 commit • +1,934 / -34 lines
Mo@solicshop@gmail.com1 commit • +728 / -3 lines

​
Release Stats

v2.493.0 deployed on August 20, 2026