Skip to main content

​
🔴 Release v2.205.9

⭐⭐⭐ Complex • 57 commits • 1,240 files changed
A massive release bringing powerful referral capabilities, granular points management, action lifecycle controls, and comprehensive Shopify enhancements. Admins can now build complete referral programs with reward distribution, stage actions before publishing, set points to expire, apply temporary points multipliers, and configure streaks with milestone-based rewards. Widget quick actions unlock one-tap member engagement. The Shopify admin gets a complete overhaul with game settings modals, reward management improvements, activity analytics, and guided onboarding.

​
What’s New

For Platform Admins:
  • Referral Reward Distribution System – Create referral programs with automatic reward distribution to both referrers and referees. Configure per-community referral acceptance settings to control participation.
  • Quick Actions Widget – Manage one-tap widget actions (YouTube subscribe, Facebook follow, Instagram follow, quick quizzes, receipt scanning) without touching code. Drag-to-reorder actions and configure per-action settings.
  • Action-Level Status Control – Stage actions as Draft before publishing them Live, allowing you to build and test challenges without affecting members.
  • Points Expiration System – Set expiration dates on earned points to encourage timely redemption and drive engagement. Configure points lifespan per community.
  • Points Boost Effects – Apply time-limited points multipliers (1.5x, 2x, 3x) to specific users for campaigns, VIP tiers, or special events. Automatic expiration after duration.
  • Streak Milestone Rewards – Configure checkpoint rewards when users reach 7, 14, 30, or custom streak milestones to celebrate progress and drive consistency.
  • Challenge Preview Mode – Preview challenges with a beautiful 3-column layout showing challenge details, actions, and media side-by-side before publishing.
  • Widget Customization Admin Panel – Customize widget sections with titles, descriptions, and help text. Theme-aware customization with real-time preview.
  • Embed Emulator – Test how your widget looks embedded on a website directly from the admin panel without deploying.
  • Language Config JSON Editing – Root-level JSON edits in language configuration now persist correctly.
  • Gemini 3.1 Flash Lite Model – New AI model option for chat agents with improved performance and cost efficiency.
For Shopify Admins:
  • Game Settings Modal with Tabbed Config – Configure game rewards with an improved modal dialog featuring organized tabs for settings, thresholds, and rewards.
  • Onboarding Wizard Modal – Step-by-step guided setup for new Shopify stores with clear instructions and progress tracking.
  • Global Widget Toggle – Enable or disable the loyalty widget across the entire storefront from a single setting.
  • Streak & Achievement Controls – Toggle streak and achievement features independently to customize the loyalty experience.
  • Individual Reward Unlink – Unlink individual discount rewards from gamification without affecting others.
  • Inline Reward Form Modal – Create and configure giveaway and exclusive rewards without leaving the page.
  • Activity Chart Summary – Visual dashboard showing store engagement metrics with charts and performance indicators.
  • Reward Consolidation – Rewards are now displayed in a clean, unified card layout for better visual hierarchy.
  • Coming Soon Teaser – Communicate upcoming features to store admins in the settings sidebar.
  • Streak Rewards Management – View and manage streak-based rewards from the Shopify admin panel.
  • Simplified Settings UI – Access and scheduling controls are hidden by default for a cleaner configuration experience.
For Platform Users:
  • Refer-a-Friend Widget – Share referral links and track referrals in the widget with automatic reward credit.
  • Widget Quick Actions – One-tap actions to earn points: follow on social media, answer quizzes, scan receipts, and more.
  • Points Expiration Awareness – See when earned points expire and prioritize redemption.
  • Better Streak Status – Accurate streak completion status for past days with correct visual feedback.
  • Consistent Button Styling – All buttons now use themed border radius for a cohesive design.
  • Loading State Improvements – Layout-aware loading skeletons in community navigation for smoother perceived performance.
  • Proper Game Notifications – Game completion activities display properly with template rendering.

​
Apps Updated

User App

✓ Updated - 98 file changes

API

✓ Updated - 512 file changes

Admin

✓ Updated - 308 file changes

MCP Server

✓ Updated - 22 file changes

Shopify

✓ Updated - 280 file changes

Database

✓ Updated - 20 file changes

​
Detailed Changes

What It Does: Complete referral program infrastructure allowing admins to create and manage referral campaigns. Automatically distribute rewards to both the person who referred (referrer) and the person who joined (referee).Key Features:
  • Dual Reward Distribution – Configure separate reward tiers for referrers and referees
  • Per-Community Configuration – Control referral settings individually for each community
  • Acceptance Control – Members can be required to accept or opt-in to referral programs
  • Event-Based Triggers – Rewards trigger automatically when referral conditions are met
  • Achievement Integration – Referrals backed by dedicated achievements separate from standard achievement APIs
How Admins Use It:
  1. Navigate to Gamification → Referral settings
  2. Configure referral reward tiers (e.g., referrer gets 500 points, referee gets 250 points)
  3. Set up referral achievement with conditions and reward distribution events
  4. Members receive referral codes in the widget and can share with friends
  5. Rewards distribute automatically when referred members meet conditions
Perfect For:
  • Customer acquisition campaigns
  • Viral growth programs
  • Win-back campaigns
  • Membership expansion
Technical Details:
  • Referral achievement isolated from standard achievement APIs via AchievementType filtering
  • Per-community acceptance system controls participation
  • Event-driven reward distribution via achievement handlers
  • Full audit trail in points transaction system
Files Modified:
  • packages/models/dto/achievement/achievement-dto.model.ts – Referral config fields
  • packages/models/dto/referral/ – New referral models (ReferralCodeDtoModel, ReferralStatusDtoModel)
  • apps/api/lib/mutation/referral/ – Referral acceptance and distribution logic
  • apps/api/lib/service/achievement-handler.service.ts – Referral event handlers
  • packages/services/service/referral/ – Referral distribution services
What It Does: Admin control center for widget quick actions – one-tap member engagement options like YouTube subscribes, Instagram follows, quick quizzes, and receipt scans. No coding required.Features:
  • Drag-to-Reorder – Organize actions by priority
  • Per-Action Configuration – Customize XP rewards, prerequisites, and validation rules
  • 9 Built-in Action Types:
    • YouTube Subscribe
    • Facebook Follow
    • Instagram Follow
    • Quick Quiz (multiple choice)
    • Receipt Detection
    • Engaging with Content
    • Image Upload
    • Date Selection
    • Voting
  • Enable/Disable Toggle – Control which actions members see without deleting
  • Visual Action Icons – Clear iconography for each action type
How It Works:
  1. Admin navigates to Gamification → Quick Actions
  2. Pre-configured challenge automatically created on community setup
  3. Admin can reorder actions, adjust XP values, enable/disable
  4. Members see actions in widget and complete them for instant rewards
  5. Completion tracked and points awarded automatically
Member Experience:
  • One-tap actions in the widget
  • Immediate reward feedback
  • No page navigation required
  • Works offline (queues actions)
Perfect For:
  • Social media growth
  • Engagement boosters
  • Information gathering
  • Quick reward loops
Files Modified:
  • apps/admin/app/(admin)/admin/gamification/(routes)/quick-actions/ – New admin page
  • apps/user/app/(widget)/widget/[slug]/_components/quick-actions/ – Widget component
  • apps/api/lib/mutation/manage/challenge/create-default-quick-actions-challenge.ts – Seeding
  • packages/models/dto/challenge/templates/quick-actions-template.ts – Templates
What It Does: Stage actions as Draft before publishing them Live. Build, test, and refine challenges without members seeing incomplete actions.How It Works:
  • Draft Status – Actions created in Draft state are hidden from members
  • Live Status – Publish actions to make them visible and completable
  • Bulk Control – Change status for individual actions or entire challenges
  • No Data Loss – Reverting to Draft doesn’t delete completion history
Benefits:
  • Create challenges over multiple sessions
  • Test content before launch
  • A/B test different action configurations
  • Manage complex multi-step challenges safely
  • Scheduled content releases
Perfect For:
  • Campaign planning
  • Content vetting
  • Staged rollouts
  • A/B testing
Files Modified:
  • packages/models/enum/action/action-status.enum.ts – New ActionStatusEnum
  • apps/admin/app/(admin)/admin/engagement/components/challenges/challenge-form/actions/ – Status UI
  • apps/api/lib/query/action/filter-live-actions.ts – Member visibility filtering
  • packages/api/admin/schema.ts – API types
What It Does: Set expiration dates on earned points to encourage timely redemption and drive engagement. Members see countdown timers and are motivated to redeem before points vanish.Configuration Options:
  • Expiration Window – Set points to expire after 30/60/90 days or custom duration
  • Per-Community – Configure different expiration rules per community
  • Automatic Cleanup – Expired points are automatically removed from user balances
  • Audit Trail – Full transaction history showing expiration events
Member Experience:
  • See expiration date on earned points
  • Countdown timer motivates redemption
  • Clear messaging about point lifecycles
  • Push notifications before expiration
Perfect For:
  • Seasonal campaigns
  • Driving urgency
  • Limiting carried-over inventory
  • Time-sensitive promotions
Analytics Benefits:
  • Track redemption rates
  • Measure urgency impact
  • Optimize point values
  • Reduce unused point liability
Files Modified:
  • packages/models/dto/points-transaction/points-transaction-dto.model.ts – Expiration fields
  • packages/models/dto/user/user-xp-config-dto.model.ts – Expiration config
  • apps/api/lib/service/points-transaction-service.ts – Expiration logic
  • apps/api/lib/query/user/get-user-points-with-expiration.ts – Query optimization
What It Does: Apply temporary points multipliers (1.5x, 2x, 3x) to specific users for limited periods. Perfect for VIP tiers, campaigns, and special events.Features:
  • Configurable Multiplier – Set any multiplier value (1.5x, 2x, 2.5x, 3x, etc.)
  • Time-Limited – Expires after configured duration (7 days, 30 days, etc.)
  • Automatic Cleanup – Expired boosts are automatically removed
  • Stackable – Multiple boosts can be active; highest multiplier applies
  • Audit Trail – Full tracking of boost application and expiration
Use Cases:
  1. VIP Reward Tier – Redeem VIP membership for 2x points (30 days)
  2. Promotional Campaign – All users get 1.5x points during Black Friday
  3. Loyalty Recognition – Long-term members get permanent 1.2x boost
  4. Event Amplifier – Double points during store events
  5. Referral Bonus – Referrer gets 1.5x boost after successful referral
How Admins Use It:
  1. Create Points Boost reward in reward admin
  2. Set multiplier (e.g., 2x) and duration (e.g., 30 days)
  3. User redeems reward → instant multiplier applies
  4. All earned points are multiplied until expiration
  5. Automatic cleanup after duration
Member Visibility:
  • Active boosts shown in user dashboard
  • Expiration countdown visible
  • Clear labeling of boosted points in transaction history
Analytics:
  • Track boost adoption rates
  • Measure engagement impact
  • Compare boosted vs. normal earnings
  • Identify most valuable boost levels
Files Modified:
  • packages/models/dto/user/model/effects/user-effect-points-boost-dto.model.ts – New effect model
  • packages/models/enum/user/user-effect-type.enum.ts – Effect type enum
  • packages/services/service/points-transaction/helpers/points-multiplier.ts – Multiplier logic
  • apps/api/lib/mutation/user/redeem-reward-asset.ts – Redemption
What It Does: Reward users at specific streak milestones (7, 14, 30, 60+ days) to celebrate progress and encourage consistency. Separate from daily/bonus streak rewards.Configuration:
  • Custom Milestones – Set rewards for any day count (7, 14, 21, 30, 60, 100+)
  • Per-Milestone Rewards – Different reward for each milestone
  • Automatic Distribution – Rewards trigger when users hit the milestone
  • Flexible Reward Types – Points, XP, achievement unlocks, or special badges
How It Works:
  1. Admin creates streak with milestone configuration
  2. Sets milestones at days 7, 14, 30, 60
  3. Assigns reward for each milestone
  4. User completes streak activities daily
  5. At day 7 → reward 1, at day 14 → reward 2, etc.
Perfect For:
  • Celebrating consistency
  • Encouraging long-term habits
  • Gamified progression
  • Progress recognition
Member Motivation:
  • Visual progress toward next milestone
  • Celebration rewards at each checkpoint
  • Streaks feel like a journey, not just a counter
Files Modified:
  • packages/models/dto/achievement/achievement-dto.model.ts – Milestone fields
  • packages/models/dto/streak/streak-milestone-config-dto.model.ts – New milestone model
  • apps/api/lib/service/streak-service.ts – Milestone checking logic
What It Does: Preview challenges with a beautiful 3-column layout showing challenge overview, actions, and media side-by-side. Test before publishing to members.Layout Includes:
  • Left Column – Challenge title, description, difficulty, duration
  • Center Column – Ordered list of all challenge actions with details
  • Right Column – Challenge media (images, videos) and visual elements
Preview Features:
  • Real-Time Updates – See changes as you edit
  • Member Perspective – Preview how members will experience the challenge
  • Action Validation – Verify all actions are properly configured
  • Media Verification – Check that all images load correctly
Perfect For:
  • Content review
  • Client sign-off
  • Cross-team collaboration
  • Quality assurance before launch
Files Modified:
  • apps/admin/app/(admin)/admin/engagement/components/challenges/ – Preview components
  • apps/admin/components/challenge-preview/ – New preview layout
What It Does: Admins can now customize widget sections with titles, descriptions, and help text without touching code. Real-time preview shows exactly how members will see it.Customizable Elements:
  • Section Titles – Branded headers for each section (e.g., “Earn Points” → “Climb the Leaderboard”)
  • Section Descriptions – Help text explaining what members can do
  • Tooltips – Contextual help icons with hover explanations
  • All Sections Supported:
    • Achievements
    • Points Balance
    • Leaderboard
    • Referral
    • Streaks
    • Games
    • Rewards
How Admins Use It:
  1. Navigate to Admin Settings → Widget Customization
  2. Select section to customize
  3. Enter custom title and description
  4. Preview in real-time
  5. Changes apply instantly to live widget
Benefits:
  • Personalized member experience
  • No developer involvement needed
  • Localization-friendly
  • Brand consistency
Member Impact:
  • Clear guidance on widget features
  • Personalized experience
  • Reduced support questions
  • Better onboarding
Files Modified:
  • apps/admin/app/(admin)/admin/settings/components/widget-customization/ – Admin panel
  • packages/models/dto/theme/widget-component-config-dto.model.ts – Config models
  • apps/user/app/(widget)/widget/[slug]/_components/sections/ – Widget rendering
What It Does: Test how your widget looks embedded on a website directly from the admin panel. No need to deploy or use a staging site.Features:
  • Live Preview – See your widget in a real iframe
  • Responsive Testing – Test at different viewport sizes
  • Theme Testing – Preview light and dark mode
  • Configuration Testing – Test different theme configurations
  • Copy Embed Code – Get ready-to-use embed code for your website
How Admins Use It:
  1. Open Embed Emulator in admin
  2. Configure iframe settings (size, theme, customizations)
  3. See live preview of how widget looks
  4. Test at different screen sizes
  5. Copy embed code when satisfied
Perfect For:
  • QA before deployment
  • Client presentations
  • Website integration planning
  • Responsive design verification
Files Modified:
  • apps/admin/app/(admin)/admin/settings/components/embed-emulator/ – New component
  • apps/admin/lib/embed/ – Embed utilities
What Changed: Major improvements to the Shopify admin panel including game settings modal with tabbed configuration, onboarding wizard, improved reward management, activity analytics, and simplified settings.Game Settings Modal:
  • Tabbed interface (Settings, Thresholds, Rewards)
  • Clearer game configuration workflow
  • Real-time validation and error messaging
  • Improved UX for complex configurations
Onboarding Wizard:
  • Step-by-step guided setup
  • Progress indicators
  • Contextual help at each step
  • Smart defaults for quick setup
Reward Management:
  • Individual unlink option for discount rewards
  • Inline reward form modal for giveaway/exclusive rewards
  • Cleaner reward consolidation card layout
  • Better visual hierarchy
Activity Analytics:
  • Dashboard chart showing engagement over time
  • Member participation metrics
  • Trend visualization
  • Export-ready data
Settings Improvements:
  • Simplified UI with access & scheduling hidden by default
  • Access type selector disabled for clarity
  • Coming soon teaser for upcoming features
  • Streak and achievement feature toggles
Perfect For:
  • Shopify store admins
  • Faster merchant onboarding
  • Better campaign management
  • Performance monitoring
Files Modified:
  • apps/shopify/app/routes/app.home.tsx – Dashboard with analytics
  • apps/shopify/app/routes/app.game-config.tsx – Game settings modal
  • apps/shopify/app/routes/app.rewards.tsx – Reward management
  • apps/shopify/app/routes/app.settings.tsx – Settings simplification
  • apps/shopify/app/components/wizard/ – Onboarding wizard
  • apps/shopify/app/components/analytics/ – Activity charts
Stability & Quality:
  • Language Config JSON Edit – Root-level JSON edits in language configuration now persist correctly
  • Streak Timeline Fix – Streak timeline reverted to count-based logic for accuracy
  • Streak Completion Status – Correct status display for past days
  • Game Activity Templates – Game completion activities now render templates properly
  • Tag Display – Human-readable tag names in engagement tables
  • Toast Cleanup – Eliminated duplicate notifications and improved error exposure
  • Button Styling – All buttons now use themed border radius for consistency
  • Light Mode Fixes – UI consistency across light/dark modes in challenge/game config pages
  • Layout Skeleton Loading – Layout-aware loading states in community navigation
Files Modified:
  • apps/admin/app/(admin)/admin/engagement/components/challenges/ – Challenge fixes
  • apps/admin/app/(admin)/admin/gamification/(routes)/game-configs/ – Game fixes
  • apps/user/app/(widget)/widget/[slug]/ – Widget improvements
  • apps/api/lib/query/ – Query optimizations

​
Contributors

ZuhayrK00@ZuhayrK0016 commits • +10,085/-1,916

erek_d@me.com@erek_d@me.com15 commits • +76,206/-43,132

jamescockayne@jamescockayne9 commits • +14,828/-3,359

SaadK94@SaadK948 commits • +23,506/-2,674

dch@wenudj.com@dch@wenudj.com8 commits • +7,994/-3,402

​
Release Stats

MetricValue
Total Commits57
Lines Added+129,347
Lines Removed-50,693
Files Changed1,240
Release Size🔴 Massive
Complexity⭐⭐⭐
v2.205.9 deployed on March 9, 2026