Skip to main content

πŸ”΄ Release v2.264.3

🎨 Complex β€’ 10 commits β€’ 115 files changed
This release brings powerful customization and data integration capabilities to the Nudj platform. Admins can now fine-tune the look and feel of challenge completions with per-step color customization, merchants gain instant access to leaderboard templates, and Shopify integrations are enhanced with complete customer data hydration and OAuth support. Plus, quality improvements across the UI ensure consistent theming and a cleaner user experience.

What’s New

  • Per-Step Color Customization for Challenge Completions – Customize colors for each screen in the challenge completion flow (loading, leaderboard, XP, points, rewards, stats) to match your brand and create immersive experiences
  • Leaderboard Template Library – Select from pre-built leaderboard templates in Shopify admin with instant preview and one-click setup
  • Customer Data Hydration with OAuth – Capture challenge answers and sync them to Shopify customer profiles for advanced segmentation and personalization (Phase 6+7 complete)
  • Enhanced Signed-Out Widget – Logged-out users now see a clear value proposition before joining your community
  • Theme Consistency Fixes – Border-radius variables now respected across all UI elements; disabled shop and feature flags properly hide associated UI

Apps Updated

User App

βœ“ Updated - 39 files changed

API

βœ“ Updated - 26 files changed

Admin

βœ“ Updated - 38 files changed

MCP Server

β€” No changes

Games

β€” No changes

Shopify App

βœ“ Updated - 12 files changed

Detailed Changes

  • Enhanced challenge completion screen with dynamic color customization per step
  • Improved signed-out widget state with brand value proposition messaging
  • Updated loading, leaderboard, stats, XP, and points screens with theme-aware colors
  • Fixed border-radius theming inconsistencies across immersive view components
  • Added support for light/dark mode color variants in challenge complete flow
  • Updated scratch card animations and starburst effects with configurable colors
  • Added ChallengeCompleteStepColorsDto model for per-step color configuration
  • Extended theme schema to support challenge complete color customization
  • Implemented customer data hydration async job handler for Shopify OAuth
  • Enhanced Shopify metafield queries with improved OAuth integration
  • Added data type validation for hydrated customer data (text, integer, decimal, boolean, date)
  • Queue infrastructure for asynchronous platform sync operations
  • New challenge-complete-colors component with comprehensive color picker interface
  • Per-step color customization in organization branding settings
  • Collapsible color configuration for Loading, Leaderboard, XP, Points, Rewards, and Stats steps
  • Light/dark mode color preview and monochromatic gradient generation
  • Community-level theme color overrides with org-level inheritance
  • Theme schema extensions for challenge complete configuration
  • Updated branding tabs with colors and layout customization panels
  • Leaderboard template library with 5+ pre-built templates
  • Leaderboard template modal with live preview and configuration
  • One-click template application to loyalty leaderboards section
  • OAuth configuration improvements for customer data hydration
  • Enhanced metafield sync with Phase 6+7 customer data integration
  • Shopify app configuration updates for OAuth scopes and endpoints
  • New color picker component with HSL/hex conversion utilities
  • Theme model enhancements for challenge complete step colors
  • Color utility functions for monochromatic gradient generation
  • Leaderboard template TypeScript models and DTO schemas
  • Extended community theme schema for per-step customization

Admin Features

  • Per-Step Color Customization – Control the look of each challenge completion screen: loading animation, leaderboard display, XP earn screen, points display, reward scratch cards, and stats summary
  • Color Editor with Previews – Live preview of light/dark mode color schemes for each step
  • Monochromatic Gradient Support – Automatically generate cohesive color gradients from a single brand color
  • Community-Level Overrides – Override organization colors at the community level while maintaining inheritance
  • Leaderboard Templates – Browse and apply pre-built leaderboard configurations from the template library
  • Customer Data Hydration Configuration – Set up automatic syncing of challenge answers to Shopify customer profiles for customer segmentation
  • OAuth Integration – Secure OAuth authentication for Shopify data sync with token management

User Features

  • Immersive Challenge Completions – Experience brand-customized challenge completion screens with coordinated color schemes
  • Clear Value Proposition – When not logged in, users see what they’ll earn and accomplish by joining the community
  • Consistent Theming – Border-radius and theme variables now properly respected across all UI elements
  • Cleaner Widget Display – Disabled shops and features no longer show irrelevant UI elements
  • Beautiful Leaderboards – Instantly access well-designed leaderboard templates for community engagement

Breaking Changes

None in this release. All changes are backward-compatible.

Technical Details

Challenge Complete Color System

The challenge complete immersive view now supports granular color customization through the ChallengeCompleteStepColorsDto model. Each step (loading, leaderboard, XP, points, rewards, stats) has five configurable color fields:
  • Background – Main background color
  • Accent – Primary accent color
  • Secondary Accent – Secondary accent color for contrast
  • Text – Text color
  • Highlight – Highlight and emphasis color
Both light and dark mode variants are supported, with automatic fallback to organization defaults.

Customer Data Hydration Architecture

The hydration system operates in two layers:
  1. Layer 1 (Generic Custom Data) – Captures and stores resolved answers on user profiles as structured data within Nudj, immediately available for segmentation and personalization
  2. Layer 2 (Platform Sync) – Asynchronously syncs to external platforms (e.g., Shopify customer metafields) without blocking the user’s experience
Supported data types: text, integer, decimal, boolean, date. All action types (multiple choice, open-ended, rating, date selection, etc.) are supported.

Leaderboard Template System

Pre-built templates include configuration for:
  • Display modes (top performers, teams, streaks)
  • Refresh cycles (real-time, hourly, daily, weekly)
  • Scoring mechanisms (points, XP, custom metrics)
  • Visual styling and branding options
  • Achievement integration
  • Customer Data Hydration (Phase 6+7)
  • Theme Customization System
  • Shopify App Integrations
  • Challenge Configuration
  • Community Branding
  • User Engagement Metrics

Per-App Changes

User App

  • Type: feat
  • Summary: Immersive challenge completion with per-step color customization and enhanced signed-out widget value proposition
  • Changes:
    • Enhanced challenge-complete-immersive component with theme-aware coloring
    • Dynamic color application to loading screen, leaderboard, stats, XP, points, and rewards
    • Signed-out widget now shows community value proposition
    • Fixed border-radius CSS variable application across components
    • Added color-to-hex utility for CSS inline styling
    • Color preview generation for light/dark modes

API

  • Type: feat
  • Summary: Customer data hydration Phase 6+7 with OAuth support and challenge complete customization
  • Changes:
    • Added ChallengeCompleteThemeConfigDto for per-step color configuration
    • Extended Theme model with challenge complete colors
    • Implemented async job handler for Shopify customer data sync
    • Enhanced metafield queries and OAuth token management
    • Added data type validation for hydrated customer data
    • Queue infrastructure for non-blocking platform sync operations

Admin

  • Type: feat
  • Summary: Challenge complete color customization interface and leaderboard templates
  • Changes:
    • New challenge-complete-colors component with 1,496 lines of functionality
    • Per-step color picker interface with light/dark preview
    • Organization and community theme schema extensions
    • Branding settings tabs for color and layout customization
    • Leaderboard template library integration
    • Color utility functions for gradient generation

Shopify App

  • Type: feat
  • Summary: Leaderboard template library with OAuth customer data integration
  • Changes:
    • Leaderboard template modal component
    • Template library with live preview
    • Template application to loyalty leaderboards
    • OAuth configuration for customer data sync
    • Shopify app configuration updates
    • Metafield sync improvements

Contributors

ZuhayrK00@ZuhayrK004 commits β€’ +4,852/-506 lines

SaadK94@SaadK942 commits β€’ +1,491/-43 lines

dchnudj@dchnudj2 commits β€’ +84/-51 lines

jamescockayne@jamescockayne1 commit β€’ +234/-257 lines

Release Stats

MetricValue
Total Commits10
Lines Added+7,027
Lines Removed-858
Files Changed115
Complexity⭐⭐ Moderate
Release SizeπŸ”΄ Massive

v2.264.3 deployed on March 31, 2026