v2.168.1

​

🔴 Massive Release v2.168.1

​

What’s New

• Community-Level RBAC — Assign granular permissions (Viewer, Moderator, Manager, Admin) to team members per community with server-side enforcement across all APIs
• Unified Theme System — Single theme configuration applied consistently across main app, embedded widget, Shopify integration, and admin with ShadCN CSS variables
• Shopify AI Chat — Ask Claude questions about store data, customer segments, discounts, and sync status—agent understands your full Nudj and Shopify configuration
• Per-Community Level Configuration — Customize XP progression, level brackets, and gamification rules for each community independently
• Flick Game — New interactive game type with animations and scoring, ships with default images
• Game Complete Flow — Polished experience showing earned XP, next level progress, and available rewards
• Mobile-Optimized Shopify Widget — Responsive design for 390px mobile viewports with improved touch targets
• Shopify Admin API Integration — Read-only access to products, customers, discounts, orders, and more for AI-powered insights
• Referral Codes Infrastructure — New system for managing and tracking referral links with API endpoints

​

Apps Updated

​

Detailed Changes

​

Breaking Changes

​

Technical Notes

• Single source of truth for visual branding (community.theme)
• ShadCN CSS variable mapping for consistent styling across all surfaces
• Theme inheritance from organization to community level
• Support for theme presets with one-click application
• Type-safe theme configuration with TypeScript enums

• Roles (Viewer, Moderator, Manager, Admin, Creator, Analytics) scoped to communities
• Per-user API tokens with embedded role information
• MCP tokens respect community-level RBAC
• Client-side RBAC enforcement in Admin UI prevents unauthorized actions
• Backend enforces RBAC on all query/mutation operations

• Chat context automatically includes community configuration, Shopify linking status, and user segment data
• Read-only access to 9 Shopify Admin API endpoints for data gathering
• Evaluations and test data for common Shopify support scenarios
• UI components for displaying integration state in the chat interface

• Analytics dashboard queries optimized with proper MongoDB indexes
• Fresh DB reads for Shopify linking to prevent cache staleness
• Reward queries invalidated immediately after redemption
• Active user calculation improved with better aggregation logic

• Proper state transitions from game play to completion
• Visual reward preview with amounts
• Automatic transition to next challenge or leaderboard
• Completion analytics tracking for engagement metrics

​

Usage Examples

const response = await fetch('https://api.nudj.com/v2/community/123/data', {
  headers: {
    'Authorization': `Bearer ${apiToken}`
  }
});

// Token now automatically enforces role-based access
// Viewer role can only read data
// Manager role can modify community settings

{
  "community": {
    "theme": {
      "primary": "#FF6B35",
      "secondary": "#004E89",
      "background": "#F7F9FB",
      "text": "#1A1A1A",
      "accent": "#FFA500",
      "preset": "vibrant"
    }
  }
}

// Generate a new referral code
POST /integration/referral-codes
{
  "communityId": "com_123",
  "metadata": {
    "campaign": "winter_2026"
  }
}

// Response:
{
  "id": "ref_abc123",
  "code": "NUDJ_WIN26_ABC123",
  "communityId": "com_123",
  "createdAt": "2026-02-19T...",
  "validFrom": "2026-02-19T...",
  "validUntil": "2026-05-19T..."
}

// Track redemptions:
GET /integration/referral-codes/ref_abc123/redemptions

// Response:
{
  "total": 42,
  "redeemed": 12,
  "conversionRate": 0.286
}

// Get game config for this community only
GET /integration/community/com_123/games/game_456

// Update level config for this community
PUT /integration/community/com_123/levels
{
  "levels": [
    { "name": "Beginner", "xpRequired": 0 },
    { "name": "Intermediate", "xpRequired": 1000 },
    { "name": "Expert", "xpRequired": 5000 }
  ]
}

​

Related Features

• Role-Based Access Control — Fine-grained team permissions with org and community scoping
• Gamification — Challenges, rewards, points, and XP systems
• Leaderboards — Rank users by points earned or XP progression
• Shopify Integration — Sync store data and reward customer purchases
• Theming & Customization — Brand your community with custom colors
• Achievements — Badge-based accomplishment system
• Streaks — Consecutive day tracking with point bonuses
• API & Integrations — Programmatic access to Nudj platform

​

Contributors

@ZuhayrK0010 commits • +23,558/-8,157 lines

@erek_d@me.com9 commits • +33,585/-7,807 lines

@SaadK948 commits • +12,817/-5,762 lines

@jamescockayne4 commits • +22,092/-3,113 lines

@dch@wenudj.com4 commits • +10,511/-2,133 lines

@bhalaladivs@gmail.com2 commits • +1,710/-146 lines

​

Release Stats