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.361.2
⭐⭐⭐ Complex • 3 commits • 96 filesNudj Plans launch with unlimited Max tier. Organizations can now upgrade to Max to unlock unlimited communities, challenges, actions, rewards, achievements, games, and leaderboards. Every plan tier comes with clear feature gates—creating challenges on Free plan automatically shows a paywall. Brand research AI onboarding is now more reliable with improved model selection and better live asset handling.
What’s New
- Unlimited Max Tier – Upgrade to Max for unlimited access to all gamification features without per-community limits
- Automatic Tier Enforcement – Admins see clear limits in the UI; creating a challenge when over-limit triggers an instant paywall modal with upgrade path
- Feature Tier Visibility – Every tier clearly shows which features are included: AI image generation, Shopify integration, points promotions, custom domains, streaks, referral programs, and analytics export
- Team Admin Scaling – Premium tier supports up to 10 admins (Max tier: unlimited); Free tier locked to 1 admin to prevent team sprawl
- Improved AI Brand Research – Onboarding brand research now handles complex model selection more reliably; live asset fetching is stabilized for faster setup wizard completion
Apps Updated
User App
— No changes
API
✓ Updated - 30+ changes
Admin
✓ Updated - 50+ changes
MCP Server
✓ Updated - 6+ changes
Website
— No changes
Games
— No changes
Detailed Changes
API
API
Entitlements & Plan Architecture
- New
Plan.Maxtier added to the plan enum with unlimited entitlements for all features - 18 entitlement keys registered (8 usage limits + 10 feature toggles):
- Usage Limits: CommunitiesPerOrg, ChallengesPerCommunity, ActionsPerCommunity, RewardsPerCommunity, AchievementsPerCommunity, GamesPerCommunity, LeaderboardsPerCommunity, AdminsMax
- Features: AiImageGeneration, BespokeUiCustomization, PointsPromotions, ProductMultipliers, CustomDomains, StreaksEnabled, ReferralProgramEnabled, IntegrationShopify, McpEnabled, AnalyticsExportParquet
- Limit gates added at entity creation points: challenges, actions, rewards, achievements, games, leaderboards, admin team invites
- Counters implemented for tracking usage across all entity types
- New MongoDB indexes for entitlement counter performance optimization (location + organisationId prefix)
- Runtime entitlement gates: Shopify integration, referral program, analytics export, streaks, MCP access all respect tier permissions
- MCP server now validates org entitlement on every token validation (fail-closed on downgrade)
upsert-community.tsgates PointsPromotions and ProductMultipliers featuresupdate-referral-config.tsgates referral program accessset-data-storage-config.tsgates analytics exportinvite-user-to-organisation.tsenforces AdminsMax limits- Shopify connection initiation gated on IntegrationShopify entitlement
- Streak creation gated on StreaksEnabled (fail-on-create posture, won’t strand existing streams on downgrade)
Admin
Admin
Plans Settings Tab
- New Plans tab in Organization Settings with tier comparison UI showing Free, Premium, Max, and Legacy tiers
- Clear feature matrix display: which features are included in each tier, limits per tier
- Pricing display and upgrade CTA buttons (integrated with Customer Portal for Max tier)
- Premium marked as featured tier with callout styling
- Tier selection and checkout flow for self-service upgrades
- Stripe Max Price tier created and integrated with billing flow
- Paywall modal component shows when users hit tier limits (e.g., “You’ve created 3 challenges on the Free plan. Upgrade to Premium for 50 challenges”)
- Entity creation forms (challenges, rewards, actions, etc.) automatically detect tier and show limits
- Admin invitations cap at plan limit (Free: 1 admin, Premium: 10, Max: unlimited)
- Boolean feature toggles (Shopify, Streaks, Referral, etc.) show lock icons when not entitled
- Feature usage counters displayed in relevant admin pages
- Enhanced AI Setup Wizard with better model selection logic
- Improved handling of brand research live asset fetching
- More reliable brand research progress tracking in onboarding
- Better chat queue handling for sequential brand research steps
- Comprehensive test coverage for brand research workflows
- Fixed race conditions in chat request processing
MCP Server
MCP Server
Token Validation & Entitlements
- MCP server now validates McpEnabled entitlement on every bearer token check
- Org downgrade from Premium/Max to Free immediately revokes MCP access (next request)
- Fail-closed: missing Mongo data returns 401 to prevent inadvertent access grants
- Integration with entitlement registry for runtime permission checks
Admin Highlights
- Plans Tab – New Settings tab displaying all four tiers (Free, Premium, Max, Legacy) with feature comparison, pricing, and upgrade CTAs
- Max Tier – Unlimited communities, challenges, actions, rewards, achievements, games, and leaderboards; all advanced features enabled
- Automatic Limit Enforcement – Creating a challenge when over limit shows a modal with feature availability and upgrade option
- Admin Team Scaling – Free: 1 admin, Premium: 10 admins, Max: unlimited admins for large enterprises
- Feature Gates – Shopify integration, referral programs, analytics export, streaks, and MCP access now respect tier permissions
- Entitlement Display – Admin UI shows which features are available on current plan; locked features display clearly with tier requirement
- Brand Research Stability – AI onboarding wizard handles complex brand research more reliably; live asset fetching improved
- Tier-Aware Invite Flow – When inviting a new admin, form warns if you’ve hit the tier limit and suggests upgrade
Release Stats
| Metric | Value |
|---|---|
| Total Commits | 3 |
| Lines Added | +3,437 |
| Lines Removed | -496 |
| Files Changed | 96 |
Contributors
@jamescockayne1 commit • +1,875/-209 lines • 57 filesv2.361.2 deployed on May 29, 2026