Release v2.398.1

​

Onboarding & Setup

• Cold Install Onboarding Wizard — Complete guided setup on first install with org creation, community linking, and widget configuration in one flow
• Free Plan Support — Merchants on free Shopify plans can complete onboarding and configure loyalty programs
• Linked Store Restoration — Automatically restore linked stores when merchants reinstall the app
• Widget Setup Non-Blocking — Widget configuration no longer blocks the onboarding flow

​

Loyalty Management

• Loyalty Tiers Section — New section for configuring and managing loyalty tier levels
• Guided Loyalty Layouts — Templates for organizing loyalty program configuration
• Draft Program Gates — Gate draft loyalty programs from public access

​

Analytics & Monitoring

• Loyalty Analytics Dashboard — Real-time activity charts tracking engagement metrics (signups, completions, rewards)
• PostHog Merchant Analytics — Track merchant behavior: signup source, plan changes, widget toggles, feature usage, challenge creation, reward creation
• Analytics Event Enrichment — Server-side analytics capture with shop domain as distinct ID

​

UI & UX Improvements

• Icon Refresh — Replace emoji UI with SVG icons site-wide for better accessibility and consistency
• Settings Flow Clarity — Simplified settings page flow for community linking
• Design Alignment — Consistent styling across settings and dashboard pages
• Checkout Extension Tests — Unit tests for points display and checkout redemption data layer

​

API & Infrastructure

• Shopify Session Foundation — Add Shopify session link database structure for future enhancements
• Storefront Domain Fix — Use real storefront domain (not admin) for share-rewards links
• Legal Link Hardcoding — Remove env var dependency for terms/privacy links
• Giveaway Icon — Display ticket icon for Giveaway rewards in Ways to Spend section

• Widget Dev Server Unavailable State — Show appropriate UI when local dev server is unavailable
• Shopify Widget Launcher Auth — Stabilize widget authentication in Shopify storefronts
• Widget Admin-Preview Signing — Sign admin-preview iframe auth instead of trusting headers (security)
• Transient Fetch Retries — Automatic retry for transient server integration fetch errors
• Challenge Celebration Preservation — Fix challenge-complete celebration visibility in widgets
• Theme Storage Access Guard — Protect access to theme storage configuration
• Leaderboard Podium Visuals — Polish visual design of leaderboard podium rankings
• Quick Actions Alignment — Align quick actions UI with shared actions surface
• Guest Mode Widget Onboarding — Enable guest mode defaults for widget onboarding
• Sign-Out Controls — Hide sign-out when user is logged in via API link

• Leaderboard Rankings Stability — Fix admin leaderboard page from crashing when hitting API rate limits
• Community Profile Reorganization — Move community profile (logo, banner, name) from Loyalty Hub to Common Branding section
• Leaderboard Nickname Action — Add new question-display-name action allowing users to customize their leaderboard name
• Community Deep-Link Resolution — Resolve community deep links by ID to the working dashboard route
• Asset Upload Scoping — Scope image asset uploads to selected community by default
• Rewards Distribution Guard — Guard rewards Distribution column against NaN percentage values
• AI Reward Image Prompts — Ground AI reward image generation prompts to prevent baking in wrong discount %/invented codes
• AI Setup Queue Retry — Make AI-setup queue retry actually rerun tasks and log panel API failures
• Kimi K2.7 Upgrade — Upgrade all agents from Kimi K2.6 to K2.7 for improved performance
• Guest Mode Defaults — Enable guest mode defaults for widget onboarding flow

• Question-Display-Name Action — New challenge action type allowing users to set a custom display name on leaderboards
• Default Avatar Regeneration — Regenerate default avatars for users with display name changes
• Leaderboard Username Coalescing — Fix data 500 errors by properly coalescing null leaderboard usernames
• Reward Draw Export — Improved reward draw export returns all entrants in one request (no hang, no silent truncation)
• Shopify Onboarding Tokens — Issue onboarding tokens for Shopify free-plan organizations
• Durable Web Research Jobs — Add durable, resumable web research job infrastructure for AI operations

• Scratch Game Color Overrides — Add editable brand color override support to the Scratch game

• Async Web Research Polling — Poll async web research jobs for completion status

• New Multi-Page Marketing Site — Public-facing Shopify marketing website with:
  • Home page with value proposition and CTA
  • Features page showcasing core gamification capabilities
  • How It Works page explaining the setup and engagement flow
  • Pricing page with plan tiers
  • Integrations page highlighting Shopify connectivity
  • FAQ and resources sections
  • About, legal (terms/privacy/cookies), and sitemap pages

• Shopify Session Link Foundation — Add database schema for Shopify session linking (foundation for future features)