Astro MIT

workout-guide

302 open exercise illustrations and a framework-neutral npm package by Bryl Lim

B

bryllim

Dernière activité 26 août 2026
bryllim/workout-guide

1,3 k

étoiles

194

forks

2

issues ouvertes

exerciseexpofitnessnpm-packageopen-sourcereact-nativeworkout

Ce README est souvent en anglais.

Workout Guide

An open exercise illustration library containing 302 exercises, three consistent frames per exercise, a typed framework-neutral npm package, and a searchable static gallery.

The original pose artwork used by this project comes from Everkinetic under CC BY-SA 4.0. Bryl Lim expanded upon that foundation with additional exercises and animation frames, normalized assets, structured metadata, package APIs, and the documentation gallery.

Browse the gallery · Read the guide · Open the package on npm

Install

npm install @bryllim/workout-guide
import { getExercise, searchExercises, getAssetUrl } from '@bryllim/workout-guide';

const pushUp = getExercise('push-up');
const bodyweightChest = searchExercises('chest', { equipment: 'bodyweight' });
const firstFrame = getAssetUrl('push-up', 1);

Direct asset imports and literal React Native require() examples are documented in the integration guide.

Repository

This npm-workspace monorepo contains:

  • packages/workout-guide: package API, canonical manifest, and all 906 transparent 512 × 512 SVGs, with PNG sources retained for compatibility.
  • apps/site: Astro landing page, gallery, detail pages, and guide.
  • scripts: deterministic catalog import and validation utilities.

Run the project locally:

npm install
npm run check
npm run dev

The normalized catalog and all package assets are checked into the repository. Maintainers can regenerate them from a compatible source export with npm run catalog:import -- /path/to/source.

Licensing

Code and documentation are available under the MIT License. Visual assets are licensed under CC BY-SA 4.0. See LICENSES.md and ATTRIBUTION.md for the complete breakdown, including Everkinetic-derived poses.

Contributions are welcome. Please read CONTRIBUTING.md and the Code of Conduct.

Projets similaires

1,324-exercise fitness dataset — animation GIFs, 180×180 thumbnails, muscle-group & equipment data, and step-by-step instructions in 6 languages. The exercise data layer behind the LogPress app.

HTMLdatasetexercise-databaseexercises
Hhasaneyldrm
22,4 k étoiles2,9 k

🏋 Modern open-source fitness coaching platform. Create workout plans, track progress, and access a comprehensive exercise database.

TypeScriptcoachexercisefeature-sliced-design
SSnouzy
8,5 k étoiles751

https://github.com/DuarteSantos8/openGym

JavaScript
Aarvids-unavailable
7 k étoiles1,2 k