Gamification

In the Gamification tab you enable playful elements that motivate users long-term: streaks, badges, personal records, challenges and the global leaderboard.

Overview

Feature	Description	Requires
Training streaks	Count consecutive training days	—
Badges	Achievements for reached milestones	—
Personal records	Enable PR tracking	—
Challenges	Time-limited training competitions	Firebase Auth
Leaderboard	Global ranking of all users	Firebase Auth

---

Gamification functions

Training streaks

Setting	Description
Enable training streaks	Counts consecutive days with completed workout

When enabled, users see in the dashboard:

• Current training streak (e.g. “14 days in a row”)
• Longest training streak
• Warning when the streak risks ending today

Streaks are a proven way to encourage long-term training consistency.

Badges

Setting	Description
Enable badges	Achievements for milestones like “First 10 workouts”, “100 kg achieved” or “30-day streak”

When enabled, the app automatically unlocks badges when users reach certain milestones. Badges are visible in the profile and dashboard.

Personal records (PRs)

Setting	Description
Enable PR tracking	Automatically detects best performances (max weight, max reps) and celebrates them

When enabled, the app detects after each set whether a new personal record was set. A short animation and notification celebrate the achievement.

Detail settings in the Progression tab

Which PR types are detected exactly (max weight, max reps, max volume, best time) and what the charts look like is configured in the Progression tab.

Challenges

Setting	Description	Requires
Enable challenges	Time-limited training competitions with shared goals	Firebase Auth

When enabled, users can participate in training challenges, e.g.:

• “30 days of push-ups”
• “100 km running per month”
• “Complete 20 workouts in May”

Each challenge has a goal, a duration and a list of participants. Via the dashboard, users see their progress and rank within the challenge.

Firebase Auth needed

Challenges require active Firebase Auth because participants must be uniquely identifiable. Activate the Firebase Auth module first.

---

Leaderboard

Show global leaderboard

Setting	Description	Requires
Enable leaderboard	Shows a global ranking with all users	Firebase Auth

When enabled, users see a leaderboard with the most active trainees. Criteria can include:

• Number of workouts this week / this month
• Longest training streak
• Volume (sets x reps x weight)
• Points from completed challenges

Mind privacy

A global leaderboard shares user data with all other users. Make sure your privacy policy covers this and users are informed.

Local leaderboard alternative

If you don’t want a global leaderboard, leave this option disabled and use challenge-specific leaderboards instead — these are only visible to participants of a challenge.

---

Change settings

1. Open the Workouts Editor
2. Switch to the Gamification tab
3. Enable the desired features (Streaks, Badges, Personal records)
4. Optionally: Make sure the Firebase Auth module is active
5. Enable Challenges and/or Leaderboard if needed
6. Tap Save in the top right

---

Tips

Start with streaks and badges

These two features work without Firebase and are a good entry into gamification. They are immediately motivating.

Don’t make streaks too strict

If you use streaks, consider whether one “rest day” per week (e.g. Sunday) should automatically be skipped. Otherwise users lose their streak due to normal recovery breaks.

Seasonal challenges

Seasonal challenges (Summer Challenge, New Year Challenge) are particularly motivating because they are time-limited and create a sense of community.

Leaderboard with care

A global leaderboard only makes sense with enough active users. With small communities it can quickly become discouraging (always the same people on top).