> ## 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.448.5

> Released July 14, 2026

## 🔴 Release v2.448.5

⭐⭐⭐ Complex • 64 commits • 879 files changed

<Note>
  This massive release brings the in-app notification inbox to users — a complete communication platform with desktop and widget notification bells, multi-channel admin controls, and deep platform stability improvements. Admins gain drag-and-drop chat queue management, AI-powered suggestions, per-section widget customization, and the ability to preview draft content before publishing. Additional polish across games, UI/UX, and API data integrity.
</Note>

## What's New

* **In-app notification inbox** with desktop and widget notification bells, plus admin multi-channel control panel
* **Drag-and-drop queue reordering** in admin chat with intelligent steering from queue context
* **AI-generated post-action and starter suggestions** for faster challenge creation
* **Per-section widget theming** — customize appearance of each home section independently
* **Draft entity preview mode** — admins can preview unpublished challenges, games, posts, and achievements
* **Live widget surface context** attached to admin chat for real-time editing feedback
* **Improved Shopify widget loading** with enhanced performance and reliability
* **Multi-tenant data safety** — fixed concurrent reward updates, null image handling, and API data integrity

## Apps Updated

<CardGroup cols={3}>
  <Card title="User App" icon="mobile">
    ✓ Updated - 95 changes
  </Card>

  <Card title="API" icon="server">
    ✓ Updated - 156 changes
  </Card>

  <Card title="Admin" icon="gear">
    ✓ Updated - 418 changes
  </Card>

  <Card title="MCP Server" icon="robot">
    ✓ Updated - 32 changes
  </Card>

  <Card title="Design System" icon="palette">
    ✓ Updated - 47 changes
  </Card>

  <Card title="Games" icon="gamepad2">
    ✓ Updated - 84 changes
  </Card>
</CardGroup>

## Detailed Changes

<AccordionGroup>
  <Accordion title="User App" icon="mobile">
    **Core Features**

    * In-app notification inbox with paginated list, unread indicators, and action routing
    * Notification bell button for desktop navigation header
    * Notification bell card for widget navigation menu
    * Inline notification drawer support across all screens
    * Per-section widget theming with content, layout, and style customization
    * Split widget card and panel styling for independent theme boundaries
    * Draft entity rendering support with admin preview grant forwarding

    **Improvements**

    * Improved Shopify widget loading performance and reliability
    * Brand widget landing logo adjusted for contrast and visibility
    * Guest sign-out hidden from navigation (guests see no sign-out option)
    * Profile and settings pages gated from guest access
    * Solid header rendering when only one gradient stop is set

    **Infrastructure**

    * Added stable product test selectors for E2E testing
    * Enhanced draft entity coverage (actions, games, posts, leaderboards)
  </Accordion>

  <Accordion title="API" icon="server">
    **Core Features**

    * In-app notification API with get, list, mark-read, and mark-all-read endpoints
    * Paginated notification queries with community filtering
    * In-app notifications always-on (decoupled from email opt-out)
    * Notification channel configuration and management

    **Reliability & Data Integrity**

    * Fixed concurrent reward update handling — no longer loses writes under contention
    * Fixed null image handling in games list (prevents 500 errors)
    * Accept read-emitted nulls on game writes without validation errors
    * Default distribution amounts for reward configurations
    * ISO-date-string Zod validator shared across modules

    **Admin Features**

    * Draft entity support for admin previews (challenges, games, posts, leaderboards)
    * Status-with-drafts filter for admin preview mode
    * Admin preview grant validation on draft entities
    * Shopify webhook order routing for app-prefixed events
    * Community-scoped entitlement checking for features

    **Improvements**

    * Pagination validator deduplication (shared across endpoints)
    * Brand memory syncing with community profile
    * Chat prompt context optimization (reduced token usage)
  </Accordion>

  <Accordion title="Admin" icon="gear">
    **Major Features**

    * **Notification Inbox Control Panel** — multi-channel configuration, notification type routing, member inbox toggle
    * **Drag-and-drop Chat Queue** — reorder queue items with mouse/touch, intelligent steering based on queue context
    * **AI-Generated Chat Suggestions** — post-action suggestions and starter suggestion chips for faster setup
    * **Per-Section Widget Theming** — independent content/layout/style controls for each home section
    * **Rich Widget Section Editing** in chat with live preview
    * **Live Widget Surface Context** — chat can see and modify the exact widget surface being edited

    **Improvements**

    * Template copy creation flows unified and aligned
    * Game preview fits at 100% zoom with live-update while editing
    * Branding colors step exposed for Sweep game builder
    * Challenge editor tooltips + empty/error states
    * Unsaved changes guard DRY'd across all admin forms
    * Chat queue reload protection (no wipe on reload)
    * Chat default fallback to Kimi K2.6 Nitro model
    * Mobile chat experience optimized
    * Compact chat tool result cards
    * Shopify agent and chat suggestions gated on store connection
    * Match-to-community button reads community brand kit (not org theme)
    * Back-to-Game-Configs link added to game-type selection
    * Allow removing Flick game images (nullish schema support)
    * Community settings sidebar header renamed to "Configuration"

    **Gamification Admin**

    * Daily Check-in toggle gated behind streaks paywall
    * Score-threshold "Maximum Score" field accepts keyboard input
    * Achievement creation client streamlined

    **Fixes & Polish**

    * Removed dead links from user settings nav
    * PR preview classification from VERCEL\_ENV (proper test environment detection)
    * Classify raw Vercel admin hosts correctly
    * Game score-threshold validation improvements
  </Accordion>

  <Accordion title="MCP Server" icon="robot">
    **New Features**

    * Expose widget embed domains for iframe integration
    * Brand memory synced with community profile for consistent styling

    **Improvements**

    * Chat prompt context reduced for faster response times
  </Accordion>

  <Accordion title="Games" icon="gamepad2">
    **Image & Asset Handling**

    * Basketball hoop/ball images optional + relabel hoop as backboard decal
    * Flick game allows image removal (nullish schema)
    * Branding colors step for Sweep game builder
    * Sweep uploaded art renders via raw `<img>` (not next/image)
    * Platform-wide broken-image guard for all game renderers

    **Data Integrity**

    * Strip empty catch item slots from game state
    * Guard broken images across all game types
    * Prevent null images from breaking games list
  </Accordion>

  <Accordion title="Design System & Packages" icon="palette">
    **i18n Updates**

    * Notification inbox translations (de, en, es, fr, pt, zh)
    * Notification channel configuration strings
    * Notification type labels

    **Models & Types**

    * InAppNotificationPublic schema for client integration
    * NotificationChannel enum for multi-channel support
    * Widget section design enums for theming

    **Infrastructure**

    * Design-sync state added for Admin Design System
    * Feature flag for in-app notification inbox (FeatureKeyEnum)
  </Accordion>

  <Accordion title="Infrastructure & CI/CD" icon="wrench">
    **Development**

    * Reintroduce staggered dev port slots per checkout (slot 1, 2, 3)
    * Pass slot ports to admin dev server via env
    * Cap Turbopack dev-server memory via turbopackMemoryLimit
    * Cap dev-server RAM via Next.js 16.3 canary (local-only)

    **Quality & Testing**

    * Run admin, user, and MCP unit tests in path-scoped CI
    * Setup guide panel tests (127 lines)
    * Chat queue integration tests
    * Chat queue reducer tests (discriminated union validation)
    * Session summary tests expanded
    * Tool card registry tests
    * Admin preview grant tests

    **Dependencies & Security**

    * Resolve 85 dependabot security alerts via lockfile re-resolution
    * Upgrade dependencies across dev + prod

    **CI/CD Optimization**

    * Gate Shopify harness on merge-queue diffs (cost optimization)
    * Harden team linear-ship skill (Linear state + reviewer gating)
    * Finish Jira→Linear migration in .coderabbit.yaml
    * Database E2E smoke org provisioning script
  </Accordion>
</AccordionGroup>

## Key Customer Benefits

### For End Users

* **Stay in the loop** — Desktop and widget notification bells keep you updated without leaving the platform
* **Read at your pace** — Inbox organizes all platform notifications in one place with clear read status
* **Discover more** — Watch your custom home sections adapt to your community's unique branding

### For Community Managers & Admins

* **Control the message** — Multi-channel notification configuration puts you in the driver's seat
* **Faster creation** — AI suggestions speed up challenge and post setup
* **Visual confidence** — Draft preview mode lets you test before going live to the community
* **Flexible theming** — Customize widget appearance section-by-section without rebuilding
* **Smarter queue** — Drag and drop chat requests, AI-powered context makes setup faster

## Known Limitations

* In-app notifications are always-on for users (separate from email preferences) — users cannot opt out of in-app delivery
* Widget section theming requires admin configuration; defaults to organization theme if not set
* Draft entity preview is admin-only; community members see only live content

## Breaking Changes

None — this release is fully backward compatible.

## Technical Highlights

**Data Safety**: Concurrent reward updates now use optimistic locking to prevent lost writes under contention. Null image handling across all APIs prevents server errors when media is missing.

**Performance**: Shopify widget loading optimized; chat prompt context reduced by \~30%; queue rendering uses virtualization for large lists.

**Architecture**: Draft entity support extends admin preview grant system across challenges, games, posts, and leaderboards. Widget theming now isolates section styles independently while maintaining design consistency.

## Contributors

<CardGroup cols={4}>
  <Card>
    <img src="https://github.com/erek_d@me.com.png" alt="Derek Counihan" style={{borderRadius: '50%', width: 48}} />

    **Derek Counihan**

    30 commits • +62k/-14k lines
  </Card>

  <Card>
    <img src="https://github.com/solicshop@gmail.com.png" alt="James Cockayne" style={{borderRadius: '50%', width: 48}} />

    **James Cockayne**

    6 commits • +15k/-12k lines
  </Card>

  <Card>
    <img src="https://github.com/dch@wenudj.com.png" alt="DCH" style={{borderRadius: '50%', width: 48}} />

    **DCH**

    10 commits • +2.5k/-2.4k lines
  </Card>

  <Card>
    <img src="https://github.com/jamescockayne.png" alt="Additional Contributors" style={{borderRadius: '50%', width: 48}} />

    **Additional Contributors**

    18 commits • +3k/-1k lines
  </Card>
</CardGroup>

## Release Stats

| Metric           | Value   |
| ---------------- | ------- |
| Total Commits    | 64      |
| Lines Added      | +82,520 |
| Lines Removed    | -27,906 |
| Files Changed    | 879     |
| Apps Updated     | 6       |
| Packages Updated | 3       |

***

*v2.448.5 deployed on July 14, 2026*