🔴 Release v2.178.3
⭐⭐⭐ Complex • 29 commits • 782 files changedA massive release bringing significant gamification and voice AI enhancements. Admins can now run VIP reward tiers with XP multipliers, customize widget sections with rich descriptions, and manage featured content. Voice support gets a major upgrade with ElevenLabs conversational AI, hands-free PTT mode, and Shopify embed integration. Game configuration flows are completely redesigned for better UX, and a new referral tracking system provides analytics for referral campaigns.
What’s New
For Platform Admins:- VIP Tier Points Multiplier – Create premium reward tiers where eligible users earn 1.5x, 2x, or custom XP multipliers for all activities. Perfect for loyalty programs and corporate VIP programs.
- Widget Section Customization – Add descriptive section titles, help text, and contextual tooltips to loyalty widget sections. Customize the widget experience without coding.
- Featured Content Management – Mark posts, challenges, and games as featured to highlight them in user navigation. New carousel displays featured content prominently.
- Game Config UX Overhaul – Completely redesigned game creation and editing forms with better organization, clearer workflows, and improved visual hierarchy.
- Referral Analytics – Track and measure referral program performance with click-through tracking, domain analytics, and referral attribution.
- Featured Content Carousel – Discover highlighted challenges and games in the community navigation menu with a beautiful, interactive carousel.
- Voice AI Enhancements – Enjoy faster, more natural voice conversations with ElevenLabs AI. Admin can toggle hands-free Push-to-Talk mode for voice-first interactions.
- Better Support Access – Shopify store employees can now access voice support via an embedded popup without leaving their store.
Apps Updated
User App
✓ Updated - 120 file changes
API
✓ Updated - 280 file changes
Admin
✓ Updated - 166 file changes
MCP Server
✓ Updated - 24 file changes
Games
✓ Updated - 85 file changes
Shopify
✓ Updated - 233 file changes
Detailed Changes
🎁 XP Boost Effects System (VIP Rewards)
🎁 XP Boost Effects System (VIP Rewards)
What It Does:
Admins can now create premium reward tiers where users earn XP multipliers on all activities. When a user redeems a VIP reward tier, they receive a configurable multiplier (1.5x, 2x, etc.) that applies to all XP earned during a specific period.How It Works:
- Admin creates a new reward tier of type “XP Boost Redemption”
- Defines multiplier value (e.g., 2x points) and duration (e.g., 30 days)
- User redeems the tier → instant multiplier applies to all XP
- Multiplier expires after duration or when user earns configured amount of XP
- Loyalty program VIP tiers
- Customer appreciation promotions
- Corporate employee incentives
- Points-doubling events
- New “XP Multiplier Redemption” reward type in reward creation
- Multiplier configuration step with duration and value settings
- Rewards table shows multiplier icon for these tier rewards
packages/models/dto/user/model/effects/- New effect modelsapps/api/lib/mutation/user/redeem-reward-asset.ts- Redemption logicapps/admin/engagement/components/rewards/reward-form/- Form UIpackages/api/admin/schema.ts- API type definitions
🎙️ Voice AI Enhancements (ElevenLabs + PTT Mode)
🎙️ Voice AI Enhancements (ElevenLabs + PTT Mode)
What Changed:
The admin chat voice system now uses ElevenLabs conversational AI instead of OpenAI, providing faster response times, more natural conversations, and better context awareness. A new Push-to-Talk (PTT) mode allows admins to talk continuously without pressing buttons for each message.New Features:
- Push-to-Talk Mode – Hold down to speak, release to send. Hands-free conversation flow.
- ElevenLabs Conversational AI – Faster, more natural voice responses with real-time streaming
- Voice Status Bar – Real-time feedback on recording, processing, and playback states
- Shopify Voice Popup – Store employees can access AI support via embedded voice modal
- Hold spacebar or microphone button to record
- Visual feedback shows recording status
- Automatic processing and response playback
- Configurable sensitivity and audio settings
- New
/chat/voice-popuproute provides embedded voice support - Integrates with existing Shopify admin app
- Full ElevenLabs real-time streaming support
- No changes to existing chat workflows
- Voice settings automatically configured
- Seamless upgrade from OpenAI system
apps/admin/components/voice/- New voice system componentsapps/admin/lib/voice/elevenlabs-*- ElevenLabs integrationapps/admin/app/(embed)/chat/voice-popup/- Shopify voice popupapps/shopify/app/components/chat/- Shopify app integrationapps/admin/docs/voice-implementation.md- Updated documentation
📱 Widget Section Customization (Rich Descriptions)
📱 Widget Section Customization (Rich Descriptions)
What It Does:
Admins can now add descriptive titles, helper text, and tooltips to each section of the loyalty widget. This lets you customize the widget experience and provide context without any code changes or developer involvement.New Admin Controls:
- Section Title – Custom header text for each widget section (e.g., “Earn Points”, “Redeem Rewards”)
- Section Description – Help text explaining what the section does
- Tooltips – Contextual help icons with hover explanations
- All Sections Supported – Achievements, Points, Leaderboard, Referrals, Streaks, Daily Games, etc.
- More personalized widget experience
- Clear guidance for first-time users
- Branded language and messaging
- Better UX without technical changes
- Shopify theme app panel shows customization controls
- Real-time widget preview as you edit
- Simple text fields for each customization
apps/shopify/app/routes/app.on-site-content.panel.tsx- Admin panelapps/user/app/(widget)/widget/[slug]/_components/sections/- Widget componentspackages/models/dto/theme/widget-component-config-dto.model.ts- Config models
⭐ Featured Content System
⭐ Featured Content System
What It Does:
Admins can mark posts, challenges, and games as “featured” to highlight them in user interface. A new carousel in the user’s community navigation displays featured content, helping users discover the best challenges and rewards.Admin Controls:
- Featured Toggle – Simple checkbox when creating/editing posts, challenges, or games
- Feature Management – See which content is featured in admin tables
- Featured Carousel – Auto-populates from marked content
- Featured Content Carousel – Beautiful card carousel in the vertical navigation menu
- Prominent Display – Featured items show first in content lists
- Engagement Boost – Highlights special campaigns or seasonal content
- Seasonal campaigns (holiday challenges, back-to-school events)
- New game launches
- High-reward promotions
- Time-sensitive challenges
- Featured flag stored on Post, GameConfig, and Challenge models
- Carousel component with auto-scroll and manual navigation
- Responsive design works on mobile and desktop
apps/admin/engagement/components/posts/post-form/- Post form UIapps/admin/app/(routes)/game-configs/- Game config formapps/user/components/featured/- Featured carousel componentsapps/user/components/navigation/- Navigation integration
🎮 Game Config Creation Form Overhaul
🎮 Game Config Creation Form Overhaul
What Changed:
The game configuration flow has been completely redesigned with better organization, clearer workflows, and improved visual hierarchy. Creating and editing games is now faster and more intuitive.Improvements:
- Unified Sidebar Navigation – Clear step-by-step guide for game setup
- Visual Game Type Selection – Card-based game type picker instead of dropdown
- Better Section Organization – Grouped related settings logically
- Inline Validation – Real-time feedback as you configure
- Improved Typography – Better readability and visual hierarchy
- Context-Aware Help – Tooltips and guidance for each section
- Preview Pane – Live preview of game configuration as you edit
- Reduced cognitive load with step-by-step approach
- Clearer which settings affect which aspects of the game
- Faster form completion for experienced admins
- Better error messaging and validation
- Scratch (scratch-off cards)
- Catch (photo collection)
- Spin (spinning wheel)
- Rush (timed challenges)
- And any new game types
apps/admin/app/(routes)/game-configs/create/- Creation flowapps/admin/app/(routes)/game-configs/[id]/edit/- Edit flowapps/admin/engagement/form/components/common/- Form componentsapps/admin/engagement/form/game-config-form-visual.tsx- Form layout
🔔 Standardized Toast/Notification System
🔔 Standardized Toast/Notification System
What Changed:
All admin interface notifications now use a consistent toast system across the platform. Success, error, warning, and info notifications look and behave the same way everywhere.Benefits:
- Consistent UX – Same notification style across all pages
- Better Accessibility – Improved ARIA labels and keyboard navigation
- Reliable Feedback – Users know their actions succeeded or failed
- Less Visual Clutter – Standardized positioning and duration
- Creating/updating achievements, challenges, rewards
- User management (invites, roles)
- Leaderboard operations
- Settings changes
- Drop and reward distribution operations
apps/admin/CLAUDE.md- Documentation of new patternapps/admin/engagement/components/- Updated form components- All admin pages using success/error feedback
🔗 Referral Link Tracking & Analytics
🔗 Referral Link Tracking & Analytics
What It Does:
Track when users click on referral links, including their location, device, and time. The API provides analytics endpoints for measuring referral campaign performance.How It Works:
- Admin shares a referral link (e.g.,
example.com/refer/ABC123) - User clicks the link → click is tracked with IP, domain, timestamp
- User is redirected to the community (using domain normalization)
- Admin can see referral analytics in the referral section
- Click timestamp
- User location (from IP geolocation)
- Referral code and link metadata
- Duplicate click detection (same IP + 1-minute window)
- Total click count per referral link
- Measuring campaign effectiveness
- Identifying top-performing referral sources
- Detecting fraud (duplicate clicks)
- Understanding referral traffic patterns
POST /api/refer/[code]- Track click and redirect- New event type:
ReferralLinkClickedfor analytics - Domain resolution handles different environments
apps/api/app/api/refer/[code]/- New redirect endpointapps/api/lib/mutation/referral/- Click tracking logicpackages/api/analytics/schema.ts- Analytics schemapackages/models/dto/event/- Event models
🐛 Bug Fixes & Stability
🐛 Bug Fixes & Stability
Achievement Display Bug Fixed
- Achievements now appear in the admin table immediately after creation or update
- Fixed table refresh issue that previously required page reload
- Fixed duplicate JSX block in panel config that was breaking Shopify builds
- Team invite button now correctly respects “update” permission instead of “create”
- Better alignment with role-based access control
- Admin API requests now correctly use content language cookie for
x-languageheader - Better international user experience
- Fixed flaky challenge group selection tests
- More stable test suite for challenge distribution logic
- Game completion route now has proper layout and providers
- Fixes issues with standalone game links
🔒 Security & Dependencies
🔒 Security & Dependencies
Security Updates:
- Addressed 26 Dependabot security alerts across the platform
- Updated vulnerable dependencies to secure versions
- No breaking changes to public APIs
- Updated linting to use Biome directly (removed Ultracite)
- Better local development experience for multi-Shopify setups
- Internal database collections added to parquet export ignore list
- Added GSD (Goal Stack Data) framework for improved development workflows
- Tech planning skills now create draft PRs with “Spec Ready” label
- Better release note automation for Teams notifications
Contributors
@dch9 commits • +6,976/-4,366 lines
@SaadK948 commits • +5,471/-45,977 lines
@erek_d5 commits • +40,087/-5,415 lines
@ZuhayrK004 commits • +5,288/-601 lines
@jamescockayne1 commit • +1,867/-12 linesRelease Stats
| Metric | Value |
|---|---|
| Total Commits | 29 |
| Lines Added | +59,751 |
| Lines Removed | -55,839 |
| Files Changed | 782 |
| Release Size | Massive |
| Complexity | Complex (⭐⭐⭐) |
v2.178.3 deployed on February 25, 2026

