Workouts Setup

The Workouts module turns your app into a fully-featured fitness app: exercise library, workout plans, active sessions, yoga sequences, personal trainer features, form check (video feedback), goals, challenges and gamification — all in one module.

Automatic Firebase setup

If you choose cloud storage, the Firebase setup (security rules, indexes, cloud functions) happens automatically when you publish your app. You don’t need to deal with Firebase configuration yourself when activating the module.

Overview

Exercise library

Hundreds of exercises with instructions, muscle groups and equipment filter.

Workout plans

Create, subscribe to and share multi-week plans.

Sessions

Live tracking of sets, reps, weights and rest timer.

Yoga

Poses and sequences with hold times, breath cycles and yoga styles.

Personal trainer

Client management, form check (video feedback) and goals.

Challenges

Time-limited competitions with leaderboard and rewards.

Personal records

Automatic PR detection with animation and notification.

Statistics & charts

Progress charts, GitHub-style heatmap and muscle balance.

---

Setup process

The Workouts setup consists of four steps:

1. Introduction — Overview of all Workouts functions

2. Choose storage — Local (this device only) or Firebase (cloud sync and challenges)

3. Firestore rules — Automatic deployment of security rules (only with Firebase storage)

4. Finish — Save configuration and activate the module

---

Step 1: Introduction

The first step gives you an overview of all functions the Workouts module brings:

Function	Description
Exercise library	Searchable library with filters for muscle group, equipment, difficulty
Workout plans	Multi-week structured plans
Workout sessions	Active sessions with live tracking
Yoga	Yoga poses and sequences
Challenges	Time-limited competitions
Gamification	Streaks, badges, personal records, leaderboard

Tap Continue to proceed to the next step.

---

Step 2: Choose storage

Choose where the training data is stored. This decision affects which functions are available.

Local only (on this device)

Pros	Cons
Fully usable offline	No sync between devices
No Firebase configuration needed	No challenges, no leaderboard
Data stays private	No trainer-client functions
Fast access	No cloud backup

Suitable for:

• Personal fitness apps without community features
• Apps that should work without an internet connection
• Privacy-focused applications

Firebase (cloud sync)

Pros	Cons
Sync between devices	Requires Firebase project and Auth module
Challenges and leaderboard possible	Internet connection needed
Trainers can manage clients	Data lives in the cloud
Form check works
Automatic backup

Suitable for:

• Trainer apps with client coaching
• Community apps with challenges and leaderboard
• Apps used on multiple devices

Firebase Auth required

If you choose Firebase, the Firebase Auth module must also be active. The setup shows a warning at the selection if Auth is missing — activate it first.

---

Step 3: Firestore rules Firebase only

If you chose Firebase in the previous step, this step takes care of the security rules (Firestore rules).

Action	Description
Start wizard	Opens a guided wizard that inserts the necessary rules into your Firestore rules file

The following collections are prepared in the setup:

• exercises — Exercise library
• exercise_categories — Categories for exercises
• workout_plans — Workout plans
• workout_sessions — Completed sessions
• user_workout_stats — Personal statistics
• yoga_poses and yoga_sequences — Yoga content
• workout_challenges and sub-collection participants — Challenges
• workout_trainers — Trainer profiles
• form_checks — Form check requests
• trainer_profiles, trainer_clients — Trainer-client relationships
• workout_assignments, goal_assignments — Assigned workouts and goals

Skipped on “Local only”

If you chose “Local only” in the previous step, the setup automatically skips this step.

More about Firestore configuration →

---

Step 4: Finish

In the last step you see a summary of your configuration:

Area	Content
Enabled workout types	Strength, Cardio, Yoga, HIIT — depending on what you chose during setup
Enabled gamification	Streaks, badges, challenges, leaderboard
Storage location	Local only or Firebase

Tap Complete setup to activate the module. Afterwards the Workouts module is visible in the app and can be fine-tuned via the Workouts editor.

---

Requirements

Requirement	When needed?
Firebase project	When choosing “Firebase” as storage
Firebase Auth module	When choosing “Firebase” — required for cloud sync
Notifications module	Optional, for push notifications
Chat module	Optional, for trainer-client chat
Payments module	Optional, for paid challenges

---

After the setup

Once setup is complete, you have access to:

Workouts editor Fine-tune all functions — tabs for General, Features, Trainer, Display, Gamification, Progression and Notifications.

Activate features Enable exercise library, plans, sessions, yoga and timers.

Trainer functions Client management, form check and paid challenges.

Gamification Streaks, badges and leaderboard for more motivation.

---

Tips

Start with “Local only”

If you’re unsure whether you need cloud functions, start with “Local only”. You can switch to Firebase any time later.

Trainer apps need Firebase

As soon as you offer trainer functions (Client management, Form check, Paid challenges), Firebase + Firebase Auth are mandatory.

Define workout types early

If you clearly know that your audience only does Yoga or only Strength training, disable the other types directly in the setup — this makes the app more focused.