Release v2.267.0

​

🔴 Release v2.267.0

​

What’s New

• Bohemian Visual Redesign – Complete visual overhaul with refreshed color palette, typography, and component styling for a modern, cohesive admin experience
• Loyalty Tier OrderPaid Automation – Automatically evaluate and assign loyalty tiers when Shopify customers complete purchases, enabling tier-based rewards workflows
• Game Config Branding Colors – New configuration step in game setup to customize primary, accent, and secondary brand colors for your gamified experience
• Improved Form Stability – Fixed leaderboard name input resetting, multiple choice action editing, and rich text sanitization issues
• Enhanced Admin Navigation – Drill-down sidebar navigation improvements for better platform exploration and community switching
• Shopify User Linking – Prevent duplicate user creation by linking Shopify users via email before account creation
• Better Challenge UX – Action title truncation for long text, restored language switching in posts, and improved form field rendering

​

Apps Updated

​

Detailed Changes

​

Admin Features & Improvements

• Bohemian Branding System – Complete visual redesign with lavender primary, muted purple accent, and navy sidebar for modern admin interface
• Brand Color Customization – Configure primary, accent, and secondary colors in game setup with real-time preview
• Loyalty Tier Automation – Set up automatic tier evaluation when Shopify customers spend (via OrderPaid events)
• Form Input Reliability – Fixed leaderboard names, challenge actions, and rich text fields from unexpected state resets
• Navigation Improvements – Better sidebar structure and community switching for faster platform exploration
• Action Management – Improved action title display and multiple choice action editing in challenge configuration
• Language Support – Restored multi-language support in posts and challenge configuration
• Testing & Stability – 600+ new E2E tests for branding, challenge flows, and community switching ensure platform reliability

​

User-Facing Improvements

• Modern Visual Experience – User app displays cohesive bohemian branding reflecting admin customizations
• Consistent Styling – Color variables applied throughout for reliable visual feedback during challenge completion
• Better Mobile Experience – Improved touch targets and form field interactions across the user app

​

Technical Improvements

• Event Hook Architecture – New OrderPaid event handler pattern for Shopify event processing at scale
• Tier Evaluation Service – Reusable helper function for spend-based tier progression logic
• CSS Variable System – Consistent HSL-based theming for maintainable brand customization
• Type Safety – Improved TypeScript definitions for loyalty tier and theme configuration
• Test Coverage – Expanded E2E test matrix covering critical user flows and admin configuration paths

​

Breaking Changes

​

For Shopify Integrations

​

How to Use the New Features

​

Customize Your Brand Colors

1. Navigate to your community’s Game Settings
2. In the game configuration stepper, find the new Branding Colors step
3. Enter your primary color (e.g., brand primary), accent color, and secondary color
4. See the color preview update in real-time
5. Save your game — the colors instantly apply across your admin and user app

​

Set Up Automatic Loyalty Tiers (Shopify)

1. Configure Tier Spend Thresholds – In your community’s loyalty tier settings, define spend amounts for each tier level
2. Enable OrderPaid Webhooks – Ensure your Shopify integration is connected (standard setup)
3. Users Automatically Advance – When your Shopify customers spend money, their tier will automatically evaluate and upgrade if they meet the threshold
4. No Manual Management – Tiers update in real-time without admin intervention

​

Fix Common Configuration Issues

• Leaderboard Name Changes – If your leaderboard name was resetting while typing, it’s now fixed. Type freely without losing progress.
• Challenge Actions – Multiple choice actions can now be edited and saved reliably.
• Rich Text Fields – Empty rich text sections are now safely sanitized to prevent validation errors.

​

Migration Notes

• Branding configurations – These are preserved. You can now add more granular color customization via the new Branding Colors step.
• Shopify integrations – OrderPaid events are automatically processed. No configuration needed unless you want to enable automatic loyalty tier evaluation.
• Custom themes – Your community’s theme configuration is automatically applied with the new CSS variable system.

​

Contributors

@dchnudj5 commits • +208/-190 lines

@Derek_Counihan2 commits • +41,726/-30,949 lines

@jamescockayne2 commits • +3,429/-77 lines

@SaadK941 commit • +60/-5 lines

@ZuhayrK001 commit • +315/-78 lines

​

Release Stats

​

Testing This Release

​

For Admins

• ✅ Test the new Branding Colors step in game configuration — colors should apply immediately
• ✅ Verify form fields (leaderboard name, action editing, rich text) no longer reset unexpectedly
• ✅ Check community switching in the sidebar works smoothly
• ✅ Review the new visual theme across all admin pages

​

For Shopify Users

• ✅ Verify OrderPaid webhooks trigger (check Admin > Events in Shopify)
• ✅ Confirm loyalty tiers automatically advance when test orders are created
• ✅ Test user account linking with existing email addresses

​

For App Users

• ✅ Confirm the user app displays your custom brand colors
• ✅ Verify all interactive elements respond correctly to color customization