Skip to main content

​
🔴 Release v2.81.1

⭐⭐⭐ Complexity • 5 commits • 107 files changed
Streamlined community routing and enterprise-grade email notification infrastructure. This release empowers administrators to set default communities for faster user onboarding, introduces a visual calendar interface for challenge planning, and lays the foundational architecture for multi-channel notifications (email, SMS, WhatsApp, Telegram). Administrators can now configure intelligent email provider routing and template management directly from the admin panel.

​
What’s New

  • Default Community Selection - Administrators can now designate a default community for their organization, streamlining user navigation and reducing friction during onboarding flows
  • Challenge Calendar View - New calendar interface in admin settings provides at-a-glance visibility into challenge schedules and timing, enabling strategic campaign planning
  • Email Notification Infrastructure - Foundation for enterprise notification system with support for multiple email providers (Resend, SendGrid, SMTP), template customization, and per-community configuration
  • Multi-Channel Notification System - Extensible architecture supporting email, SMS, WhatsApp, and Telegram channels with provider-agnostic configuration and fallback routing
  • Admin Notification Configuration Panel - Manage notification channels, providers, and email templates directly from organization settings without code changes

​
Apps Updated

User App

✓ Updated - 2 changes

API

✓ Updated - 3 changes

Admin

✓ Updated - 2 changes

MCP Server

— No changes

Website

— No changes

Games

— No changes

​
Detailed Changes

Faster User Onboarding Through Smart DefaultsOrganizations can now designate a default community that users are automatically routed to upon login. This eliminates an unnecessary decision point during onboarding and improves the first-time user experience, particularly for organizations running single-community campaigns.Admin Configuration
  • New “Default Community” selector in organization general settings
  • Search and filter interface for easy community discovery
  • Community branding preview (logo and name) in the selector
  • Ability to clear default selection to revert to standard navigation
  • Real-time propagation to user redirect flows
User Experience Improvements
  • Faster time-to-value for new users (fewer navigation steps)
  • Seamless redirect to community dashboard on login
  • Maintains backward compatibility for organizations without a default set
  • Mobile-friendly community selector interface
Backend Architecture
  • New DefaultCommunityService with get/update operations (473 lines)
  • tRPC endpoints for reading and updating default community configuration
  • Comprehensive test coverage (404+ lines) for edge cases and validation
  • Integration with platform config service for multi-tenant isolation
  • Helper utilities for community slug resolution and redirect URL generation
Customer Impact:
  • Organizations: Reduced user confusion during onboarding, faster adoption metrics
  • Community Managers: One less onboarding friction point to manage
  • Admins: Simple one-click configuration with immediate effect across the platform
  • Support Teams: Fewer “where do I start?” questions from new users
Files Changed:
  • apps/admin/app/(admin)/admin/settings/organisation/components/organisation-settings/general-settings/default-community-selector.tsx - Community selection UI
  • packages/api/admin/services/DefaultCommunityService.ts - Core service logic
  • apps/api/routes/trpc/routers/admin/default-community/get-default-community.trpc.ts - Read endpoint
  • apps/api/routes/trpc/routers/admin/default-community/update-default-community.trpc.ts - Update endpoint
  • packages/api/admin/schema.ts - Type-safe schema updates
Strategic Campaign Planning with Visual SchedulingAdministrators now have a calendar-based view of challenges within the admin panel, enabling visual campaign planning and schedule coordination. This provides at-a-glance visibility into challenge timing, helping prevent scheduling conflicts and optimize user engagement patterns.Calendar Features
  • Month/week/day view for flexible perspective on challenge schedules
  • Hover-card with challenge details (name, status, participant count)
  • Color-coded challenge categories for quick visual identification
  • Drag-and-drop interface for quick schedule adjustments (foundation built)
  • Integration with existing challenge management workflows
Admin Experience
  • Located in the challenges section of admin panel (/admin/challenges)
  • Synchronized with the challenges list view for consistency
  • Responsive design for viewing on tablets and desktops
  • Performance-optimized rendering for calendars with 50+ challenges
Technical Implementation
  • New ChallengeCalendar component (292 lines) with rich interaction handling
  • Integration with existing challenges API for real-time data
  • Radix UI hover-card component for detail popover (29 lines)
  • Smooth animations and state management for calendar interactions
  • Proxy route enhancement for expanded API access
Customer Impact:
  • Campaign Managers: Visual planning prevents scheduling conflicts and enables seasonal strategies
  • Engagement Specialists: Better understand challenge distribution across calendar for balanced engagement
  • Operations: Easier to spot and fix scheduling issues before campaign launch
  • Product Teams: Clear visibility into challenge velocity and campaign cadence
Files Changed:
  • apps/admin/app/(routes)/challenges/calendar/challenge-calendar.tsx - Calendar component
  • apps/admin/app/(routes)/challenges/challenges-view.tsx - Integration into challenges page
  • apps/admin/components/ui/hover-card.tsx - Hover-card component for details
  • apps/admin/app/(routes)/challenges/challenges-page-client.tsx - Client-side coordination
Enterprise-Grade Foundation for Multi-Channel CommunicationsThis release introduces comprehensive notification infrastructure supporting multiple email providers (Resend, SendGrid, SMTP) with extensibility for SMS, WhatsApp, and Telegram. Organizations can configure provider credentials and manage email templates without code changes, enabling data-driven engagement campaigns through targeted notifications.Email Provider Support
  • Resend: Modern transactional email service with excellent deliverability
  • SendGrid: Enterprise email platform with advanced analytics and compliance
  • SMTP: Self-hosted or third-party SMTP servers for maximum control
  • Fallback Routing: Automatic failover to backup provider if primary fails
  • Provider-specific configuration per channel (API keys, credentials, settings)
Template Management
  • Global email templates (Magic Link, Admin Invitations, Notifications)
  • Per-community template overrides for brand customization
  • Template variable system for dynamic content (user name, community name, etc.)
  • Base layout components for consistent branding across all emails
Admin Configuration Panel
  • Notification settings in organization configuration
  • Per-channel provider selection and credential management
  • Email template override interface for community branding
  • Test email functionality to verify configuration
  • Provider health status and failure logs
System Architecture
  • New NotificationService (516+ lines) with event-driven architecture
  • Queue-based processing for reliable delivery and retry logic
  • DTOs and enums for type-safe notification configuration (18+ new files)
  • Email integration package with provider adapters (163+ lines per provider)
  • Event mapper for translating platform events to notification payloads
Multi-Channel Foundation
  • SMS channel support (SMS provider config, 86 lines)
  • WhatsApp integration ready (94 lines)
  • Telegram support (58 lines)
  • Extensible channel architecture for future additions
Database Schema
  • New notification_config collection for platform notification settings
  • Support for multi-provider failover chains
  • Template overrides storage per community
  • Channel enable/disable toggle per organization
Customer Impact:
  • Enterprise Administrators: Configure notifications without developer involvement
  • Compliance Teams: Support for multiple providers enables regulatory requirements (SOC 2, HIPAA readiness)
  • Operations: Automatic failover between providers reduces notification delivery risks
  • Community Managers: Branded emails increase user trust and engagement
  • Marketing Teams: Notification data enables engagement metrics and analytics
Backward Compatibility:
  • Legacy notification system removed cleanly
  • No breaking changes to existing webhooks or event systems
  • Gradual migration path for organizations using old notification service
  • Feature flagged implementation for staged rollout
Files Changed (Core Infrastructure):
  • packages/services/service/notification/notification.service.ts - Core service (516 lines)
  • packages/services/integration/email/email.integration.ts - Email provider abstraction (260 lines)
  • packages/services/integration/email/providers/resend.provider.ts - Resend adapter (163 lines)
  • packages/services/integration/email/providers/sendgrid.provider.ts - SendGrid adapter (107 lines)
  • packages/services/integration/email/providers/smtp.provider.ts - SMTP adapter (99 lines)
  • packages/models/dto/notification/index.ts - Notification DTOs and types
  • apps/api/routes/trpc/routers/admin/notification/get-notification-config.trpc.ts - Read config
  • apps/api/routes/trpc/routers/admin/notification/update-notification-config.trpc.ts - Update config (185 lines)
Files Changed (Models & Database):
  • packages/models/dto/platform-config/model/configs/notification/index.ts - Configuration models
  • packages/models/enum/notification/index.ts - Notification type enums (5 files)
  • packages/email-templates/src/admin-invite.tsx - Admin email template (152 lines)
  • packages/email-templates/src/magic-link.tsx - Magic link email template (139 lines)
  • Database migration: add_notification_config_to_platform_configs.ts (72 lines)
Hover Card Component AdditionAdded Radix UI hover-card package to admin app, enabling rich contextual information displays throughout the interface. This component is used in the new calendar view and provides a foundation for consistent hover interactions across admin panels.Impact:
  • Improved visual feedback in complex data displays
  • Consistent interaction patterns matching design system standards
  • Better use of screen real estate through lazy information display

​
Contributors

jamescockayne@jamescockayne2 commits • +1,765/-77 lines • 24 files

SaadK94@SaadK941 commit • +3,654/-599 lines • 79 files

dch@[email protected]1 commit • +380/-3 lines • 6 files

​
Release Stats

MetricValue
Total Commits4
Lines Added+6,111
Lines Removed-681
Files Changed107
Package Changes2 (Database, API Client, Models)
Database Migrations1
v2.81.1 deployed on December 17, 2025