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.

Nudj ships a full visual game builder (#1812) for bite-sized mini-games embedded in your community. Each game type (flick, catch, memory, basketball, scratch, etc.) has a purpose-built admin UI.

​
Supported game types

Flick

Fast-tapping arcade game. Score = how many objects flicked in time limit.

Catch

Catch falling objects. Has a safe-zone preview (#2168) so admins can see hit boxes.

Memory

Card-matching memory game. Alt text on images required for accessibility (#2389).

Basketball

Free-throw hoops game.

Scratch

Scratch-card reveal — outcome-based rewards.

​
Building a game

Pick a game type

  • New -> Game -> pick type. Each type has its own visual builder.

Branding colours

Configure colours for backgrounds, UI elements, score overlays (#2232). Flows from the community theme by default.

Upload assets

Logo, background, and per-game-type asset uploads (#2136). Covers background images, flick game images (#2157 for removal), memory game card images.

Configure scoring & rewards

Score-to-XP conversion, thresholds, outcome-based triggers. See Game Configurations (Strategy) for balance tips.

Set repeatability

Repeatability toggle (#2304) — can members play for rewards more than once?

Write pro-tips

Game pro-tips are translated per language (#2154).

Preview

Play the game in the preview before publishing. Preview/delete guards (#1179) prevent accidental breakage.

​
Visibility toggles

Each game has three visibility levels:
  • Community scope (#1851) — which communities can access this config.
  • Show-in-games-tab toggle (#2104) — whether to show in the member Games tab, or only via challenge actions.
  • Featured toggle (#1930) — pin to the top of the Games tab.
Plus opensInNewTab (#2189) for games better experienced in a new browser tab (e.g. larger-canvas games).

​
Languages

Full translation support for game copy — labels, pro-tips, button text. Language-switch bug in game config fixed in #2137. Search within the game config also matches against saved (not just original) values (#2247).

​
Assets & accessibility

Memory game (and other image-based games) require alt text on every image (#2390) for screen reader accessibility. Nudj enforces this at save time.

​
Form UX fixes

The builder has received many UX polish rounds: missing-fields handling (#1846), validation messaging (#1852), creation flow (#1902), and incidental fixes (#1932).

​
Games as challenge actions

Games can be the payload of a challenge’s Platform action. Reward distribution on the action is wired to the game’s scoring config.

​
Best practices

Don’t ship a broken game. Preview end-to-end on real devices — mobile browsers have quirks that don’t show in desktop preview.
Start with one game type per community. Adding 5 games at launch dilutes attention.
For outcome-based games (scratch), keep the big-reward probability low (1-5%). Too common = no excitement.