Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/piratta/gymApp/llms.txt

Use this file to discover all available pages before exploring further.

Every coach in FocusFlow maintains their own personal exercise catalog — an independent library of movements that powers the exercise search inside the Routine Builder and the Template Editor. Exercises you add here are immediately available when programming any athlete’s routine, making it easy to build a consistent vocabulary of movements you use across all your clients.

​
The Exercise Type

Each exercise in the catalog is stored as an Exercise object in Firestore, scoped to the coach who created it via the coachId field. 
export interface Exercise {
  id: string;
  name: string;
  category: string; // "Pecho", "Espalda", "Piernas", "Hombros", "Brazos", "Cardio"
  description?: string;
  coachId?: string; // Scopes the exercise to a specific coach's catalog
}
FieldRequiredDescription
idYesAuto-generated unique identifier ("e_" + Date.now())
nameYesExercise name as shown in the Routine Builder search
categoryYesMuscle group — must match one of the standard categories
descriptionNoMovement instructions, cues, or notes visible in the catalog list
coachIdNoSet automatically to the logged-in coach’s id when saved
Open the catalog by navigating to Exercises & Templates in the coach dashboard, then selecting the Catálogo de Ejercicios sub-tab. The view is split into two panels:

Add / Edit Form

Left panel — a form with Name, Category, and Movement Summary (Resumen del movimiento) fields. Used for both creating new exercises and editing existing ones.

Catalog List

Right panel — a scrollable list of all your exercises with inline search and category filter. Shows name, category badge, and description for each entry.

​
Searching Exercises

The catalog’s search input performs a real-time, debounced (150 ms) filter across your entire library. Both the exercise name and description fields are searched together, meaning you can find movements by muscle cue, equipment keyword, or variation name. Key search behaviors:
  • Case-insensitive — "curl" matches "Curl de Martillo" and "Curl Predicador".
  • Accent-insensitive — the underlying filter normalizes the combined name + description + category string, so searching "espalda" or "Espalda" returns the same results.
  • Category filter — a dropdown next to the search bar lets you narrow results to a specific muscle group. Defaults to All Categories.
The search is applied to the combined string "${ex.name} ${ex.description || ""} ${ex.category}", so a search for "predic" would match an exercise named "Curl Predicador de Bíceps".

​
Adding a New Exercise

1

Open the Add Form

In the Catálogo de Ejercicios sub-tab, the Añadir Ejercicio personalizado form is visible in the left panel by default. If you were previously editing an exercise, click elsewhere to reset it.
2

Enter the exercise name

Type the full movement name in the Name field. Be descriptive — for example "Curl de Martillo con Mancuerna" rather than just "Curl". This name appears verbatim in the Routine Builder search results and on the athlete’s workout screen.
3

Select a muscle category

Choose the primary muscle group from the Categoría muscular dropdown. This drives the category filter in the Routine Builder. Standard options are listed below.
4

Add movement instructions (optional)

Use the Resumen del movimiento textarea to describe execution cues, equipment, grip width, or any coaching notes — for example: "Sit on incline bench with dumbbells, keep hips stable, full range of motion". This text is displayed in the catalog list and can also be surfaced to athletes.
5

Save

Click Guardar ejercicio. The exercise is written to Firestore under your coach account and immediately appears in the catalog list and the Routine Builder’s exercise search.

​
Standard Categories

FocusFlow ships with five standard muscle categories available in the catalog form’s Categoría muscular dropdown. All exercises must belong to at least one category, which controls how they appear in filtered searches and on the athlete’s session log.

Pecho

Chest — Bench press, dips, fly variations, push-up progressions. Covers upper, mid, and lower pec movements.

Espalda

Back — Rows, pull-ups, lat pulldowns, deadlift variations, face pulls. Covers width (lats) and thickness (rhomboids, traps).

Piernas

Legs — Squats, lunges, leg press, Romanian deadlift, leg curl. Covers quads, glutes, hamstrings, and calves.

Hombros

Shoulders — Overhead press, lateral raise, rear delt fly, upright row. Targets all three deltoid heads.

Brazos

Arms — Bicep curls, tricep extensions, hammer curls, skull crushers. Covers both elbow flexors and extensors.
Additional category values (such as "Cardio" or "Otros") are supported by the data model and may appear in filter dropdowns when exercises carrying those categories are present in your catalog — for example, exercises created on the fly from the Routine Builder’s Crear y Añadir flow can be assigned any category available at that point.

​
Editing and Deleting Exercises

Every exercise in the catalog list has two action buttons:
  • Edit (pencil icon) — Loads the exercise into the left-form for modification. Change the name, category, or description and click Guardar ejercicio to update it in Firestore.
  • Delete (trash icon) — Permanently removes the exercise from your catalog. Exercises already added to saved routines or templates retain their data (name, category, etc.) because RoutineExercise stores a snapshot of those fields directly.
  1. Find the exercise in the catalog list (use search or category filter to narrow results).
  2. Click the pencil icon on the right side of its row.
  3. The left form pre-fills with the exercise’s current name, category, and description.
  4. Make your changes and click Guardar ejercicio.
  5. The catalog list updates immediately. The form header changes from Añadir Ejercicio personalizado to Editar ejercicio to indicate edit mode.

​
Catalog Scope Per Coach

Each exercise belongs to the coach who created it. The coachId field on every Exercise document means:
  • Coach A’s catalog is completely independent from Coach B’s catalog.
  • Athletes only see exercises from their assigned coach’s catalog when logging workouts.
  • If you have multiple coaching accounts (e.g., a personal account and a gym account), each has its own separate catalog.
Exercises added to the catalog are immediately available in the Routine Builder’s exercise search and the Template Editor. There is no need to refresh the page — the search results update in real time as your catalog grows.

​
Quick-Creating Exercises from the Routine Builder

You don’t have to visit the catalog tab to add a new exercise. In the Routine Builder and Template Editor, if you type a name in the exercise search that doesn’t match any existing entry, a “Crear y Añadir” option appears inline. Clicking it:
  1. Creates a new Exercise in your catalog with the typed name and the currently selected category filter.
  2. Immediately adds it to the day’s exercise list as a RoutineExercise.
  3. Saves it to Firestore so it’s available in all future routines and searches.
This workflow is ideal when programming on the fly during an athlete consultation.

Build docs developers (and LLMs) love

Get started for freeTalk to us