Documentation Index
Fetch the complete documentation index at: https://docs.nudj.cx/llms.txt
Use this file to discover all available pages before exploring further.
🔴 Release v2.349.0
⭐⭐⭐ Complex • 102 commits • 2,018 files changedMassive release delivering simplified achievement management, comprehensive e-commerce overhaul for Shopify merchants, redesigned admin control panel with unified brand configuration, new interactive games, enhanced widget deployment, and expanded payment infrastructure. Includes tiered achievement cleanup as single source of truth, custom domain support on Premium plan, ways-to-earn page transformation, point redemption at checkout, and new game experiences.
What’s New
- Tiered Achievements Simplified – Achievement tier management now uses a single source of truth, eliminating complexity in tier configuration and reward distribution
- Refer-a-Friend Widget Controls – Admin-configurable design controls for customizing refer-a-friend widgets with branded appearance and layout options
- Admin Control Panel Redesign – Streamlined navigation, unified brand kit configuration, and improved widget preview system for faster setup
- Challenge Complete Colors – New color customization in brand kit for challenge completion states, extending visual consistency across the platform
- Custom Domains on Premium – White-label support with custom domain configuration for premium organization tiers
- Ways to Earn Overhaul – Completely redesigned Shopify page with improved visual hierarchy, section-based organization, and enhanced merchant controls
- Point Redemption at Checkout – Enable customers to redeem earned loyalty points directly at Shopify checkout with instant deduction
- Supermarket Sweep Game – New interactive game with shopping mechanics, power-ups, and customizable item collections
- Flick Game Enhancements – Improved trajectory physics, mobile-optimized layout, and performance improvements for smoother gameplay
- Comment Moderation Tools – Admin and MCP tools for managing community comments with full moderation workflow
- Widget OAuth Improvements – Popup-first authentication strategy with improved conversion flows for widget deployments
- Shopify Billing Integration – New merchant billing UI, webhook handling, and Stripe payment processing infrastructure
- Asset Library Drop Zone – Drag-and-drop file uploads for community assets with improved asset management
- Quick-Actions Layout Selector – Flexible layout options for quick-actions in both widget and full-app contexts
- Storybook Lite Expansion – Enhanced component library with rewards, fixtures, and improved sidebar organization
Apps Updated
User App
✓ Updated - 18 changes
API
✓ Updated - 31 changes
Admin
✓ Updated - 28 changes
MCP Server
✓ Updated - 5 changes
Games
✓ Updated - 4 changes
Detailed Changes
Admin App
Admin App
Major Features:
- Redesigned navigation with improved information architecture and faster access to key features
- Unified brand kit configuration panel with new sections: widget settings, loyalty hub, challenge complete colors
- Enhanced widget preview system with support for custom domains and improved visibility controls
- Asset library with drag-and-drop upload interface for community images
- Refer-a-friend widget design controls for customizing appearance and behavior
- Onboarding guide implementation with step-by-step walkthrough for new organizations
- Quick-actions layout selector for flexible UI configuration
- Comment moderation tools with collection management and sharing capabilities
- Chat user-scoping, collection rename, and sharing features
- Organization dashboard access from sidebar for multi-org navigation
- Community creation now selects the created community automatically after go-live
- Logo preview refresh on save for immediate visual feedback
- Allocation supply capping when toggling total supply to finite
- Organisation creation now properly supported
- Basketball scoring section now surfaces, with raised default cap
- Compact template library polish restored
- E2E test teardown safety hardening
- Fixed widget preview when allowedDomains are set
- Fixed infinite re-render loop on organization-scoped routes
- Fixed session token cookie cleanup on sign-out (chunked cookie handling)
- Form dirty-tracking and studio preview refresh on save
- Playwright global-teardown safety guards
- Clear welcome organization switcher filter
- Restore org dashboard proxy context
- Admin save legacy onboarding support
- User guide launch steps updated
API
API
Major Features:
- Tiered achievements cleanup with single source of truth for tier configuration
- Prediction action type for new challenge mechanics
- Shopify billing webhook receiver and handling
- Stripe webhook receiver and comprehensive billing engine
- Paywall custom domains support (Premium tier)
- MCP comment moderation tools
- Shopify billing GraphQL mutations
- Achievement criteria now scoped to startsAt/expiresAt window for time-limited achievements
- Unblocked multi-org MCP OAuth with organization picker on consent screen
- Shopify points-for-spend integration enhancements
- Achievement validation and sequential claim tracking
- Better error handling and logging across critical paths
- Fixed legacy onboarding admin save functionality
- Fixed achievement claim edge cases
- Parquet drop cron migrated from Zeplo to QStash
- BetterStack JS-tag circular JSON error handling
User App
User App
Major Features:
- Popup-first widget OAuth strategy chain for improved conversion
- Widget game and referral layouts for flexible content presentation
- Storybook Lite iteration 2 with enhanced rewards, fixtures, and sidebar ordering
- Quick-actions layout selector for flexible UI configuration
- Theme Red preset (Jet2 Holidays) with best-in-class Storybook implementation
- Achievements grid now expands to show more open achievements
- Widget session duration extended from 24h to 30d to match user-app policy
- Lite action titles now properly decode HTML entities
- Parallax banner polish with fixed white blur and improved shrink-then-grow animation
- Prevent carousel card overlap for better visual presentation
- Stop double-firing event token claim across re-mounts
- Stop retry storm when shared queries error
- Block access to draft communities via direct URL
- Complete XP-only challenges now properly supported
- Match community banner skeleton to real banner for better perceived performance
- Drop duplicated CSP from vercel.json
Shopify App
Shopify App
Major Features:
- Ways to Earn page complete overhaul with improved UX, visual hierarchy, and comprehensive test coverage
- Redesigned home dashboard with deltas, period switcher, and program economics visibility
- Merchant billing UI at /app/billing for payment management
- Point redemption at checkout widget for immediate customer reward usage
- Harness-mode local boot with Playwright testing and baseline snapshots
- Shopify theme app extension improvements for post-purchase experiences
- Enhanced games service with comprehensive configuration API
- Better entity row and toggle card components for Ways to Earn sections
- Improved modal tour and baseline snapshot testing for harness mode
- Streaks and leaderboards sections with expanded configuration options
- Product multiplier forms with improved UX and validation
- Earning events section with comprehensive event handling
- Drop originPolicy and widget OAuth error page simplification
- Widget deployment improvements across all integration points
Games
Games
New Games:
- Supermarket Sweep – New shopping-themed game with trolley mechanics, power-ups (bridge, hint, reset), and customizable items collection
- Flick game trajectory improvements with better physics simulation
- Mobile layout optimization for all games
- Performance pass reducing load times and improving frame rates
- Sound configuration UI for game audio customization
- Image size guides documentation for game assets
- Game type selector improvements
- Minimal game config utility enhancements
MCP Server
MCP Server
New Features:
- Comment moderation tools for managing community discussions
- Enhanced achievements configuration tools
- AI image variant handling improvements
- Reward description JSON validation tightening
- Better error handling and validation across all tools
Packages & Infrastructure
Packages & Infrastructure
Database:
- Support for new achievement tier structures
- Comment and moderation data models
- Shopify billing records
- Updated client generation for new endpoints
- New types for billing, comments, and achievements
- New components for comment moderation UI
- Enhanced brand kit color picker components
- Improved form components for complex configurations
- Achievement tier restructuring
- Comment and moderation DTOs
- Payment and billing models
- Storybook dev deployment in CI pipeline
- Shopify harness mode testing integration
- Enhanced E2E teardown safety
For Admins
New Capabilities:- Admin Navigation Redesign – Streamlined menu structure with faster access to configuration
- Unified Brand Configuration – All customization in one place: colors, typography, layouts, widget settings
- Challenge Complete Colors – New color palette controls in brand kit for custom completion states
- Asset Library Management – Drag-and-drop uploads with organized collections
- Refer-a-Friend Widget Controls – Customizable appearance and behavior for referral programs
- Custom Domain White-Labeling – Premium tier support for branded deployments
- Community Quick Setup – Improved wizard with auto-selection after creation
- Comment Moderation Tools – Manage community discussions with dedicated UI
For Users
New Experiences:- Supermarket Sweep Game – New interactive shopping-themed game with power-ups
- Flick Game Polish – Improved mobile experience with better controls
- Widget OAuth – Simpler authentication flow with popup strategy
- Expanded Achievements – Larger grid display for more achievement visibility
- Flexible Layouts – New layout options for quick-actions and content organization
For Shopify Merchants
Commerce Enhancements:- Ways to Earn Redesign – Cleaner interface for managing loyalty mechanics
- Point Redemption at Checkout – Customers can apply points instantly during purchase
- Home Dashboard Improvements – Better visibility into program performance with deltas and period comparison
- Billing Management – Dedicated UI for subscription and payment handling
- Enhanced Configuration – More control over games, streaks, leaderboards, and earning events
Contributors
@derek58 commits • +152K/-26K lines
@jamescockayne15 commits • +19K/-2K lines
@SaadK9413 commits • +46K/-8K lines
@ZuhayrK008 commits • +16K/-376 lines
@dchnudj7 commits • +12K/-674 linesRelease Stats
| Metric | Value |
|---|---|
| Total Commits | 102 |
| Lines Added | +239,598 |
| Lines Removed | -30,153 |
| Files Changed | 2,018 |
| Release Size | Massive |
| Complexity | Complex |
v2.349.0 deployed on May 21, 2026