π΄ Release v2.264.3
π¨ Complex β’ 10 commits β’ 115 files changedThis 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
User App
User App
- 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
API
API
- Added
ChallengeCompleteStepColorsDtomodel 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
Admin
Admin
- 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
Shopify App
Shopify App
- 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
Design System & Models
Design System & Models
- 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 theChallengeCompleteStepColorsDto 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
Customer Data Hydration Architecture
The hydration system operates in two layers:- Layer 1 (Generic Custom Data) β Captures and stores resolved answers on user profiles as structured data within Nudj, immediately available for segmentation and personalization
- Layer 2 (Platform Sync) β Asynchronously syncs to external platforms (e.g., Shopify customer metafields) without blocking the userβs experience
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
Related Features
- 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
@ZuhayrK004 commits β’ +4,852/-506 lines
@SaadK942 commits β’ +1,491/-43 lines
@dchnudj2 commits β’ +84/-51 lines
@jamescockayne1 commit β’ +234/-257 linesRelease Stats
| Metric | Value |
|---|---|
| Total Commits | 10 |
| Lines Added | +7,027 |
| Lines Removed | -858 |
| Files Changed | 115 |
| Complexity | ββ Moderate |
| Release Size | π΄ Massive |
v2.264.3 deployed on March 31, 2026

