Release v2.213.3

​

🔴 Release v2.213.3

​

What’s New

• Completely redesigned analytics dashboard with real-time engagement timeline, interactive stat cards, and community activity heatmaps
• CSV bulk upload for reward winners — import hundreds of eligible users at once with automatic verification
• Action hints system — guide users with optional hints while penalizing rushed answers, configurable per challenge
• Birthday question action type — collect birthdates with calendar UI and automatic age validation
• Shopify onboarding replaced with server-verified checklist — faster, more reliable onboarding with instant completion tracking
• Split wallet layout — separate navigation for Points, Streaks, and Rewards with custom theme support
• OpenTelemetry observability — replaced Sentry with production-grade distributed tracing via BetterStack
• Localized game defaults — French and German text templates for all game types

​

Apps Updated

​

Detailed Changes

​

Admin Highlights

• Analytics Suite Redesign – Completely overhauled engagement dashboard with timeline charts, stat cards showing live metrics (active users, completion rates, earning trends), and community activity calendar with drill-down capability
• CSV Bulk Upload for Rewards – Import CSV files with user identifiers to instantly qualify hundreds of users for reward drops, eliminating manual entry
• Localized Game Text Defaults – Automatic French and German text templates for Catch, Flick, Memory, and Scratch games, reducing setup time for international communities
• Draft Reward Support – Save incomplete reward configurations and publish later, enabling content planning workflows
• Preview Auth Restoration – Fixed admin preview modal authentication to properly display content previews for challenges, rewards, and achievements
• Reward Sidebar Fixes – Improved sidebar UI consistency across reward creation and editing workflows
• Select-from-List Button Fix – Show “Add Option” button even when field has 6+ existing options
• Engagement Stat Cards – New dashboard stat cards showing users active now, upcoming completions, and trending engagement patterns
• Achievement Configuration Badges – Visual badges showing achievement type, distribution method, and rewards status at a glance
• Challenge Stats Redesign – Enhanced challenge statistics page with improved timeline visualization and action completion tracking

​

User Highlights

• Action Hints System – Challenges can now include optional hints that guide users through questions, with configurable XP penalties for using hints (e.g., -10% XP if hint used)
• Birthday Question Action – New action type for challenges to collect user birthdates with calendar-based date picker and automatic age validation
• Split Wallet Layout – New navigation structure with separate wallet tabs for Points, Streaks, Rewards, and Transactions, customizable per community theme
• Wallet Page Improvements – Dedicated pages for wallet assets and entries with improved scrolling and filtering

​

Shopify Updates

• Onboarding Checklist – Replaced multi-step wizard with server-verified completion checklist showing all required setup steps (branding, challenges, rewards, leaderboards) with instant feedback on completion status
• Widget FAB Fix – Fixed Floating Action Button getting stuck at 0 opacity on storefront display
• Programme Disable Button – Wired up programme disable toggle to properly update widget visibility API

​

API & Core Services

• OpenTelemetry Integration – Migrated observability from Sentry to OpenTelemetry with BetterStack backend, providing distributed tracing, structured logging with context correlation, and automatic span enrichment with request metadata (procedure name, endpoint, user/org context, error details)
• Action Hint Mutation – New reveal-action-hint mutation for tracking hint usage with automatic XP penalty calculation
• Action Hint DTOs – Added ActionHintDto, ActionConfigDto with hint configuration fields, and EventActionHintUsedDto for event tracking
• Games Pagination Filter – Added featured filter to games list endpoint for discovering featured games
• Post Template Fixes – Fixed like count reset when creating post from template

​

Supporting Packages

• Database Migrations – New migrations for action hints fields and birthday action XP config support
• Models Updates – Extended ActionDto, ActionConfigDto, and ActionParticipationDto with hint-related fields; added ActionHintDto and EventActionHintUsedDto
• Design System – Added calendar component with locale support for birthday question UI
• API Client Schema – Updated admin and integration API schemas with new action hint and birthday action endpoints

​

Technical Details

​

OpenTelemetry Architecture

• Traces: Collected via @vercel/otel with OTLPHttpJsonTraceExporter to BetterStack
• Logs: Sent via @opentelemetry/sdk-logs with OTLPLogExporter for automatic log↔trace correlation
• Span Enrichment: tRPC handler automatically adds procedure name, endpoint, org/user context, and error information to spans
• Heartbeat Monitoring: Cron jobs ping BetterStack heartbeats for uptime monitoring (Parquet Drop, Leaderboard Daily/Weekly)

​

Database Migrations

• 20260305220601-add_action_hints_fields.ts: Adds hint configuration, reveal count, and penalty fields to action collections
• 20260306225016-add_birthday_action_to_xp_config.ts: Extends action birth month/year fields for birthday action support

​

Action Hints Configuration

{
  "hints": {
    "enabled": true,
    "text": "Hint for this question",
    "xpPenalty": 10  // percentage penalty (0-100)
  }
}

​

Contributors

@erek_d@me.com8 commits • +3,981/-1,612 lines

@dch@wenudj.com6 commits • +21,343/-6,604 lines

@ZuhayrK005 commits • +4,867/-78 lines

@jamescockayne1 commit • +1,348/-1,702 lines

@SaadK941 commit • +218/-4 lines

​

Release Stats