Tools/bryllim/workout-guide

workout-guide

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

1.1k+516/wkemergingAstroMIT Licensenew this week

The Lens

By Erik Loyd, SaaS CEO and former COO/CFO of an AWS Premier Partner.

Updated Aug 2026

Building a fitness app means commissioning exercise illustrations or licensing a stock library, and both cost money before you have a single user. Workout Guide is 302 exercises with three consistent frames each, 906 transparent 512 by 512 SVGs, wrapped in a typed npm package that does not care which framework you use.

The API is three functions: getExercise by slug, searchExercises with filters like equipment type, and getAssetUrl to pull a specific animation frame. Assets are checked into the repository, so you can import them directly or bundle them however you like, and the React Native import patterns are documented. There is a searchable static gallery if you want to browse the catalog before installing anything.

The licensing is split and you need to read it. Code and documentation are MIT. The artwork is CC BY-SA 4.0, inherited from the Everkinetic project this builds on, with additional exercises and animation frames layered on top. Share-alike means derivative artwork carries the same license and attribution is required. For most apps that is fine. If your legal team treats share-alike as radioactive, this is a no.

The catch: the project is new, so treat the three-frame animations as a starting point rather than a finished product, and the metadata is only as complete as the source catalog it imported. Worth saying out loud too, this is an asset library and not a workout engine. Programming, progression, and set tracking are still yours to build.

Free vs Self-Hosted vs Paid

fully free

Free tier: All 302 exercises, all 906 SVGs, the npm package, and the gallery site. Nothing is withheld.

Self-hosted: The assets live in the repository. Clone it, or install @bryllim/workout-guide from npm and serve the SVGs from your own CDN. There is no service to run and no API to call.

Paid: None. There is no commercial tier and no alternative license on offer, which matters because the CC BY-SA 4.0 artwork terms are the only terms available.

Free, but the license splits: MIT code and CC BY-SA 4.0 artwork. The share-alike clause on the illustrations is the actual cost.

What to do by team size

Solo
free
Small team
free
Medium team
free; have someone read the CC BY-SA terms before you ship
Large team
free, but legal will want to review the share-alike clause on the artwork
Self-hosting ops:trivial

Get tools like this every Wednesday

One featured tool, three on the radar. No fluff.

Score
70/100 · B+
Adoption13/30
Maintenance25/25
Community7/20
License15/15
Analysis10/10

A low score is not a verdict on quality. Young and niche tools start low by design. How we calculate scores

Trust Signals

Notable author: 1,280 followers

License: MIT License

Use freely, including commercial. Just keep the license.

Commercial use: ✓ Yes

About

Owner
Bryl Lim (User)
Stars
1,061
Forks
166

Explore Further

More tools in the directory