Skip to main content

​
🔴 v2.168.0 Release

⭐⭐⭐ Complexity • 24 commits • 652 files
This release introduces a complete visual game builder interface for creating and configuring all game types, advanced RBAC features with per-user access tokens, delayed points distribution for Shopify integration, and significant performance improvements to the admin analytics dashboard. Admins now have a modern, drag-and-drop UI for game configuration alongside improved team management capabilities.

​
What’s New

  • Visual Game Builder UI — Create and configure games without touching JSON. Drag-and-drop interface with real-time preview for all game types (Catch, Flick, Memory, Scratch)
  • Community-Level Game Configs — Manage game configurations at the community level for better flexibility and isolated game management
  • Advanced Team & Access Management — RBAC with per-user API tokens, granular role assignment, and user removal workflows with audit trails
  • Delayed Points Distribution — Schedule points release for Shopify “spend” actions with configurable delay hours for controlled reward timing
  • Transaction History API — Users can now retrieve their points transaction history with pagination and filtering
  • Analytics Dashboard Performance — 50%+ faster dashboard loads with React Query caching, real-time data streams, and optimized database indexes
  • Shopify Sessions Service — New service layer for managing Shopify store sessions with proper credential handling
  • Improved Navigation & UX — Consistent dashboard navigation, better spacing, settings sidebar refinements, and improved form validation

​
Apps Updated

User App

✓ Updated - 17 changes

API

✓ Updated - 207 changes

Admin

✓ Updated - 261 changes

MCP Server

— No changes

Games

— No changes

Docs

✓ Updated - Changelog

​
Detailed Changes

Admin App

Visual Game Builder
  • New modular game builder UI with 80+ components for comprehensive game configuration
  • Real-time game preview in device frames (mobile & tablet)
  • Game type selector with visual cards for Catch, Flick, Memory, and Scratch games
  • Comprehensive configuration sections:
    • Basic info, branding colors, and visual theme settings
    • Game text (titles, descriptions, instructions)
    • Game images and sounds with upload galleries and image size guides
    • Levels and repeatability controls
    • Scoring, rewards, and redemption settings
  • Context-aware forms with validation, tooltips, and collapsible sections
  • Image size guides and asset management for each game type
  • Sidebar navigation for multi-step configuration
Community-Level Game Management
  • Game configs now scoped to individual communities instead of organization-wide
  • Improved game listing and filtering per community
  • Better navigation flow between game creation and existing games
Dashboard & Navigation
  • Improved org/community dashboard layouts with better visual hierarchy
  • Consistent navigation structure across all sections
  • Enhanced quick-access links for faster navigation to key areas
  • Refined date picker header and spacing
  • Better community card designs in grid layouts
  • Improved admin greeting and team switcher UI
Team & Access Management
  • Role-based access control (RBAC) implementation with 5-tier hierarchy
  • Per-user API token generation and management
  • Role assignment UI with badge indicators
  • User addition/removal workflows with confirmation modals
  • Team settings tab with user role management table
  • Enhanced team invitation flows
Form Improvements
  • Fixed game config form validation errors
  • Restored missing fields in game config visual form
  • Improved form error handling and navigation after save
  • Better required field indicators and validation messages
Performance
  • Analytics dashboard loads 50%+ faster with React Query caching
  • Real-time activity feed with optimized data streaming
  • Community visits analytics with cached queries
  • Org stats overview with pre-calculated aggregations
Threshold Rewards Display
  • New comprehensive threshold rewards section in game details view
  • Visual display of all reward thresholds and unlock conditions
  • Separate handling for scratch game rewards vs. threshold-based rewards
  • Enhanced game rewards section with organized reward information
  • Better visual distinction between different reward types
Brand Theme Alignment
  • CSS defaults now sync with Nudj brand theme
  • Consistent color palette across components
  • Improved visual consistency with design system
Points & Transactions
  • New “Get My Transactions” endpoint for user transaction history
  • Paginated points transaction retrieval with filtering
  • Transaction status tracking (pending, released, redeemed)
  • Accounting direction metadata for credit/debit distinction
  • Delayed points distribution system for Shopify “spend” actions
  • Configurable delay hours for controlled points release
  • Pending points tracking with automatic release scheduling
Shopify Integration
  • New Shopify Sessions Service for managing store sessions
  • Migration of Shopify credentials from PlatformConfig to ShopifySessions
  • Proper session lifecycle management
  • ObjectId migration for shopify_sessions collection
  • Enhanced Shopify store linking and credential handling
  • Improved get-shopify-stores endpoint with session-based lookup
Data & Infrastructure
  • New analytics indexes for faster dashboard queries
  • Points transaction store service with advanced querying
  • Queue handler for scheduled points release
  • Improved test data utilities and fixtures
  • API client regeneration with updated schemas
Form Validation Fix
  • Fixed availablePoints schema validation causing 500 errors on /integration/me endpoint
  • Proper schema adherence for all response DTOs
Design System Updates
  • SSR compatibility improvements for browser-specific APIs
  • Rich text renderer with improved server-side rendering
  • Achievement utils with deferred canvas creation for SSR
  • i18n updates for threshold rewards (EN, DE, ES, FR, PT, ZH)
Models & Data Types
  • New GameConfigDTO with community-level scoping
  • ShopifySessionDTO for session management
  • PointsTransactionDTO with transaction status and accounting fields
  • Updated enums for queue names and transaction types
Database
  • New migration: add_pending_points_fields.ts
  • New migration: add-shopify-delay-hours-field.ts
  • New migration: shopify_sessions_objectid_migration.ts
  • Analytics indexes for improved query performance

​
Breaking Changes

Area: Admin - Game ConfigsDescription: Game configurations are now scoped to the community level instead of organization-wide. This means game configs created in one community will not be available in other communities within the same organization.Migration: If you have existing organization-level game configs, you’ll need to either:
  • Create new game configs at the community level in the admin UI using the new visual builder, or
  • Contact support if you need help migrating existing configurations to specific communities
Area: API - Shopify IntegrationDescription: Shopify store credentials have been migrated from PlatformConfig to a dedicated ShopifySessions collection. This improves security and session lifecycle management.Migration: This migration happens automatically during deployment. No action needed from platform admins, but ensure all Shopify stores are reconnected through the updated linking flow to establish proper sessions.

​
Technical Notes

Analytics Performance This release includes significant optimizations to the admin analytics dashboard:
  • React Query caching layer reduces redundant API calls by 70%
  • New MongoDB indexes on frequently-queried fields (location, organisationId)
  • Decomposed analytics queries into specialized services (community stats, org stats, activity feeds)
  • Real-time activity streaming with optimized batch processing
  • Pre-calculated org community previews with aggregated data
Game Builder Architecture The visual game builder uses a modular component system:
  • Type registry pattern for game type configuration
  • Context-based form state management
  • Collapsible sections for progressive disclosure
  • Real-time preview rendering in device frames
  • Validation at form field level with tooltips
Shopify Sessions The new Shopify Sessions Service provides:
  • Proper session lifecycle management (creation, validation, refresh)
  • Separation of concerns from legacy PlatformConfig
  • Future-proof architecture for multi-tenant Shopify scenarios
Delayed Points Distribution Points release can now be scheduled with:
  • Configurable delay hours per Shopify config
  • Queue-based processing for reliable delivery
  • Pending points tracking in user data
  • Automatic release triggers at configured intervals

​
Usage Examples

Before: Editing JSON configuration filesNow:
  1. Navigate to Admin → Gamification → Games
  2. Click “Create New Game”
  3. Select game type (Catch, Flick, Memory, Scratch) from visual card selector
  4. Configure using the sidebar:
    • Basic Info: Title, description, instructions
    • Branding: Colors, fonts, theme
    • Assets: Images and sounds with drag-and-drop upload
    • Levels: Configure difficulty progression
    • Scoring: Set point values
    • Rewards: Add threshold-based rewards
  5. Preview in real-time in device frame
  6. Publish to community
Key Benefits:
  • No JSON editing required
  • Instant preview feedback
  • Guided configuration with help tooltips
  • Community-specific settings
Setup:
  1. Go to Admin → Settings → Team Settings
  2. Click “Add Team Member”
  3. Enter user email
  4. Select role: Viewer, Moderator, Manager, Admin, or SuperAdmin
  5. Generate API token for programmatic access
  6. Copy token and share securely with user
Revoking Access:
  1. Click user in team table
  2. Select new role or remove user entirely
  3. Changes take effect immediately
  4. All API tokens are invalidated on removal
Benefits:
  • Fine-grained access control
  • Per-user API tokens for integrations
  • Audit trail of role changes
  • Quick user provisioning/deprovisioning
Configuration:
  1. Go to Admin → Gamification → Settings
  2. Find Shopify “Points for Spend” config
  3. Set “Points Release Delay”: 48 hours
  4. When customer makes purchase: points marked as “pending”
  5. After 48 hours: points automatically “released” to user
Benefits:
  • Prevent fraud on refunded purchases
  • Build anticipation for reward
  • Better cash flow management
  • Audit trail of delayed releases
As End User:
  1. Make a challenge or purchase
  2. Go to Account → Points History
  3. See all transactions with:
    • Date and amount
    • Transaction type (earned, redeemed, pending)
    • Challenge or reward reference
  4. Filter by status (pending, released, redeemed)
As Developer (API):
GET /integration/me/points-transactions?page=1&limit=50

Returns paginated list:
{
  "items": [
    {
      "id": "...",
      "points": 100,
      "status": "released",
      "direction": "credit",
      "createdAt": "2026-02-17T...",
      "sourceReference": "challenge:123"
    }
  ],
  "total": 245,
  "page": 1,
  "pageSize": 50
}
  • Challenges — Create challenges that award points to users
  • Rewards — Set up redemption rewards for earned points
  • Leaderboards — Rank users by points earned
  • XP System — Alternative progression system alongside points
  • Achievements — Badge-based accomplishment system
  • Shopify Integration — Earn points for store purchases
  • Streaks — Consecutive day tracking with point bonuses

​
Contributors

jamescockayne@jamescockayne5 commits • +161,683/-73,449 lines

ZuhayrK00@ZuhayrK005 commits • +1,258/-2,001 lines

dch@wenudj.com@dch@wenudj.com4 commits • +20,442/-7,383 lines

SaadK94@SaadK942 commits • +14,081/-10,309 lines

erek_d@me.com@erek_d@me.com3 commits • +1,966/-1,212 lines

​
Release Stats

MetricValue
Total Commits24
Lines Added+189,873
Lines Removed-84,469
Files Changed652
Release Size🔴 Massive
Complexity⭐⭐⭐ Complex
v2.168.0 deployed on February 17, 2026