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.365.0
βββ Complex β’ 28 commits β’ 346 filesAI-powered onboarding guidance, reward configuration transparency, and game reliability overhaul. This release introduces an intelligent onboarding copilot that guides admins through community setup with AI insights, gives you instant visibility into reward earnings during challenge configuration, and fixes critical game mechanics. Plus, extensive stability improvements across all apps.
Whatβs New
- Community Readiness Model & Onboarding Copilot β AI-powered setup guidance that tracks your progress through critical onboarding tasks, identifies gaps in your community configuration, and provides AI-generated insights to accelerate your launch
- Reward Earn Totals Preview β See exactly how many XP points and rewards users will earn from a challenge before you save it, eliminating guesswork during challenge design
- Flick Game Mechanics Complete Overhaul β Fixed crowd/goal/defenders gameplay, added full-game XP tracking, and made all game text editable by admins (including German language variants)
- Catch Game Level 1 Reliability β Level 1 now completes reliably without skill gates, making it a true first-time player experience
- Branding Navigation Unlocked β Single-community organizations can now access full branding customization without navigation restrictions
- Bonus Rewards Display Fixed β Saved Bonus XP/points/rewards now display correctly after you configure them
- Error Reporting Intelligence β Reduced noise in error tracking with intelligent filtering of expected failures, third-party script errors, and optional feature timeouts
Apps Updated
User App
β Updated - Stability and experience improvements
API
β Updated - Community readiness model + onboarding backend
Admin
β Updated - Major onboarding and configuration UX improvements
MCP Server
β Updated - Extended tool capabilities
Games
β Updated - Flick and Catch game reliability fixes
Design System
β Updated - New component patterns for onboarding
Detailed Changes
Admin Panel
Admin Panel
New Features
- Onboarding Copilot β AI-powered task guidance with progress tracking, readiness scoring, and automated task assignment
- Community Program Status Toggle β Visual indicator of your communityβs setup completeness
- Reward Earn Totals β Live preview of XP/points/rewards in challenge configuration forms for Achievements, Quick Quizzes, and Referral rewards
- Walkthrough Progress Tracking β Smart task completion detection and milestone celebrations
- Destination Prompt Workflow β AI-assisted destination selection during onboarding
Fixes & Improvements
- Branding navigation now accessible for single-community organizations
- Action distribution properly hydrates for Bonus XP/points/rewards display
- Quick Quiz now requires a correct answer before saving
- Stale welcome session handling improved
- Optional platform config misses no longer trigger false error reports
- App domain fallback when missing from config
- Team-member user route now properly scoped to authenticated userβs organization
- ObjectId comparisons fixed across admin interfaces
UX Enhancements
- Live widget preview layout with reserved gutter for editor forms
- Better visual feedback for onboarding task status
- Consistent error handling for configuration operations
Games
Games
Flick Game Overhaul (NUDJ-5738)
- Fixed Mechanics β Crowd, goal, and defender interactions now work as designed
- Full-Game XP Tracking β Players now earn XP for the entire game session, not just individual rounds
- Admin-Editable Text Content β All in-game text including German language variants can now be customized by administrators
- German UI Defaults β Comprehensive German translation included and editable at config time
- Text Configuration Defaults β 400+ lines of improved defaults for game text across all languages
Catch Game Improvements (NUDJ-5729)
- Level 1 Reliability β Level 1 now completes reliably without hidden difficulty gates, creating a true first-time player experience
Game Configuration System
- New
GameTextDefaultsConfigfor centralizing text content across game types - Enhanced
GameConfigurationmodel with text-content discriminated union - Admin UI for editing game text content directly in the configuration form
- Support for language-specific text customization
User App
User App
Stability Improvements
- Audio Storage β Guarded access to audio storage prevents crashes on missing permissions
- Multiple Choice Validation β Prevents null answers from being submitted
- Error Report Intelligence β Filtered out 10+ categories of expected failures:
- React Server Component internal parentNode references
- OneTrust script initialization errors
- Optional audio playback failures
- Stale chunk load failures in code-splitting scenarios
- Distribution polling timeouts (now treated as recoverable)
- Expected missing content errors
- Email signin flow cleanup errors
- Stale action completion flows
User Experience Fixes
- Profile Activity Feed β Now renders as a heading instead of a tab for better screen reader support
- Username Validation β Lowercase validation now inline in profile settings and widget profile editor (immediate feedback without server round-trip)
- Email Signin β Handled failures no longer reported to error tracking
- Content Loading β Better recovery from transient network issues
API
API
New Models & Services
- Community Readiness Model β Tracks setup status across 45+ community feature keys with severity levels and tone indicators
- Admin Navigation Status β Tracks which navigation items are available based on community setup state
- Community Links β Structured metadata for community domains and redirect URLs
- AI Setup Stall Detection β Service monitors AI-powered setup workflows for timeouts and provides alerts
- AI Setup Stall Cron Job β Automatic sweep job detects stalled setups and triggers cleanup
Improvements
- Readiness Alignment CI Rule (R1βR7) β Added to lint-and-test workflow to prevent drift between nav status, community readiness, and Launch Guide
- Security β Removed hardcoded super-secret-token auth fallback (was temporary; now all token auth must be explicitly provided)
- Error Logging β Added observability for onboarding tasks (task reviewed, AI setup stalled events)
Packages
Packages
Models & Enums
community-readiness-dto.model.tsβ Full readiness scoring model with issue families, severity, and toneadmin-onboarding-guide-status-dto.model.tsβ Enhanced status tracking (42 lines β 84 lines, now includes task sections + progress)admin-nav-status-dto.model.tsβ New DTO for navigation availability based on readinesscommunity-links-dto.model.tsβ New DTO for structured community domain datacommunity-feature-key.enum.tsβ 45 feature keys for onboarding dependency trackingreadiness-family.enum.tsβ Categorization of readiness issues (setup, compliance, performance, etc.)readiness-issue-severity.enum.tsβ Severity levels (low, medium, high, critical)readiness-tone.enum.tsβ Tone indicators (tip, warning, error, celebration)
Services
ai-setup-stall.service.tsβ Monitors AI setup workflows, logsadmin.onboarding.ai_setup.stalledevents
Observability
- Error Filtering β New Sentry ignore rules for chunk-load failures, optional features, and third-party scripts
- Log-Node Transport β Improved OTel trace context auto-attachment for React Router apps (Shopify)
- BetterStack Tag β Enhanced frontend analytics integration
- Log Shared Utils β Better PII scrubbing and error flattening across transports
Infrastructure & CI
Infrastructure & CI
- Readiness Alignment CI Rule β New
check-readiness.shrule validates whole-file invariants binding community readiness model, nav status, and Launch Guide (blocks merge if drift detected) - Worktree Port Management β Unified slot-based port offsets for multi-worktree development (main on slot 1, worktrees on slots 2β9)
- Dev Stack Script β Enhanced port offset and service management for local development
Admin Highlights
- Onboarding Copilot β AI-powered setup guidance with task tracking, readiness scoring, and smart recommendations to accelerate your community launch
- Community Program Status β One-glance indicator of your setup progress toward launch readiness
- Reward Earn Totals β See exactly how many XP/points/rewards users will earn before you save a challenge
- Bonus Rewards Display β Saved Bonus XP/points/rewards now display correctly in configuration
- Branding for Single-Community Orgs β Full branding customization now accessible without navigation restrictions
- Game Text Configuration β Edit all in-game text directly in admin panel, including language variants
- Quick Quiz Validation β Requires correct answer before saving, preventing broken quizzes
- Better Error Handling β Stale session and missing config no longer disrupt workflow
User Highlights
- Profile Activity Feed β Better accessibility with heading-based navigation instead of tabs
- Instant Username Validation β See validation feedback immediately without network delay
- Catch Game Level 1 β Reliably completable without hidden difficulty, perfect for first-time players
- Better Error Recovery β App handles transient network issues more gracefully, fewer spurious error reports
- Audio Storage β Better handling of audio feature permissions across browsers
- Improved Challenges β Games with full-game XP tracking reward more consistently
Breaking Changes
None in this release. All changes are backward compatible.Technical Notes
Community Readiness Architecture: The readiness model is a discriminated union approach similar to the effects system. Communities track 45+ feature keys with four properties each (family, severity, tone, context). TheBuildOnboardingGuideSnapshot query detects readiness issues on-read (lazy evaluation) and the ai-setup-stall cron monitors AI workflows. This enables responsive UI without continuous polling.
Game Text Scalability: The GameTextDefaultsConfig centralizes 400+ lines of text content, reducing duplication and making language variants maintainable. Game text is now a first-class admin configuration surface, not a string constant.
Error Report Intelligence: The observability improvements filter 10+ categories of expected failures (chunk loads, optional features, third-party scripts). This noise reduction lets oncall focus on real issues while maintaining full error context in logs for debugging.
Release Stats
| Metric | Value |
|---|---|
| Total Commits | 28 |
| Lines Added | +23,919 |
| Lines Removed | -3,218 |
| Files Changed | 346 |
| Release Size | Massive π΄ |
| Complexity | βββ Complex |
Contributors
@erek_d16 commits β’ +19,887/-2,936 lines
@dchnudj4 commits β’ +2,971/-167 lines
@ZuhayrK001 commit β’ +349/-7 lines
@jamescockayne2 commits β’ +359/-41 linesv2.365.0 deployed on June 3, 2026

