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.

Streaks reward consecutive behaviour — typically daily or weekly check-ins. Members see a “flame” indicator for their current streak length and milestones unlock rewards at configured intervals.

​
Streak sources

Streaks are driven by specific action types:
ActionStreak metric
Check-in actionConsecutive calendar days with at least one check-in
Challenge completionConsecutive days with at least one challenge completed
Custom eventAny event you fire via the Integration API
Enable the streak option on a check-in action (#1214) during challenge creation to have that action contribute to the member’s streak counter.

​
Streak save behaviour

Once a streak is set, Nudj maintains it atomically (#932 fixed a race condition where rapid actions could silently break the streak). Streaks end when:
  • The member misses a day (daily streaks) or a week (weekly streaks).
  • An admin manually resets the member’s streak.

​
Milestone rewards

Pair streaks with achievements that fire on streak_milestone events at configurable lengths (7, 14, 30, 100 days). Rewards can stack — bigger rewards for longer streaks.

​
Tips

Short daily streaks (7 or 14 days) feel achievable to newcomers. Gate longer streaks behind the short ones via tiered achievements.
Don’t build your whole gamification around streaks. Miss-forgiveness is important — consider “streak shields” (a reward that absorbs one missed day) for power users.