Skip to content
schuhwerkPublic

About

PULSE is a single-file workout timer PWA. Structure interval trainings with timed exercises and rest periods, then hit play — it guides you through each move with countdowns, images, and audio cues. Supports multiple trainings, per-exercise rest, wger.de exercise search, drag-to-reorder, and JSON export/import. No build step.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Repository files navigation

PULSE

A small bodyweight workout timer that runs in the browser. No server, no account. Inspired by Feeel.

Demo: vs.digital/pulse

Home: list of trainings Training detail: exercise list Player: exercise countdown Player: rest with up-next preview

You can create several trainings. Exercises come from wger.de or can be added by hand, and you drag them to reorder. The player counts down each exercise and rest with beeps and voice cues, and shows what's coming next. Everything is stored in localStorage and can be exported or imported as JSON. You can install it as a PWA and use it offline, and it keeps the screen on during a workout.

Running it

The whole app is one file, index.html. You can download it and open it directly. The illustrations for the built-in exercises are in images/ and the font is in fonts/, so put those folders next to the file if you want them.

The wger search, offline mode and the screen wake lock need HTTP(S):

python3 -m http.server   # or: npx serve .

Development

  • Dev server: bun run dev serves on port 8080 on all interfaces and prints a QR code for each LAN URL, so you can open it on a phone. Over plain HTTP on a LAN IP the browser treats the page as insecure: no service worker and no wake lock. Everything else works.
  • Tests (Playwright): bun run test. See docs/TESTS.md.
  • Icons: icon-180.png, icon-192.png and icon-512.png are rendered from the SVGs for platforms that ignore SVG icons (iOS home screen). After changing an SVG, run bun run icons.
  • Versioning: a pre-commit hook bumps APP_VERSION in index.html and CACHE_NAME in sw.js on every commit that touches index.html. If you already bumped it yourself, the hook leaves it alone. To enable it after cloning, run git config core.hooksPath hooks.

To trigger the "built-in trainings updated" modal by hand, paste this into the browser console:

const s=JSON.parse(localStorage.getItem('pulse_data'));
s.version='0.0.0';
delete s.settings._pendingBuiltinIds;
const v=s.trainings.find(t=>t.builtinId==='vitus-2026');
if(v) v.builtinHash='stale';
localStorage.setItem('pulse_data',JSON.stringify(s));
location.reload();

The modal needs both a stale builtinHash and a version that differs from APP_VERSION.

License

MIT. Code and exercise illustrations © Vitus Schuhwerk. Please keep the license notice if you reuse them.

About

PULSE is a single-file workout timer PWA. Structure interval trainings with timed exercises and rest periods, then hit play — it guides you through each move with countdowns, images, and audio cues. Supports multiple trainings, per-exercise rest, wger.de exercise search, drag-to-reorder, and JSON export/import. No build step.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Contributors

Languages