Skip to main content

​
🔴 Release v2.244.1

⭐⭐⭐ Complex • 17 commits • 143 files
This release brings three major gamification features to Nudj: Loyalty Tier Systems for tier-based rewards, Tiered Achievements with multi-level progression, and Redemption Expiry Timers to drive urgency. On the Shopify integration side, Free Product Rewards now work via discount functions, and a new Points-for-Spend Nudge Widget educates customers on earning points while shopping. These features unlock new business models for community engagement, from VIP programs to scarcity-driven redemptions.

​
What’s New

​
Admin Features

  • Loyalty Tier System – Set up VIP tier programs where users unlock benefits (multipliers, exclusive rewards, status) based on lifetime spending or points earned
  • Tiered Achievements – Create multi-tier achievements where users see clear visual progress toward unlocking higher tier rewards
  • Safe Zone Preview for Catch Game – Preview how background images will display on mobile when configuring the Catch game
  • Game Pro Tip Translations – Pro tips in games now support all platform languages
  • Free Product Reward Setup – New admin UI to configure free product rewards powered by Shopify’s discount function

​
User-Facing Features

  • Redemption Expiry Countdown – See exactly when rewards expire with live countdown timers in the wallet and spotlight
  • Loyalty Tier Progress Tracking – View current tier, next milestone, and unlocked benefits at a glance
  • Tiered Achievement Progression UI – Clear visual timeline showing tier progression with rewards at each step
  • Shopify Product Page Nudge – Customers see point earning opportunities directly on Shopify product pages

​
Apps Updated

User App

✓ Updated - 6 major changes

API

✓ Updated - 15 major changes

Admin

✓ Updated - 8 major changes

MCP Server

— No changes

Website

— No changes

Games

— No changes

​
Detailed Changes

  • Loyalty Tier Configuration: Complete tier setup UI for naming tiers, setting thresholds, configuring multipliers, and assigning entry rewards
  • Tiered Achievement Builder: New multi-tier achievement form with per-tier rewards, descriptions, and visual configuration
  • Safe Zone Preview: Visual guide showing safe zones when uploading Catch game background images
  • Game Pro Tip Translations: All pro tips now sync across supported languages (EN, DE, ES, FR, PT, ZH)
  • Free Product Reward Modal: New UI for creating free product rewards via Shopify discount functions
  • Redemption Expiry Timers: Countdown timers showing when rewards expire (wallet, spotlight, asset details)
  • Tiered Achievement Timeline: Visual timeline UI showing each tier level with progression toward next tier
  • Reward Asset Card Updates: Enhanced reward cards to display expiry status and claim windows
  • Wallet Organization: Grouped reward view by expiry status and tier level
  • Mobile Optimization: Improved responsive design for redemption deadlines on mobile devices
  • Loyalty Tier Models: CommunityDtoModel extended with loyaltyTierConfig, UserLoyaltyTierStateDtoModel for tracking tier progression
  • Loyalty Tier Migration: Database migration (20260323152743) adding loyalty tier configuration schema
  • Shopify Discount Function Integration: New nudj-free-product extension for cart-line and delivery discounts
  • Product Page Nudge API: Proxy routes for displaying points-for-spend information on Shopify product pages
  • Tier Evaluation Engine: Real-time promotion logic for spending and points-earned metrics
  • Points Multiplier Resolution: Extended multiplier logic to include tier-based multipliers alongside effects
  • Shopify Function Schema: Generated schema for WASM compilation and discount logic

​
Technical Highlights

​
Loyalty Tier System Architecture

The loyalty tier system reuses Nudj’s existing infrastructure for maximum efficiency:
  • Effects System Integration: Tier-based multipliers coexist with temporary effects (XP/Points boosts). The highest active multiplier always wins.
  • Real-Time Evaluation: Tiers are evaluated on qualifying events (OrderPaid for spend, PointsTransaction for points earned) with instant promotion
  • Flexible Metrics: Administrators choose metric source (lifetime spend or lifetime points earned) at community setup
  • No Demotion (Phase 1): Users promote to higher tiers but don’t demote if metrics decline — preserving achievement motivation
  • Entry Rewards: Each tier can trigger a one-time reward distribution when user qualifies

​
Tiered Achievements

Multi-tier achievements follow the existing achievement tier pattern with enhancements:
  • Per-Tier Rewards: Each achievement tier can distribute different rewards (points, XP, items)
  • Visual Progress: Users see all tier levels with clear indication of which they’ve unlocked
  • Event-Based Triggers: Each tier level can be triggered by specific events (OrderPaid, PointsTransaction, AccountCreated)
  • Tier Thresholds: Numeric criteria (e.g., earn 500 points to unlock tier 2)

​
Shopify Free Product Rewards

Powered by Shopify Functions, free product rewards now work via WASM discount logic:
  • Cart-Line Discounts: Individual products discounted to free
  • Delivery Discounts: Free shipping rewards
  • Real-Time Validation: Discount eligibility checked at checkout
  • Refund Handling: Automatic reversal when reward is refunded

​
Release Stats

MetricValue
Total Commits17
Lines Added+18,619
Lines Removed-3,805
Files Changed143
App Coverage3 of 6 apps
Database ChangesYes (loyalty tier schema)

​
Contributors

jamescockayne@jamescockayne13 commits • +19,593/-6,760 lines

ZuhayrK00@ZuhayrK002 commits • +623/-66 lines

dch@wenudj.com@dchnudj1 commit • +1,344/-148 lines

​
Breaking Changes

None. All changes are backward-compatible. Communities without loyalty tier configuration will continue to function normally with tier features disabled by default.

​
Migration Notes

For Administrators:
  • Loyalty tiers are opt-in per community (disabled by default)
  • Existing rewards, achievements, and leaderboards are unaffected
  • No data migration required — tier features are purely additive
For Developers:
  • New DTO models available: LoyaltyTierConfigDtoModel, LoyaltyTierStateDtoModel, LoyaltyTierDefinitionDtoModel
  • New enums: LoyaltyTierMetricEnum, LoyaltyTierPeriodEnum, LoyaltyTierDemotionEnum, LoyaltyTierChangeReasonEnum
  • New Shopify extension: nudj-free-product (WASM-based discount functions)
  • Multiplier helpers extended: getHighestActivePointsMultiplier() and getHighestActiveXpMultiplier() now check tier state
v2.244.1 deployed on March 24, 2026