Skip to content

bryllim/workout-guide

  • URL: https://github.com/bryllim/workout-guide
  • Stars: 1051
  • Language: Astro
  • Category: Web & Frontend
  • Topics: exercise, expo, fitness, npm-package, open-source, react-native, workout

What it does

The Workout Guide is an open exercise illustration library that provides 302 exercise illustrations, each with three consistent frames. It offers a framework-neutral npm package that allows developers to integrate these illustrations into their applications easily.

Why it's interesting

Unlike typical exercise libraries, this project combines a comprehensive set of illustrations with a structured API, making it easier for developers to search and retrieve specific exercises based on criteria like equipment type. The use of SVG assets ensures high-quality visuals that are scalable and lightweight.

How it works

The repository is structured as an npm workspace monorepo, containing a package for the API and a separate app for the gallery and documentation. It includes utilities for catalog import and validation, and all assets are checked into the repository, allowing for easy access and regeneration from source exports. The README does not specify the exact methods used for generating or normalizing the assets, leaving some uncertainty in that area.

Get started in 5 minutes

To get started, run the following commands:

npm install
npm run check
npm run dev

This will set up the project locally, allowing you to explore the gallery and documentation.

Watch out for

The project is relatively new, created in August 2026, which may imply that it is still maturing. While the code is licensed under MIT, the visual assets are under CC BY-SA 4.0, which may impose restrictions on usage in certain contexts. Always check the LICENSES.md for detailed licensing information.