add-exercises

All exercises are defined in: src/data/popularExercises.ts

The file is organized by MUSCLE GROUP → EQUIPMENT TYPE, with exercises sorted alphabetically within each section:

```

CHEST

├── Barbell (1)

├── Dumbbell (1)

├── Cable (2)

├── Machine (5)

└── Bodyweight (7)

BACK

└── ...

```

The file header contains a summary showing counts for each muscle/equipment combination.

```typescript

{

name: string // Unique name (duplicates throw runtime error)

equipment: Equipment

muscle: Muscle

type: ExerciseType

metrics: Metrics

}

```

Valid Types

| Field | Valid Values |

|-------|-------------|

| equipment | 'barbell', 'dumbbell', 'machine', 'cable', 'bodyweight', 'kettlebell', 'band', 'ez-bar', 'hex-bar', 'club', 'battle-rope' |

| muscle | 'chest', 'back', 'legs', 'shoulders', 'arms', 'core' |

| type | 'compound', 'isolation', 'stability', 'cardio', 'isometric' |

| metrics | 'weight-reps', 'reps-only', 'duration', 'distance-duration', 'weight-distance' |

Metrics Guidelines

| Equipment/Type | Typical Metrics |

|---------------|-----------------|

| Weighted exercises (barbell, dumbbell, machine, cable, kettlebell) | 'weight-reps' |

| Bodyweight strength | 'reps-only' |

| Holds/planks | 'duration' |

| Cardio (running, rowing) | 'distance-duration' |

Type Guidelines

| Type | Description | Examples |

|------|-------------|----------|

| compound | Multi-joint movements | Squats, Deadlifts, Bench Press |

| isolation | Single-joint movements | Bicep Curls, Leg Extensions |

| stability | Dynamic balance/core exercises | Bird Dogs, Single-Leg Deadlift |

| cardio | High heart rate | Burpees, Jump Rope |

| isometric | Static holds under tension | Wall Sit, Dead Hang, L-Sit Hold |

Step 1: Check What Exists

Read the file header summary to see current counts:

```

• - LEGS (71): barbell: 8, dumbbell: 9, kettlebell: 3, cable: 3, machine: 26, bodyweight: 22

```

Or search for specific exercises:

```bash

grep -i "squat" src/data/popularExercises.ts

```

Step 2: Find the Right Section

Exercises are organized by muscle group, then equipment. Find the correct section:

```typescript

// ═══════════════════════════════════════════════════════════════════════════════

// LEGS

// ═══════════════════════════════════════════════════════════════════════════════

// --- Legs: Barbell (8) ---

{ name: 'Barbell Calf Raises', equipment: 'barbell', muscle: 'legs', type: 'isolation', metrics: 'weight-reps' },

```

Step 3: Add in Alphabetical Order

Insert the new exercise in the correct alphabetical position within its section:

```typescript

// --- Legs: Barbell (8) --- ← Update count to (9)

{ name: 'Barbell Calf Raises', equipment: 'barbell', muscle: 'legs', type: 'isolation', metrics: 'weight-reps' },

{ name: 'Barbell Good Mornings', equipment: 'barbell', muscle: 'legs', type: 'compound', metrics: 'weight-reps' },

{ name: 'Barbell Hack Squat', equipment: 'barbell', muscle: 'legs', type: 'compound', metrics: 'weight-reps' }, ← NEW

{ name: 'Barbell Hip Thrust', equipment: 'barbell', muscle: 'legs', type: 'compound', metrics: 'weight-reps' },

```

Step 4: Update Counts

1. Update the section comment count: // --- Legs: Barbell (8) --- → (9)
2. Update the file header summary

Step 5: Verify

Run type-check to ensure no duplicates or type errors:

```bash

pnpm type-check

```

The file has runtime duplicate detection - if you add a duplicate name, it will throw an error immediately.

1. Duplicate names: Every exercise name must be unique across ALL muscles/equipment
2. Wrong section: Always add to the correct muscle AND equipment section
3. Not alphabetical: Keep exercises sorted A-Z within each section
4. Forgetting counts: Update both the section count and header summary
5. Wrong metrics: Use 'weight-reps' for weighted, 'reps-only' for bodyweight

When adding multiple exercises at once:

1. Group them by muscle → equipment
2. Add each to its correct section alphabetically
3. Update all affected counts
4. Run pnpm type-check once at the end