Release v2.420.0

​

🔴 Release v2.420.0

⭐⭐⭐ Complex • 45 commits • 437 files

​

What’s New

​

Admin Productivity & AI Integration

• Artifact Ledger & Library – Track all AI-generated artifacts in a searchable library with full audit history, accessible from the Artifacts tab in chat
• Tool-Card Registry with Entity Deep Links – Navigate between challenges, games, leaderboards, and rewards directly from chat results with one-click entity linking
• Live Game Design Preview – See real-time updates to your game configuration as you edit, eliminating preview lag and guesswork
• One-Click AI Background Removal – Remove backgrounds from scratch prize images instantly using fal birefnet, no external tools needed

​

Creator & Design Features

• Game Image Upload Validation – Automatic enforcement of minimum dimensions with clear guidance to prevent low-quality images
• Prize Image Transparency Nudge – Guidance and warnings for scratch game prize images to ensure professional appearance with proper opacity handling
• Improved Colour Picker – Colour picker now defaults to HEX tab instead of HSL for faster workflow

​

Leaderboard Enhancements

• CSV Export with Field Selector – Choose which fields to export (name, score, tier, etc.) when downloading leaderboard data
• Period History – Track historical leaderboard performance across different time periods and date ranges for both admins and users

​

Security & Stability

• Enhanced Widget Security – Improved sign-out handling and embed-aware refresh guards prevent session loss when embedded in partner sites
• Improved API Stability – All-gateway kimi routing ensures reliable AI model handling across different environments

​

Apps Updated

​

Detailed Changes

​

User App Improvements

The user app receives critical security enhancements and improved experience during widget interactions:

• Security Hardening – Widget auth now includes proper sign-out cookie clearing and embed-aware refresh guards to prevent session hijacking when embedded in third-party sites
• Streamlined Widget Sign-In – Standalone widget-landing sign-in routing now correctly transitions to the full app for seamless authentication
• Better Loading Feedback – Games iframe now displays loading spinner during cold boot, reducing perceived wait times
• Mobile Optimization – Widget landing CTAs stay visible on full-height phone displays without top-bar overlap
• Improved Game Playability – Sweep game now fully functional with pointer controls, sound-toggle icon fixed to display clearly in both muted and unmuted states
• Accurate Points Tracking – Points earned through spend rewards now correctly counted as an earn way for accurate user statistics
• Enhanced Carousel – Shared info-carousel now elevated with branded chrome for better visual hierarchy
• Scratch Game Controls – Close button properly anchored to game panel corner for better accessibility

​

Admin App Features

The admin app receives a comprehensive suite of improvements focused on productivity and AI integration:

​

Artifact Management System (NJ-1421 Multi-Part Release)

• Artifact Ledger – Complete audit trail of all AI-generated artifacts with searchable library, organized by type and date
• Artifacts Tab – Dedicated workspace tab for browsing, searching, and managing all created artifacts
• Tool-Card Registry – Centralized registry of chat tool cards with consistent rendering across admin interface
• Entity Deep Linking – One-click navigation from chat results directly to challenges, games, leaderboards, rewards, and other entities
• Tabbed Workspace Panel – Reorganized chat workspace with separate tabs for AI Elements, Artifacts, WebPreview, and Preview/Queue
• Improved Chat Architecture – Extracted chat shell enables better code organization and maintainability

​

Image & Asset Management

• One-Click Background Removal – Uses fal birefnet AI to instantly remove backgrounds from scratch prize images, with support for batch processing
• Game Image Upload Validation – Enforces minimum dimensions for game images with clear guidance and error messages
• Prize Image Transparency Guidance – Soft warnings and nudges for scratch prize images to ensure proper opacity handling and professional appearance
• Colour Picker Improvement – Now defaults to HEX tab instead of HSL for faster workflow during brand customization

​

Leaderboard Features

• CSV Export with Field Selector – Customize which fields appear in exported leaderboard data (name, score, tier, points, last updated, etc.)
• Period History – View and export leaderboard snapshots from different time periods for historical analysis

​

Additional Admin Improvements

• Live Game Design Preview – See real-time updates to game configuration without constant preview clicks
• Gamified Shopify Setup – Enhanced loading states during Shopify integration setup for better user feedback
• Challenge Template Browsing – Restored ability to browse challenge templates when creating new challenges

​

API Enhancements

• Draft Content Visibility – Integration API now supports verified admin-preview grants, allowing safe preview of draft content before publication
• Background Removal Service – New asset management service integrates fal birefnet for AI-powered background removal with batch processing
• Spend Rewards in Shop – Shopify catalog now includes spend-based rewards for better monetization options
• Webhook Routing – Fixed routing for app-prefixed shop redact webhooks to ensure proper shop identification
• Improved Game Routing – Normalized scratch-card route alias so scratch game renders correctly in all contexts

​

MCP Server Improvements

• Comprehensive Test Coverage – Every MCP tool now has complete direct-MCP eval coverage via promptfoo testing
• All-Gateway Routing – Improved kimi routing ensures reliable handling across multiple AI model gateways with bulletproof eval coverage

​

Games & Graphics

• Sound Toggle Visibility – Fixed icon rendering to clearly show muted/unmuted state in both scratch and shared games
• Pointer Controls – Sweep game now fully playable with pointer input on all devices
• Route Normalization – Fixed scratch-card route alias handling

​

Breaking Changes

​

Leaderboard Configuration

The ability to toggle open leaderboards with no end date was reverted in this release due to compatibility concerns. If you were relying on this feature, revert to the previous leaderboard configuration behavior.

​

Technical Improvements

This release includes significant behind-the-scenes improvements:

• Performance Optimization – Session context trimmed by ~26k tokens, reducing memory footprint and improving initialization speed
• Code Quality – Comprehensive dead code cleanup removed orphaned chat components, consolidating duplicated helpers for better maintainability
• Developer Experience – Raised dev header limits and improved Warp-default local-dev documentation for faster development iteration
• Test Coverage – Complete MCP tool coverage with full promptfoo eval suite ensuring reliability

​

Contributors

​

Release Stats

---

v2.420.0 deployed on July 6, 2026