🔴 Release v2.221.0
⭐⭐⭐ Complex • 22 commits • 701 files changedThis release introduces achievement tier management, comprehensive referral program configuration, NPS survey actions, and significant performance improvements. Platform administrators can now deeply customize referral rewards and gather customer feedback via NPS surveys, while end users benefit from 56% faster app load times and cleaner reward displays.
What’s New
- Achievement Tier Management – Assign multiple tier levels to achievements with different unlock criteria and reward amounts
- Referral Program Configuration – Complete admin UI and API for setting up referral rewards, conditions, and distribution rules
- NPS Survey Actions – Gather customer feedback with Net Promoter Score surveys, follow-up questions, and detailed analytics
- 56% Faster Cold Compile – Eliminated barrel imports in user app for dramatically improved build and load performance
- Challenge Stats Reconciliation – Fixed data consistency issues in challenge completion tracking and leaderboard calculations
- Clearer Reward Pool UI – Improved admin labels and descriptions for reward allocation and distribution methods
- Shopify Rewards Polish – Hidden stock/supply indicators for Shopify-based rewards to reduce confusion
- Enhanced Embed Authentication – Better support for anonymous login and improved widget embedding experience
Apps Updated
User App
✓ Updated - 2 major features
API
✓ Updated - 4 major features
Admin
✓ Updated - 5 major features
MCP Server
✓ Updated - Infrastructure improvements
Website
— No changes
Games
— No changes
Detailed Changes
Achievement Tiers (NUDJ-1597)
Achievement Tiers (NUDJ-1597)
Made achievement tiers a required system component with automatic migration and backward compatibility shims. This foundational change enables:
- Multiple unlock levels per achievement
- Tier-specific reward configurations
- Progressive achievement unlocking
- Backward compatibility for existing achievements during migration
- Tier configuration during achievement creation/editing
- Default tier generation for referral and streak achievements
- Migration handling with automatic tier assignment
- API shims for seamless data transformation
Referral Program Configuration (NUDJ-4955)
Referral Program Configuration (NUDJ-4955)
Complete rewrite of referral configuration with dedicated admin UI and comprehensive API endpoints. Community managers can now:
- Set referral reward amounts for referrer and referee
- Configure referral conditions (new users only, minimum purchases, etc.)
- Choose from preset condition templates for quick setup
- Configure landing page URLs and incentive messaging
- Preview referral distribution assignments
- Manage reward allocation pools
- Dedicated referral settings page in community configuration
- Condition preset selector with templates
- Reward distribution form with real-time validation
- Landing URL configuration section
GET /admin/communities/referral-config– Fetch current configPATCH /admin/communities/referral-config– Update general settingsPATCH /admin/communities/referral-conditions– Update conditionsPOST /admin/communities/assign-referral-distribution– Distribute referral rewards
NPS Survey Actions (NUDJ-5207)
NPS Survey Actions (NUDJ-5207)
New interaction-based action type enabling customer feedback collection via Net Promoter Score surveys. Admins can:
- Add NPS survey questions to challenges
- Configure follow-up questions based on score ranges (Detractors, Passives, Promoters)
- Set custom question text and response options
- View detailed NPS analytics in challenge statistics
- Track response distribution and trends
- Main NPS question (1-10 scale)
- Follow-up message per NPS segment
- Segment-specific follow-up questions
- Custom XP rewards for survey completion
- NPS score distribution chart
- Response count and participation rate
- Segment breakdown (Detractors, Passives, Promoters)
- Follow-up response analysis
- Clean NPS rating interface (1-10 visual selector)
- Conditional follow-up question display
- Clear feedback submission flow
Challenge Stats Reconciliation (NUDJ-4959)
Challenge Stats Reconciliation (NUDJ-4959)
Fixed denormalization drift in challenge completion statistics by implementing a reconciliation system. This resolves:
- Inaccurate completion counts in leaderboards
- Stale challenge statistics in dashboards
- Data consistency issues from race conditions
- Incomplete historical aggregations
- Queue-based reconciliation system for challenge stats
- Automated sync cron job (configurable frequency)
- Event-driven stat updates with reconciliation fallback
- Bulk stat counter updates for efficiency
- Comprehensive test coverage with 1000+ lines of tests
- Ensures leaderboards show accurate completion counts
- Fixes denormalization inconsistencies automatically
- Reduces manual intervention for data corrections
- Scales to handle large numbers of challenges
Performance: 56% Faster Cold Compile (NUDJ-5236)
Performance: 56% Faster Cold Compile (NUDJ-5236)
Eliminated barrel imports across the user app, resulting in a 56% improvement in cold compile time. This significantly improves:
- Initial page load speed
- Development feedback loop
- CI/CD build times
- User perceived performance
- Direct imports replacing index.ts barrel imports
- Reduced module bundling overhead
- Improved tree-shaking efficiency
- Generated mappings for systematic import refactoring
- Automated codemod for eliminating barrel imports
- Mapping files documenting all import changes
- Systematic refactoring across 500+ files
- Faster local development iterations
- Improved CI pipeline speed
- Better user app responsiveness
- Reduced bundle size for end users
UI/UX Improvements
UI/UX Improvements
Reward Pool Labels (NUDJ-3016):
- Clarified reward distribution method descriptions
- Improved allocation terminology
- Better guidance for pool selection
- Hidden stock/supply indicators for Shopify-based rewards
- Cleaner reward display in both list and detail views
- Reduced visual complexity for Shopify integration
- Enhanced embed.js for anonymous user support
- Improved widget initialization without authentication
- Better embed snippet configuration
- Widget CSS improvements for Shopify integration
- Streak section performance optimizations
For Platform Administrators
- Achievement Tiers System – Create multi-tier achievements with different unlock conditions and reward amounts, enabling progressive gamification
- Referral Program Configuration UI – Complete admin interface for setting up and managing referral rewards, conditions, and distribution
- Referral Preset Templates – Quick-start condition templates (new users, minimum purchase, etc.) for faster referral program setup
- NPS Survey Builder – Add Net Promoter Score surveys to challenges with segment-specific follow-up questions
- NPS Analytics Dashboard – View detailed NPS results including score distribution, segment breakdown, and follow-up responses
- Challenge Stats Dashboard – Accurate, real-time challenge completion counts and leaderboard data with automatic reconciliation
- Clearer Reward Pool UI – Improved labels and descriptions for reward allocation and distribution methods
For End Users
- Cleaner Reward Display – Stock/supply indicators removed from Shopify-based rewards for a simpler reward experience
- Faster App Loading – 56% improvement in cold compile time means significantly faster page loads and better app responsiveness
- Anonymous Widget Access – Enhanced embed support for accessing loyalty program without creating an account
- Better Survey Experience – Intuitive NPS rating interface with clear follow-up flows for providing feedback
Platform Updates
User App
- Eliminated barrel imports for 56% faster cold compile time
- Enhanced embed.js with anonymous authentication support
- Improved widget CSS and Shopify integration
- Hidden stock/supply indicators for Shopify rewards
- Optimized streak section rendering
API
- Achievement tier system with migration and shims
- Referral config endpoints (get, update, assign distribution)
- NPS survey action type with complete validation
- Challenge stats reconciliation queue system
- Event-driven stat aggregation with fallback reconciliation
- Comprehensive API schema updates for new features
Admin
- New referral program configuration page with wizard-style UI
- Referral condition preset selector
- Reward distribution assignment interface
- Landing URL configuration section
- NPS survey form in challenge builder
- NPS results analytics with charts and breakdowns
- Clearer reward pool labels and descriptions
- Updated challenge statistics with reconciliation
MCP Server
- Infrastructure improvements and performance optimizations
Breaking Changes
None. This release maintains full backward compatibility. Achievement migrations are handled automatically with API shims.Technical Notes
Achievement Tiers Migration:- Automatic migration assigns default single-tier structure to existing achievements
- API shims handle read/write operations transparently
- No manual intervention required for existing data
- Replaces previous referral reward form architecture
- Centralized configuration in community settings
- Distribution system based on referral conditions
- Queue-based reconciliation runs periodically
- Event-driven updates for immediate consistency
- Aggregation service ensures leaderboard accuracy
- No user-facing changes to data access patterns
- Tree-shaking now works more efficiently without barrel imports
- Module resolution faster with direct imports
- Reduced JavaScript bundle size for user app
Contributors
@jamescockayne10 commits • +22,227/-5,319 lines • 188 files
@erek_d6 commits • +16,055/-806 lines • 543 files
@dch3 commits • +71/-76 lines • 13 files
@SaadK942 commits • +386/-47 lines • 2 filesRelease Stats
| Metric | Value |
|---|---|
| Total Commits | 22 |
| Lines Added | 38,954 |
| Lines Removed | 6,228 |
| Files Changed | 701 |
| Release Size | 🔴 Massive |
| Complexity | ⭐⭐⭐ Complex |
v2.221.0 deployed on March 13, 2026