Skip to main content

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.

The Shop is where members spend points on rewards (see Reward Types). It’s fully shipped — not a placeholder.

Enabling the shop

Toggle it on

The shop has a community-level toggle (#1221). From Community Settings -> Features, enable Shop. Members see a new “Shop” tab in the member app.

Stock it

On any Asset or Entry reward, open the Shop tab (#715) in the reward editor. Configure:
  • Point cost — how many points to purchase.
  • Stock — how many are available for purchase in total.
  • Per-user limit — cap purchases per member.

Preview

Preview the member shop via the reward Preview mode (see Preview Mode).

How members spend

Members with enough points can buy rewards from the Shop. Purchases:
  • Deduct points from the balance immediately.
  • Add the Asset / Entry to the member’s wallet.
  • Respect maxAssetsPerUser / maxEntriesPerUser caps.

Allocation edge cases

Several edge cases were fixed in shop + allocation handling (#682, #631, #765):
  • Buying beyond supply — blocked with a clear error.
  • Buying while at per-user cap — blocked, preserves the points.
  • Simultaneous purchase + auto-distribution — purchases don’t race with challenge-distributed allocations; Nudj serialises.

Shop analytics

Shop purchases count as a distribution source on the Reward Analytics page:
  • Purchase count vs challenge-earned count.
  • Revenue (points spent) per reward.
  • Timeline of purchases.

Design tips

Price rewards so that members can buy something meaningful after 2-3 challenges — too expensive and the shop feels out of reach; too cheap and points feel worthless.
Mix shop-stocked rewards (always available for spending) with challenge-distributed rewards (limited-time earn events). The variety keeps the wallet/shop feeling fresh.

Community-level visibility

Shop visibility is per-community. Turn it off for communities where points are purely progression (leaderboard-only), leave it on for communities with a proper reward catalogue.