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.360.0

⭐⭐⭐ Complex • 10 commits • 463 files changed
This release brings powerful customization capabilities to gamified experiences, expands social analytics integration, and stabilizes critical AI-assisted content creation workflows. Admins can now tailor game branding to match their community identity, the MCP gains native Facebook/Instagram/TikTok analytics tools, and studio assistant drafting becomes more reliable across all content types.

​
What’s New

  • Game Brand Customization — Admins can now customize ball color, hoop color, score pill styling, button gradients, and text colors for basketball and flick games. Every field is optional, so existing configurations remain unchanged.
  • Post Engagement Visibility — See comment counts on posts in the admin panel for better content moderation and engagement insights.
  • Social Platform Analytics — New RapidAPI-powered tools for Facebook, Instagram, and TikTok analysis in the AI chat, enabling research-driven content strategy.
  • Leaderboard Reward Reliability — Fixed critical issue where rewards weren’t distributed before leaderboard status changed to Expired.
  • Stable Studio Assistant Drafts — AI-generated content drafts for challenges, achievements, and rewards are now more reliable, with improved image generation and template handling.
  • Widget Preview Stability — Fixed rendering issues in the live widget preview and quick action layouts.
  • Brand Research Flow Improvements — Enhanced AI setup wizard workflow with better asset candidate presentation and progress tracking.

​
Apps Updated

User App

✓ Updated - Widget preview & quick actions stabilization

API

✓ Updated - Leaderboard rewards, post comments, game config

Admin

✓ Updated - Game branding, studio assistant, brand research

MCP Server

✓ Updated - Social platform tools

Games

✓ Updated - Brand styling system

Database

✓ Updated - Asset metadata indexes

​
Detailed Changes

Game Appearance Customization (NUDJ-5716)
  • Per-element color overrides for ball, hoop, score pill, buttons, and text
  • Three-tier precedence: per-element override → semantic brand palette → code defaults
  • Backwards-compatible: existing games unaffected unless admin sets values
  • Applies to basketball and flick games
Post Management (NUDJ-682)
  • Comment counts now visible on posts in engagement tables
  • Better insights for content moderation decisions
  • Comment tracking in post queries and mutation handlers
Studio Assistant Stabilization (NUDJ-0000)
  • Fixed draft flow reliability for challenges, achievements, and rewards
  • Improved image generation tool with status tracking
  • Better template handling in guided draft workflows
  • Enhanced brand memory context during content creation
  • Stable widget preview document rendering
Brand Research Enhancements (NUDJ-0000)
  • Improved AI setup wizard flow with better asset suggestions
  • Enhanced brand research progress tracking
  • Better presentation of asset candidates during research
  • Smoother onboarding for community brand configuration
New Social Platform Tools (NUDJ-0000)
  • Facebook API Integration — Analyze page followers, engagement metrics, and content performance
  • Instagram API Integration — Track follower growth, engagement rates, and post performance
  • TikTok API Integration — Monitor account health, video performance, and audience growth
  • All powered by RapidAPI with unified output formatting
  • Integrated into admin AI chat for research-driven decision making
  • Comprehensive test coverage for schema validation and output mapping
Tool Improvements
  • Enhanced system prompt for tools guidance
  • Improved timeouts and error handling for social API calls
Leaderboard Rewards Fix (NUDJ-0000)
  • Fixed critical bug where rewards weren’t distributed before leaderboard status flipped to Expired
  • Schedule handler now ensures proper distribution sequence
  • Comprehensive test coverage for expiration workflows
Database Schema
  • Added asset library metadata indexes for improved query performance
  • Game appearance configuration stored with game config
Game Configuration
  • New GameAppearance DTO for per-element color customization
  • Extended game config models for basketball and flick games
  • Zod schemas for OpenAPI generation
Widget Preview & Rendering
  • Fixed widget preview document stability issues
  • Improved quick action layout rendering (bubble, carousel, marquee)
  • Better embed token generation with authenticated preview support
  • Resolved layout calculation issues in loyalty launcher
Styling
  • Enhanced CSS for widget embedding context
  • Better isolation of widget styles from host page
Flick Game Brand System (NUDJ-5716)
  • New FlickAppearance interface with resolved color properties
  • Semantic brand palette derivation from community colors
  • Three-tier fallback: per-element → semantic → code defaults
  • Supports HSL and hex color normalization
  • Comprehensive test coverage for appearance resolution
Basketball Game Updates
  • Color customization support matching flick game system
  • Updated rendering to use appearance configuration

​
For Admin Users

Game Customization – Configure ball, hoop, button, and text colors for your basketball and flick games to match your community brand. Settings are stored per-game and fall back to defaults if not specified. Content Insights – See comment counts on posts for better understanding of community engagement and content performance. Social Research – Use new Facebook, Instagram, and TikTok analysis tools in the AI chat to research competitor strategies, benchmark engagement, and make data-driven content decisions. Streamlined Content Creation – AI studio assistant now reliably generates draft content for challenges, achievements, and rewards with better image handling and template consistency.

​
Technical Details

Breaking Changes: None Database Migrations:
  • Asset library metadata indexes added for improved query performance
  • No data migration required; backwards-compatible
Performance:
  • Monorepo dependency cleanup improves build times
  • Asset library metadata indexes reduce query latency for large asset collections
  • Optimized admin/MCP build pipeline
New Dependencies:
  • Enhanced RapidAPI integration in MCP server with three new social platform tools

​
Contributors

Derek@erek_d@me.com7 commits • +75,061/-56,346 lines

James@jamescockayne1 commit • +247/-30 lines

DCH@dch@wenudj.com1 commit • +2,188/-201 lines

​
Release Stats

MetricValue
Total Commits10
Lines Added+77,557
Lines Removed-56,379
Files Changed463
Release Size🔴 Massive
Complexity⭐⭐⭐ Complex
v2.360.0 released on May 28, 2026