Skip to main content

πŸ”΄ Release v2.260.0

⭐⭐⭐ Complex β€’ 30 commits β€’ 377 files
Massive platform release delivering loyalty tier systems, redesigned widget layouts with AI-powered image generation, multi-language achievement support, and comprehensive theming improvements. This release significantly expands admin configuration capabilities and enhances the visual polish across all user experiences.

What’s New

  • Loyalty Tier System – Create multi-level member tiers (VIP, Elite, etc.) with tier-specific rewards and point multipliers to incentivize higher engagement
  • Redesigned Widget Cards – New card layout options with direct item linking and visual consistency improvements across all widget sections
  • AI Image Generation – Automated FAL.ai image generation for rewards and challenges eliminating manual image uploads
  • Multi-Language Achievement Tiers – Achievement tier names and descriptions now support translation across all supported languages
  • Advanced Theme Controls – Enhanced customization options including custom display fonts, border radius presets, and theming inheritance
  • Game Action Enhancements – Configure game actions to open in new tabs with responsive desktop layouts for better gameplay
  • Customer Data Synchronization – Advanced backend infrastructure for enterprise customer data management and hydration
  • Widget Template System – Foundation for dynamic widget template configurations and section layouts

Apps Updated

User App

βœ“ Updated - 12 major changes

API

βœ“ Updated - 10 major changes

Admin

βœ“ Updated - 15 major changes

MCP Server

β€” No changes

Shopify App

βœ“ Updated - Points-for-spend widget

Games

βœ“ Updated - 4 improvements

Detailed Changes

  • Loyalty Tier Display in Widget – Real-time member tier status showing current and next tier benefits
  • Tiered Reward Card Layout – Visual distinction between tier-specific and universal rewards with tier badge indicators
  • Redeemed Rewards in Spotlight – Showcase previously redeemed rewards alongside available ones in spotlight carousel
  • Theme Font Inheritance – Custom display fonts now properly inherit throughout heading hierarchy
  • Border Radius Customization – Org-level border radius presets applied to all UI components including nav and cards
  • Success Color Token Usage – Replaced hardcoded colors with design system tokens for consistent visual feedback
  • Themed Community Nav – Border radius presets applied to navigation vertical layout for cohesive design
  • Responsive Game Layout – Desktop-optimized game area sizing for improved gameplay experience
  • Game Action Configuration – Game actions respect admin-configured β€œopen in new tab” preference
  • Widget Preview Updates – Real-time preview of widget layouts reflecting all theme customizations
  • Icon Support in Custom Tabs – Custom navigation tabs now support configurable icons for better visual organization
  • Loyalty Tier Configuration CRUD – Complete admin API for creating, reading, updating, and deleting loyalty tier configs
  • Tier Evaluation Service – Backend service evaluating member tier status based on points, XP, and engagement metrics
  • Tier-Aware Multiplier Helpers – Extended point and XP multiplier logic to account for loyalty tier benefits
  • Tier Reward Distribution API – Admin endpoints for configuring tier-specific reward distributions and multipliers
  • Achievement Tier Localization – Multi-language support for tier names and descriptions with alignment across languages
  • Customer Data Hydration Pipeline – Phase 2-4 backend infrastructure for enterprise data synchronization
  • Customer Data Admin UI – Phase 5 admin panel for managing customer data synchronization
  • Widget Template Models – Complete data models for template system with enums and configurations
  • Tiered Achievement Integration – Null guards and safety checks for tiered achievement criteria in integration API
  • ObjectId Validation – Strict format validation for loyalty tier IDs ensuring data integrity
  • Loyalty Tier Configuration Page – Dedicated UI for creating and managing member tier structures
  • Tier Reward Settings – Configure point multipliers, reward access, and benefits for each tier level
  • AI Image Generator – Integrated FAL.ai image generation for rewards and challenges with drag-and-drop upload
  • Widget Template Gallery – Visual template selector showing predefined card layouts and section arrangements
  • Section Reordering – Drag-and-drop interface for reordering widget sections with preview updates
  • Layout Selectors – Visual controls for choosing card layouts (grid, carousel, list) per section
  • Custom Display Font Settings – Admin font selection with inherit option for heading consistency
  • Border Radius Preset Configuration – Org-level border radius control applied globally
  • Footer and Header Settings – Enhanced widget branding controls for top and bottom sections
  • Hero Section Customization – Advanced controls for widget hero image, text, and CTA buttons
  • Content Labels Management – Configure labels and badges for various content types
  • Theme Testing Tools – Real-time widget preview reflecting all customizations and theme changes
  • Achievement Studio – Enhanced achievement form with multi-language tier details editor
  • Challenge Advanced Settings – New advanced tab for game visibility and action configuration
  • Reward Form Enhancements – Updated reward configuration with new layout and option fields
  • Points-for-Spend Nudge Widget – New Shopify storefront widget encouraging purchases with points offers
  • Themable Widget Configuration – Full theming support matching brand colors and typography
  • Catch Game Responsive Layout – Desktop-optimized game area width for better visual balance
  • Action Target Configuration – Admin setting to open game actions in new browser tabs
  • User Action Experience – User app respects action configuration preferences for new tab behavior
  • Widget Template Enums – 8 new template types and component configuration enums
  • Theme DTO Expansion – 230+ new theme configuration fields for enhanced customization
  • Achievement DTO Updates – Extended models for multi-language tier details and criteria
  • Challenge Model Updates – New fields for game visibility and advanced configuration
  • Design System Updates – New components and patterns for tier displays and template galleries
  • Multi-Language Support – 100+ new translation keys across 6 languages
  • Chrome Extension – Nudj Demo Injector tool for rapid demo environment setup
  • E2E Test Coverage – 2 new comprehensive test suites for widget features

Detailed Feature Breakdown

Loyalty Tier System

Loyalty tiers enable you to create a multi-level membership structure that rewards your most engaged community members with exclusive benefits and higher point multipliers. Admin Experience:
  • Create multiple tier levels (e.g., Bronze, Silver, Gold, Platinum) in the admin UI
  • Set tier progression thresholds based on points, XP, or engagement metrics
  • Configure tier-specific point and XP multipliers (e.g., Gold members earn 1.5x points)
  • Assign tier-exclusive rewards that only unlock at specific levels
  • Real-time evaluation of member tier status across the community
Member Experience:
  • See current tier status and benefits directly in the widget
  • View next tier requirements and benefits for motivation
  • Enjoy higher point multipliers for tier-elevated purchases and actions
  • Access exclusive tier-specific rewards and perks
  • Progress visually through tier levels as engagement increases
Technical Details:
  • Tier evaluation happens in real-time on action completion
  • Multipliers apply automatically to XP and points transactions
  • Tier status is community-scoped and independent per organization
  • Supports unlimited tier levels with flexible benefit configuration
Use Cases:
  • VIP customer programs (rewarding high-value customers)
  • Engagement ladders (rewarding most active community members)
  • Referral tiers (exclusive benefits for top referrers)
  • Seasonal tier resets (fresh competitions each quarter)

Widget Card Redesign

The widget’s visual layout receives a comprehensive overhaul with new card design options, direct item linking, and FAL.ai-powered image generation. Card Layout Options:
  • Grid Layout – Classic multi-column grid for browsing many items
  • Carousel Layout – Auto-scrolling carousel for featured item spotlight
  • List Layout – Vertical list view for detailed item information
  • Custom Arrangements – Combine multiple layouts in different widget sections
Direct Item Linking:
  • Rewards link directly to redemption (no modal hop)
  • Challenges open instantly with no loading delays
  • Achievement links navigate directly to achievement detail pages
  • Eliminates friction in the user journey
Visual Enhancements:
  • Consistent card spacing and typography
  • Tier-specific card badges for loyalty tier items
  • Responsive design across all screen sizes
  • Support for custom card backgrounds and borders

AI Image Generation

Automated FAL.ai image generation eliminates the need for manual image uploads and ensures visual consistency across your platform. Admin Features:
  • Generate images on-demand with a single click
  • Configure image generation prompts for each reward/challenge type
  • Upload custom images alongside generated options
  • Automatic image optimization and compression
  • Historical image generation logs for audit trails
Benefits:
  • Save hours on image curation and upload workflows
  • Consistent, professional image quality across all items
  • Quick iteration on visual assets during campaign setup
  • Reduce need for external design resources
Technical Implementation:
  • FAL.ai API integration with secure credential handling
  • Async image generation with progress tracking
  • Automatic CDN distribution of generated images
  • Fallback to placeholder images during generation

Multi-Language Achievement Tiers

Achievement tier names and descriptions now support full internationalization across all supported languages. Admin Experience:
  • Edit tier details in language-specific forms
  • See automatic language alignment suggestions
  • Validate translations before publishing
  • Switch between languages in the achievement editor
User Experience:
  • Achievement tiers display in user’s preferred language
  • Descriptions show localized benefits and requirements
  • Complete locale consistency across all platform languages
  • Proper handling of RTL languages
Technical Details:
  • Language alignment service synchronizes tier details across languages
  • Fallback to English if translation unavailable
  • Support for 6+ languages (configurable per organization)

Enhanced Theme & Customization

Deep customization controls for organizations wanting to align Nudj with brand guidelines and corporate design systems. New Theme Controls:
  • Custom Display Fonts – Select fonts for all headings with inheritance options
  • Border Radius Presets – Organization-wide border radius applied consistently
  • Color Token System – Design system tokens replace hardcoded colors
  • Theme Inheritance – Child settings inherit parent theme defaults unless overridden
  • Success Color Configuration – Customize feedback colors for achievements and actions
Use Cases:
  • Enterprise brand alignment (matching corporate design systems)
  • Dark mode support with proper color contrast
  • Accessibility customization (larger borders, high-contrast colors)
  • Seasonal theme variations (holiday-themed widgets)

Game Experience Improvements

Games module receives a refresh with responsive layouts and new configuration options. Admin Configuration:
  • Toggle β€œOpen in New Tab” for each game action
  • Control visibility of games in the games module
  • Configure game area sizing for desktop displays
User Experience:
  • Game actions respect admin tab preferences
  • Responsive game layouts that scale properly on desktop
  • Faster game loading with optimized asset distribution

Admin Highlights

  • Loyalty Tier Configuration – Create VIP, Elite, or custom tier structures with point multipliers and tier-specific rewards
  • Tier Reward Mapping – Assign exclusive rewards to tier levels and configure tier-based point multipliers
  • Widget Layout Gallery – Visual template selector for card arrangements, carousels, and list views across widget sections
  • Section Reordering – Drag-and-drop widget section management with instant preview updates
  • AI Image Generation – One-click FAL.ai image creation for rewards and challenges eliminating manual uploads
  • Custom Display Fonts – Select and apply corporate-approved fonts to all heading elements
  • Border Radius Presets – Organization-wide border radius control for cohesive visual design
  • Theme Font Inheritance – Automatic font propagation throughout heading hierarchy with override options
  • Achievement Tier Localization – Edit tier names and descriptions in multiple languages
  • Advanced Game Settings – Configure new tab behavior and game visibility toggles
  • Widget Preview System – Real-time preview reflecting all theme and layout customizations
  • Customer Data Management – Enterprise-grade customer data synchronization and hydration (Phase 5)

User Highlights

  • Loyalty Tier Status – See current tier level and path to next tier with exclusive tier benefits displayed
  • Tier-Specific Rewards – Access exclusive rewards unlocked by tier level with clear tier badges
  • Redeemed Rewards Showcase – View previously redeemed items in spotlight section celebrating achievements
  • Direct Item Navigation – Rewards and challenges open instantly without modal intermediaries
  • Responsive Game Experience – Games display properly on desktop with optimized gameplay area
  • Themed Widget – Widget matches your organization’s brand with custom fonts and colors
  • Multi-Language Support – All achievement tiers display in your preferred language with full translation support
  • Game Action Preferences – Game actions respect admin configuration for new tab behavior

Breaking Changes

None in this release.

Technical Notes

Loyalty Tier Architecture: The tier evaluation service operates at action completion time, evaluating member tier status against configured thresholds. Tier context flows through the multiplier helpers (XP and points) enabling tier-aware benefit distribution. Tier configuration is stored at the community level with immutable tier IDs for audit trail integrity. Widget Template System: New template enums support 8 predefined layout patterns with component configuration options. The template system enables future server-side rendering of widget variants without code changes. Section reordering persists to the community theme configuration. Image Generation Pipeline: FAL.ai integration runs asynchronously with progress tracking. Failed generations fall back to placeholder images. Generated images are optimized and distributed via CDN with 30-day retention policy. Multi-Language Achievement Tiers: Language alignment service uses automatic suggestion matching for consistency across 6+ supported languages. Tier details stored separately per language with English as fallback. i18n keys versioned for deprecation tracking. Theme Inheritance System: CSS custom properties cascade through component hierarchy. Border radius preset applies globally at organization level. Custom display fonts compile to font-face declarations at theme generation time. Success color token used consistently in error boundaries and success states.
  • Rewards & Redemption System
  • Achievement Management & Progression
  • Challenge Configuration & Management
  • User Points & XP System
  • Community Theming & Branding
  • Shopify Storefront Integration
  • Analytics & Reporting
  • Referral Rewards System
  • Game Integrations

Contributors

jamescockayne@jamescockayne12 commits β€’ +14,056/-1,736 lines

ZuhayrK00@ZuhayrK009 commits β€’ +2,360/-232 lines

erek_d@erek_d6 commits β€’ +14,233/-2,990 lines

SaadK94@SaadK942 commits β€’ +7,918/-565 lines

Release Stats

MetricValue
Total Commits30
Lines Added+39,986
Lines Removed-6,773
Files Changed377
Release SizeπŸ”΄ Massive
Complexity⭐⭐⭐ Complex
Apps Updated5
Packages Changed6

v2.260.0 deployed on March 27, 2026