Public npm package
An exercise database you can install from npm
Add 701 illustrated exercises to a fitness app as local JSON and 512px WebP files. No API key, runtime service, or install scripts.
EN / DE / ES · TypeScript declarations · Commercial in-app use with attribution
$ npm install @repdb/exercises 701 exercises
The current fully illustrated RepDB catalog.
Flat WebP files
512px illustrations, ready for local asset pipelines.
Three languages
Names, descriptions, instructions, and tips in EN, DE, and ES.
Zero dependencies
No runtime packages and no install-time scripts.
Use it locally
JavaScript helpers, TypeScript declarations, or direct JSON
Import the small dependency-free runtime when you want path helpers, or read the dataset directly when your build already owns the data layer. Image URLs returned by the CDN helper are pinned to the installed package version.
import repdb from '@repdb/exercises';
const exercise = repdb.getExercise('arnold-press');
console.log(exercise.name_en);
console.log(repdb.getImagePath(exercise, 'peak'));
console.log(repdb.getCdnUrl(exercise, 'peak')); const dataset = require(
'@repdb/exercises/exercises.json'
);
console.log(dataset.exercises.length); // 701 Package contents
Exercise records and images ship together
Each record contains muscles, equipment, difficulty, goals, tags, MET values, localized instructions, and its available image poses.
exercises.json— multilingual exercise records and taxonomyimages/flat/*.webp— start/peak or single-pose illustrationsindex.cjs— lookup, path, and version-pinned CDN helpersindex.d.ts— TypeScript declarationsLICENSE.mdandATTRIBUTION.md— shipping terms and copy-ready credit
Public catalog vs paid assets
Prototype from npm. Upgrade when the product needs more.
@repdb/exercises
- All 701 current exercise records
- Flat 512px WebP images
- EN, DE, and ES content
- Visible attribution required
Paid RepDB bundles
- The same complete exercise catalog
- Classic and flat assets up to 1024px
- Transparent backgrounds and animations on Standard
- Commercial license without attribution
FAQ
Using the RepDB npm package
Does the npm exercise package call an API?
No. The JSON, TypeScript declarations, and WebP images are installed with the package. There is no account, API key, runtime request, rate limit, or hosted-service dependency.
Can I use @repdb/exercises in a commercial fitness app?
Yes, inside personal and commercial applications with visible RepDB attribution. Republishing the package as another dataset or API is not allowed. Review the included LICENSE.md before shipping.
What is the difference between the npm package and the paid RepDB bundle?
The npm package contains the 701-exercise public catalog with flat 512px images. Paid RepDB plans include the same exercise records with 1024px assets, additional visual formats, and a commercial license without attribution. Standard also adds transparent backgrounds, animations, SQLite, and more developer formats.
Does the package support TypeScript?
Yes. The package includes declarations for the dataset records and its dependency-free helpers. The same exercise data can also be imported directly from exercises.json.
How does the package compare with ExerciseDB and other exercise APIs?
The package is local data: no endpoint, key or monthly quota. Hosted options such as ExerciseDB, WorkoutX, AscendAPI, API Ninjas, MuscleWiki and wger trade that for remote search and media delivery, each with its own quotas and license terms.
Compare ExerciseDB alternativesNeed a complete production dataset?
Compare the full image formats, animations, developer files, and commercial license.