Release v2.387.5

​

🔴 Massive Release v2.387.5

​

What’s New

• Rebuilt Admin Command Palette — ⌘K navigation now features canonical sidebar integration, expanded search results, and significantly faster queries for instant platform access
• Runway 3D Game Launch — New immersive plane-landing game adds visual variety to challenge libraries with 3D graphics, dynamic difficulty levels, and brand-customizable aircraft
• Achievement Insights Breakdown — Per-step progress charts pinpoint exactly where users drop off in multi-step achievements, enabling data-driven challenge refinement
• Shopify Multi-Language Support — Loyalty platform now supports French and additional languages via react-i18next, enabling international Shopify storefronts
• Shopify Storefront Widget Verification — Comprehensive end-to-end harness testing verifies loyalty account, FAB, checkout drawers, and referral widgets across all storefronts
• Destructive Action Safety — Type-to-confirm guards prevent accidental deletion of loyalty settings, rewards, and customer configurations
• Optimized Cache Invalidation — API now supports array-valued cache tags for efficient batch operation invalidation and improved performance
• Shopify Data Synchronization — Loyalty state now writes back to Shopify customer metafields for unified customer data across platforms
• Enhanced Observability — Shopify money-path logging now includes detailed error context with structured traces for faster incident response

​

Apps Updated

​

Detailed Changes

​

Admin Highlights

• ⌘K Command Palette – Rebuilt with canonical sidebar integration, expanded search, and fast relevance ranking for instant platform discovery
• Per-Step Progress Charts – Achievement Insights show completion rates at each step to pinpoint user drop-off points and optimize challenge design
• Shopify Multi-Language Support – Loyalty platform now works in French and supports additional locales via react-i18next
• Editable Game Brand Colors – Override theme.accent per-game for custom aircraft/ball colors and visual branding
• Destructive Action Confirmation – Type-to-confirm guards prevent accidental deletion of loyalty settings, rewards, and customer data
• Scoped Reward Unlink – Safe bulk-unlink with pagination and archival option instead of permanent deletion
• Optimistic Concurrency Guards – Points-config writes protected against race conditions from simultaneous admin edits
• Loyalty Settings Wire Real APIs – Both settings screens now persist changes server-side, removing stub behavior
• Community Metafield Sync – Loyalty state writes to Shopify customer metafields for unified data across platforms
• App Proxy Security – Storefront widgets now authenticate securely through Shopify’s App Proxy auth layer
• Access & Scheduling Navigation – Main settings nav now includes access control and scheduling features
• Money-Path Observability – Enhanced error logging with structured traces for faster incident response

​

User Highlights

• Faster Command Palette – Navigation is significantly quicker with expanded search and canonical integration
• Runway 3D Game – New immersive plane-landing game adds visual variety with brand-customizable aircraft
• Better Game Performance – Memory game no longer hangs during score transfer for seamless gameplay
• Stable Game Branding – Game colors now inherit community theme and persist across sessions
• Multi-Language Loyalty – Shopify stores can now configure loyalty features in French and other languages
• Community Prefetch Efficiency – Faster app startup and navigation from optimized prefetching

​

Breaking Changes

​

Technical Notes

• Community prefetch elimination reduces initial user app payload and improves perceived navigation speed
• Array-valued cache tags reduce batch operation invalidation from O(n) tag operations to O(1)
• Theme fetch optimization eliminates layout thrashing and improves FCP

• SSR missing-content fallback prevents 500 errors from incomplete detail pages
• Email case-insensitive OTP lookup prevents auth failures from case mismatches
• Optimistic concurrency guards on points-config prevent race-condition data corruption

• QStash signature verification prevents spoofed webhook attacks on queue handlers
• Mass-assignment guard on community-settings prevents ID field override attacks
• Type-to-confirm destructive actions require explicit admin intent

• CLAIMED analytics tile now counts user progress claims, not reward distribution assets, for accurate engagement metrics
• Shopify metafield sync enables unified customer records across platforms
• Integration path-ID validation converts 500 errors to 4xx client errors for better observability

​

Usage Examples

// Array-valued cache tags for batch invalidation (API)
// Instead of invalidating n tags individually:
await Promise.all(
  communityIds.map(id => cache.invalidate(CacheTag.Community.Keyed(id)))
);

// Now invalidate all at once:
await cache.invalidate({
  tags: [CacheTag.Community.Multiple.Keyed(communityIds)]
});

​

Related Features

• Challenge Configuration — Create multi-step challenges with step-progress tracking
• Achievement Insights — Monitor achievement completion rates by step
• Shopify Integration — Loyalty platform configuration and storefront widgets
• Games & Gamification — Play games and earn rewards
• Reward Management — Create and configure reward inventories
• Access Control — Manage team member permissions and roles
• Internationalization — Multi-language support for global storefronts

​

Contributors

@erek_d16 commits • +170,216/-4,056 lines

@solicshop15 commits • +9,497/-2,298 lines

@dch11 commits • +2,758/-2,166 lines

@ZuhayrK005 commits • +13,892/-1,623 lines

@jamescockayne1 commit • +477/-33 lines

​

Release Stats