@repdb/exercises

601 illustrated exercises for fitness applications — JSON, 512 px flat WebP images, and English/German/Spanish content.

This package is the npm distribution of the RepDB community dataset snapshot. It is a dated, attribution-required subset of the full commercial RepDB catalog.

Install

npm install @repdb/exercises

The package has no runtime dependencies and runs no install scripts.

Use

CommonJS:

const {
  exercises,
  getExercise,
  getImagePath,
  getCdnUrl,
} = require("@repdb/exercises");

const squat = getExercise("squat");
console.log(squat.name_en);
console.log(getImagePath(squat, "peak"));
console.log(getCdnUrl(squat, "peak"));

ES modules:

import repdb from "@repdb/exercises";

const exercise = repdb.getExercise("arnold-press");

Direct JSON:

const dataset = require("@repdb/exercises/exercises.json");
console.log(dataset.count);

Package contents

exercises.json              601 multilingual exercise records
images/flat/*.webp          512 px flat illustrations
index.cjs                   dependency-free helpers
index.d.ts                  TypeScript declarations
LICENSE.md                  RepDB community dataset license
ATTRIBUTION.md              copy-paste attribution snippets

Each exercise contains names, descriptions, instructions and tips in EN/DE/ES, plus muscles, equipment, difficulty, goals, tags, MET values and image paths. Exercises use either start + peak images or a single main image for static holds and stretches.

Images

getImagePath() returns a package-relative path such as:

images/flat/arnold-press-peak.webp

Use the file from node_modules/@repdb/exercises/, copy it into your application's asset pipeline, or use getCdnUrl() for a version-pinned jsDelivr URL.

License and attribution

The dataset and images may be used in personal and commercial applications with visible attribution. Redistribution as a standalone dataset/API and generative-AI derivation are prohibited. Read LICENSE.md before shipping.

Required credit:

Exercise data by [RepDB](https://repdb.co)

Paid RepDB bundles

Paid RepDB bundles contain the same exercise catalog with 1024 px classic illustrations, transparent backgrounds, looping animations, SQLite and a commercial license without attribution:

repdb.co/pricing

Other community mirrors

• GitHub: https://github.com/RepDB/exercise-dataset
• Hugging Face: https://huggingface.co/datasets/RepDB/exercise-dataset
• Kaggle: https://www.kaggle.com/datasets/sergeiargutin/exercise-dataset

Package snapshot: 2026.8.1.