Skip to main content

​
🔴 v2.98.0 - Community-Level Theming & Admin Experience Enhancements

⭐⭐ Moderate Complexity • 12 commits • 1,560 files changed
This release brings comprehensive community-level branding and theming capabilities to Nudj, along with significant quality-of-life improvements for administrators. Admins can now customize the look and feel of communities with full color control, accessibility checks, and real-time previews. Plus, improved timezone handling, enhanced validation, and better cache management throughout the platform.

​
What’s New

  • Community-Level Branding & Theming - Full control over community colors, logos, and visual identity with built-in accessibility validation
  • Timezone Clarity for Admins - Side-by-side timezone comparisons when scheduling challenges and rewards, with DST and date rollover warnings
  • Enhanced Admin Navigation - Redesigned command menu with search capabilities for quick access to challenges, rewards, and achievements
  • Intelligent Cache Invalidation - Automatic cache refresh when creating or updating challenges, rewards, and actions across communities
  • Improved Answer Validation - Enhanced validation for multiple-choice questions to prevent submission errors
  • Admin Challenge Previewing - Admins can now preview scheduled (unpublished) challenges before they go live

​
Apps Updated

User App

✓ Updated - 6 changes

API

✓ Updated - 8 changes

Admin

✓ Updated - 23 changes

MCP Server

✓ Updated - 1 change

Design System

✓ Updated - Multiple components

API Client

✓ Updated - Schema changes

​
Detailed Changes

Admins can now create and customize the visual identity of each community with full control over colors, logos, and typography.Key Capabilities:
  • Custom Color Palettes - Set primary, secondary, and accent colors for each community
  • Logo & Brand Assets - Upload and manage community logos and branding materials
  • Accessibility Validation - Built-in WCAG compliance checking to ensure color contrast meets accessibility standards
  • Real-Time Previews - See theming changes instantly reflected across community spaces
  • Theme Inheritance - Themes automatically apply to challenges, rewards, achievements, and leaderboards
  • Deep Merge Support - Override specific theme elements without losing organization defaults
Technical Highlights:
  • New community-theme-schema.ts for validation and type safety
  • Color accessibility utilities with WCAG AAA compliance checking
  • Theme inheritance system using deep merge utilities
  • Comprehensive test coverage for theme creation and updates
Files Changed: 48 files across admin, user app, and API
When scheduling challenges, rewards, achievements, and campaigns, admins now see clear timezone information to prevent scheduling errors.Key Improvements:
  • Dual Timezone Display - See scheduled times in both admin’s local timezone and organization timezone
  • Time Difference Indicator - Displays hours and minutes difference between timezones
  • DST Transition Warnings - Alerts when Daylight Saving Time is active
  • Date Rollover Detection - Warns if scheduled time falls on a different date in user’s timezone
  • Visual Organization - Clean card-based layout with icons and color-coded warnings
Affected Scheduling Areas:
  • Challenge scheduling
  • Reward scheduling
  • Achievement scheduling
  • Leaderboard scheduling
  • Campaign scheduling
Files Changed: 14 files with new timezone utilities and UI components
Enhanced the admin command menu for faster navigation and better usability.Key Improvements:
  • Unified Search - Single command palette to quickly find and navigate to any challenge, reward, or achievement
  • Organization Switcher - Enhanced switcher for faster organization context switching
  • Team Switcher - Improved team selection interface
  • Keyboard Navigation - Full keyboard shortcut support for power users
  • Result Grouping - Search results organized by type with visual icons and descriptions
  • Feature Flag Updates - Improved authentication and feature flag settings UI
Files Changed: 10 files focused on navigation and search
Automatic cache management when creating or updating platform content, reducing manual refresh requirements.Coverage:
  • Challenge creation and updates
  • Reward creation and updates
  • Achievement creation and updates
  • Action creation and updates
  • Distribution detail assignments
Benefit: Users see updated challenges and rewards immediately without requiring page refresh or re-loginFiles Changed: 8 API router files with cache invalidation logic
Admins can now preview unpublished, scheduled challenges before they go live to users.Key Features:
  • Preview Mode - View exactly how scheduled challenges will appear to end users
  • Action Wizard Preview - See challenge actions and flow before publication
  • Challenge Details - Full view of challenge information, rewards, and progression
  • Conditional Rendering - Correctly shows challenge state during preview
Files Changed: 7 files supporting admin preview flow
Improved validation for multiple-choice questions prevents incomplete submissions.Improvements:
  • Answer Selection Validation - Ensures at least one answer is selected before submission
  • Error Prevention - Clear feedback if submission is attempted without valid answers
  • Quiz Mode Support - Validation works correctly in both standard and quiz modes
Files Changed: 1 file with enhanced validation logic
Backend improvements for cache management and query optimization.Changes:
  • Cache invalidation on challenge/reward/action updates
  • Community-level theme validation and persistence
  • Enhanced error handling for theme operations
  • Test coverage for theme creation and updates
Files Changed: 8 files
Updated shared components and data models to support new theming features.Updates:
  • Extended theme schema with community-level customization
  • New color picker component with accessibility validation
  • Updated datetime picker with timezone support
  • New timezone-dual-display component for clarity
Files Changed: Multiple files across design system

​
Breaking Changes

None - This is a fully backward-compatible release. All existing community configurations continue to work without changes.

​
Technical Highlights

Community-Level Theming Architecture:
  • Hierarchical theme system with organization defaults and community overrides
  • Deep merge utilities for intelligent theme composition
  • WCAG AAA color accessibility validation
  • Comprehensive test coverage (252 new tests for create-community, 382 for update-community)
Timezone Handling:
  • Robust timezone detection and formatting using date-fns with timezone support
  • DST transition detection
  • Date rollover detection across timezone boundaries
  • New timezone utility library with comprehensive formatting options
Cache Strategy:
  • Automatic invalidation on content creation/updates
  • Cache busting for dependent queries
  • Reduced need for manual refresh or re-login
Admin UX:
  • Enhanced command palette with search across all community assets
  • Improved organization/team switching
  • Better visual hierarchy in navigation

​
Migration & Adoption

For Admins:
  1. No action required - All existing setups continue to work
  2. To use new theming - Go to Community Settings > Branding & Appearance to customize
  3. For scheduling - Updated scheduling interfaces show timezone information automatically
For Developers:
  • Community themes accessed via updated API endpoints
  • New community-theme-schema for theme validation
  • Enhanced cache invalidation utilities in place
  • TypeScript types updated for theme objects

​
Migration Guide (If Needed)

Community theming is optional and fully backward-compatible. Existing communities without custom themes use organization defaults. To migrate to community-level theming:
  1. Navigate to each community’s settings
  2. Go to “Branding & Appearance” tab
  3. Customize colors, logos, and visual elements
  4. Run accessibility check (performed automatically)
  5. Preview changes in real-time
  6. Publish when ready

​
Contributors

ZuhayrK00@ZuhayrK004 commits • +19,017/-10,840 linesCommunity theming, color accessibility, design system updates

dch@wenudj.com@dchnudj4 commits • +1,233/-419 linesAdmin QoL, timezone handling, cache invalidation

erek_d@me.com@Derek Counihan2 commits • +8/-334,857 linesMonorepo housekeeping, website removal

SaadK94@SaadK941 commit • +89/-33 linesAdmin preview for scheduled challenges

​
Release Stats

MetricValue
Total Commits12
Lines Added+10,649
Lines Removed-347,613
Files Changed1,560
Release Size🔴 Massive
Complexity⭐⭐ Moderate

​
What’s Next

Future releases will expand on theming with:
  • Per-action styling overrides
  • Template-based theming for faster setup
  • A/B testing for different color schemes
  • Analytics on theme performance
v2.98.0 deployed on December 23, 2025