Skip to main content

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.359.0 - Community Onboarding, Predictions & Loyalty Tier Design

⭐⭐⭐ Complex • 37 commits • 714 files changed
Transform Community Engagement from Day One — v2.359.0 introduces brand-driven onboarding, a powerful prediction & reward distribution system, the Stack 3D city game, customizable loyalty tier designs, and custom event schemas for tracking domain-specific community actions. Admins gain full analytics coverage, Shopify sellers get a launch guide, and end users enjoy improved UI clarity with clickable badges and themed challenge completions. This release is built for communities that want to scale engagement with branded experiences and data-driven decision making.

​
What’s New

  • Brand-Driven Community Onboarding — Setup wizard now fully customizable with organization branding, logos, and themes; AI-powered template selection for faster launch
  • Prediction Resolution & Reward Distribution — Create predictions/outcomes, resolve them with automatic reward distribution to winners
  • Stack 3D City Game Integration — New immersive 3D city-building game with configurable difficulty, scoring, sounds, and branding
  • Loyalty Tier Design Controls — Full visual customization of loyalty tier display in the widget with tier-specific rewards showcase
  • Custom Event Schemas — Define custom events for tracking domain-specific user actions with flexible validation and live testing
  • PostHog Analytics Coverage — Comprehensive analytics instrumentation across admin operations, API interactions, chat, and user navigation
  • Shopify Launch Guide — Step-by-step setup checklist for Shopify sellers using the onboarding API
  • Improved User Experience — Clickable profile badges, visible challenge completion buttons, compact coin balance display

​
Who Benefits

End Users: Navigate a branded community experience from day one, interact with new 3D games, and see clearer reward information with customized loyalty tier displays. Community Managers: Launch communities faster with AI-assisted onboarding, track custom domain-specific events, and resolve predictions with automatic winner payouts. Platform Administrators: Fully customize the onboarding experience with brand assets, design loyalty tiers visually, define tracking schemas, and gain comprehensive analytics on all admin operations. Shopify Merchants: Follow a guided launch checklist from your Shopify admin to get up and running quickly.

​
Apps Updated

User App

✓ Updated - UI improvements, game integration

API

✓ Updated - Predictions, schemas, predictions filtering

Admin

✓ Updated - Onboarding, predictions, tier design, analytics

MCP Server

✓ Updated - HTTP transport, AI improvements

Games

✓ Updated - Stack 3D game integration

​
Detailed Changes

Onboarding & Setup
  • Brand-driven community onboarding with full customization of logos, colors, and themes
  • AI-powered template selection and ordering based on community type
  • Enhanced setup wizard with improved reliability and state management
  • Template library with preview and search capabilities
  • Launch guide card on dashboard for quick access to setup status
Prediction & Outcome Management
  • Predictions page under Engagement section for viewing all predictions
  • Resolve prediction dialog with outcome selection and automatic reward distribution
  • Unresolved predictions banner alerting admins to pending resolutions
  • Pagination and filtering for managing large numbers of predictions
Loyalty Tier Design
  • Full visual customization controls for loyalty tier widget appearance
  • Tier-specific rewards showcase with configurable display
  • Live preview of tier design changes
  • Integration with widget configuration system
Custom Event Schemas
  • Event schemas page for defining custom events and properties
  • Schema editor with live event testing and validation
  • Property type definitions with flexible validation rules
  • State management for published vs draft schemas
  • Activity summary and audit trail
Analytics & Observability
  • Comprehensive PostHog analytics coverage across all admin operations
  • API operation tracking with method, route, status, and duration metrics
  • Navigation and interaction analytics for understanding user workflows
  • Feature usage tracking with event categorization
  • User identity and organization context in all events
  • Chat analytics including message submission, tool approval, and voice interactions
Other Improvements
  • Ask Nudj chat persistence and queue management system
  • Improved scroll position restoration on modal close
  • Create variable mutation envelope fixes
  • Infinite loop prevention in useConfigVariables
UI/UX Fixes
  • Inner scroll container restoration on Ask Nudj close
  • Main scroll position restoration
  • Fixed form input behavior during validation
Prediction System
  • Prediction resolution mutation with outcome selection
  • Automatic reward distribution to winning users
  • Pagination and filtering for prediction listing
  • Status tracking (unresolved, resolved)
  • Distribution details assignment for resolved predictions
Custom Event Schemas
  • Event schema creation and management mutations
  • Schema publishing workflow (draft → published)
  • Custom event payload validation against defined schemas
  • Schema deletion with safeguards
  • Activity summary for schema audit trails
  • Live event testing in editor
Integration Improvements
  • Prediction filtering on integration actions endpoint
  • Filter parameters for outcome status and prediction type
  • Improved action listing with prediction context
Fixes & Performance
  • Reject action participation on completed challenges with 409 status
  • Remove transactions from DDL migrations for better performance
  • Restore API rootDomain Vercel aliasing on organization creation
  • Reserved domain guard and fail-fast MCP auth error handling
  • Use --allow-updates instead of removed --force flag for Shopify CLI deploy
Infrastructure
  • OTel/Logtail logging improvements and structured field standardization
  • High-risk areas marking for auth, routing, API proxy code paths
Launch Guide
  • Onboarding guide page reusing admin onboarding API
  • Getting started checklist for Shopify sellers
  • Task definitions for launch workflow
  • Live dashboard card showing onboarding status
  • Task completion tracking and progress visualization
Other Improvements
  • Unblock dev deploy by removing inline biome step
  • Launch guide component integration
Games
  • Stack 3D city game integration with full platform support
  • Game configuration and launch from challenges
UI Improvements
  • Make profile badges clickable to open detail modal
  • Make challenge completion “Go Home” button visible and themeable in preview
  • Compact coin balance display for cleaner wallet UI
  • Improved mobile responsiveness
Performance
  • Reduce Sentry trace sample rate to optimize BetterStack costs
Improvements
  • Standardize on Streamable HTTP transport
  • Route challenge assistant through Ask Nudj
  • MCP auth error handling improvements
  • Token validation enhancements
Schema Changes
  • Custom event schema storage and indexing
  • Prediction resolution tracking
  • Loyalty tier widget configuration extensions
Migrations
  • Transaction removal from DDL migrations
  • Schema versioning for custom events
Design System
  • New components for event schema editor
  • Loyalty tier visualization components
  • Prediction dialog and resolution UI components
  • Enhanced notification and modal styles
API Client
  • Generated client types for new mutations and queries
  • Prediction and schema endpoint definitions
  • Integration filtering parameters

​
Technical Highlights

Custom Event Schemas Architecture — The custom event schema system enables organizations to define validation rules for domain-specific events without modifying the platform code. Schemas are versioned, support flexible property types, and include live testing in the editor. Prediction Resolution with Automatic Rewards — Predictions can be resolved with multiple outcomes, automatically distributing rewards to eligible users based on the selected outcome. The system integrates with the existing reward distribution pipeline. Brand-Driven Onboarding — The setup wizard now fully supports organization branding, including custom logos, color themes, and brand memory that flows through to the Chat AI. AI-powered template selection accelerates community creation. Loyalty Tier Visual Customization — Loyalty tiers now support configurable visual presentation in the widget, including tier-specific reward displays and custom branding per tier level. Analytics Foundation — PostHog integration across the admin app provides comprehensive coverage of user interactions, API operations, and feature usage with structured event taxonomy and proper PII scrubbing.

​
Contributors

Derek Counihan@erek_d14 commits • +85,223/-75,147 lines • 423 files

SaadK94@SaadK9412 commits • +5,237/-1,323 lines • 89 files

ZuhayrK00@ZuhayrK004 commits • +6,890/-720 lines • 64 files

James Cockayne@jamescockayne3 commits • +63,730/-39,662 lines • 212 files

​
Release Stats

MetricValue
Total Commits37
Lines Added+88,305
Lines Removed-43,686
Files Changed714
Release SizeMassive
ComplexityComplex ⭐⭐⭐

​
Breaking Changes

None. All changes are backward compatible.
v2.359.0 deployed on May 27, 2026