🔴 Release v2.237.0
⭐⭐⭐ Complex • 17 commits • 159 files changedThis release introduces comprehensive analytics dashboards for referral programs and loyalty metrics, enabling administrators to track program performance, identify top performers, and optimize reward distribution. Enhanced game performance and improved admin workflows complete the update.
What’s New
- Referral Analytics Dashboard – Track referral program performance with funnel analysis, conversion trends, and top referrer identification
- Loyalty Analytics – Monitor member engagement, points economy health, and revenue impact across communities
- Redemption Expiry Windows – Set how long customers have to redeem rewards after earning them
- Flick Game Performance – Improved desktop input handling and low-FPS performance optimization
- Admin UI Improvements – Better theme consistency, feature toggle UX, and streamlined creation workflows
Apps Updated
User App
✓ Updated - 2 changes
API
✓ Updated - 65 changes
Admin
✓ Updated - 45 changes
Games
✓ Updated - 2 changes
Shopify Admin
✓ Updated - 35 changes
MCP Server
— No changes
Detailed Changes
Referral Analytics Dashboard
Referral Analytics Dashboard
What’s included:Complete analytics platform for referral programs with 8 major analytics endpoints:
- Referral Summary – High-level metrics including total referrals, referrer count, conversion rate, and redemption rate
- Referral Funnel – Step-by-step conversion analysis showing drop-off at each stage of the referral journey
- Referral Codes – View all active referral codes with usage metrics, share count, and conversion tracking
- Top Referrers – Identify your program’s most effective advocates ranked by referrals generated
- Referred Users – Track users acquired through referral with their engagement and revenue metrics
- Referral Comparison – Compare performance against community averages and historical trends
- Referral Timeseries – Analyze referral trends over time with customizable date ranges
Loyalty Analytics
Loyalty Analytics
What’s included:New loyalty program metrics dashboard:
- Member Engagement – Track active members, participation rates, and engagement trends across challenges and rewards
- Points Economy – Monitor total points in circulation, redemption rates, and points velocity
- Revenue Summary – Analyze revenue impact including total points value, reward costs, and program ROI
Redemption Expiry Windows
Redemption Expiry Windows
What’s included:Backend support for time-limited reward redemptions:
- Expiry Configuration – Set redemption windows per reward (e.g., “redeem within 30 days”)
- Redeemability Tracking – Track expiry status and remaining redemption time
- API Integration – Full tRPC endpoints with test coverage for create, update, and query operations
Flick Game Improvements
Flick Game Improvements
What’s included:Enhanced game experience for desktop users:
- Desktop Input Support – Improved mouse and keyboard handling for smoother desktop gameplay
- Low-FPS Optimization – Performance improvements for users on lower-end devices or slower connections
- Asset Optimization – Updated game assets for better quality without performance penalty
Admin UI Enhancements
Admin UI Enhancements
What’s included:
- Theme Token Consistency – Replaced hardcoded dark-only colors with design system theme tokens across admin pages
- Feature Toggle UX – Improved settings interface for toggling community features
- Studio Layout – Standardized creation flows for rewards, achievements, posts, and leaderboards
- Game Builder Fixes – Fixed image removal workflow in flick game configuration
- Achievement Defaults – New achievements now default to community scope instead of platform scope
- Challenge Template Copy – Excluded date fields when duplicating challenge templates to maintain proper scheduling
- Game Configuration – Fixed language switching and text field validation in game config forms
User App Updates
User App Updates
What’s included:
- Event Tracking Accuracy – Fixed spurious community visit events from page prefetch, improving analytics accuracy
- Improved Rendering – Better handling of community data loading with levelConfig support
API Reliability
API Reliability
What’s included:
- Multi-tier Achievements – Backend fixes for achievement claim logic in tiered reward systems
- Test Coverage – Improved test suite with dynamic date handling for reliable CI/CD
- Community Data Loading – Fixed levelConfig inclusion when loading community data
For Admins
**Referral Analytics Dashboard** – Comprehensive funnel analysis showing which stages of your referral program have the highest drop-off, conversion rates, and performance trends over time
**Top Referrers Leaderboard** – Quickly identify your most effective advocates and reward top performers with targeted incentives
**Loyalty Health Dashboard** – Monitor points economy, member engagement, and revenue impact to optimize reward pricing and program design
**Referred Users Table** – Track all users acquired through referral with their engagement metrics and lifetime value
**Referral Code Management** – View all active codes with usage counts and conversion metrics for better program oversight
**Revenue & ROI Tracking** – Understand program costs, points circulation, and measurable revenue impact on your community
**Redemption Expiry Windows** – Set time limits on reward redemptions (e.g., 30-day windows) to create urgency and manage liability
**Trend Analysis** – View referral and loyalty metrics over custom date ranges to identify seasonal patterns and program effectiveness
**Theme System Consistency** – Admin dashboard now uses design system tokens for proper dark/light mode support across all pages
**Streamlined Content Creation** – Rewards, achievements, posts, and leaderboards use studio layout for faster, more consistent creation workflows
For End Users
**Better Game Performance** – Flick game now runs smoothly on low-end devices and over slower connections with improved desktop input support
**Accurate Challenge Tracking** – Fixed event tracking to ensure your community visits and challenge completions are recorded correctly
Technical Details
Architecture Improvements
Analytics Pipeline: Referral analytics are built on a comprehensive tRPC router with 8 specialized service classes (GetReferralCodes, GetReferralComparison, GetReferralFunnel, etc.). Each service:
- Builds efficient aggregation pipelines using MongoDB’s location-sharded $match stages
- Filters users by event types and date ranges for accurate funnel analysis
- Supports custom date range selection with proper timezone handling
- Includes comprehensive test coverage (7 test suites with 115+ assertions)
Performance Improvements
Flick Game Optimization:- Refactored input handling with improved desktop keyboard/mouse detection
- Optimized asset loading for low-FPS environments (reduced image sizes while maintaining quality)
- Simplified component logic for faster re-renders on resource-constrained devices
Type Safety
All new analytics endpoints include:- Fully typed tRPC procedures with Zod schemas
- Discriminated union types for filter options
- Comprehensive test suites validating edge cases
Migration Notes
Redemption Expiry is Backward Compatible: Existing rewards work without expiry windows. Set expiry configuration through the admin panel or API only when needed. No Breaking Changes: All changes are additive. Existing integrations continue to work without modification.Contributors
@dchnudj11 commits • +28,070/-2,528 lines
@jamescockayne4 commits • +1,886/-225 lines
@ZuhayrK001 commit • +1,473/-9 linesRelease Stats
| Metric | Value |
|---|---|
| Total Commits | 17 |
| Lines Added | +31,600 |
| Lines Removed | -2,763 |
| Files Changed | 159 |
| Release Size | Massive |
| Complexity | High (⭐⭐⭐) |
v2.237.0 deployed on March 19, 2026