Skip to content

About

Random-interval workout timer you load with your own exercises. Offline PWA. 100% AI-generated from an idea on somebodybuildthis.dev

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Repository files navigation

This is a 100% AI-generated project. It was designed, written, tested and deployed by the Somebody Build This steward (Claude, by Anthropic), from this idea on the board: A random-interval workout timer you can load with your own exercises.

Built from an idea on Somebody Build This

Shuffle Timer

A random-interval workout timer you load with your own exercises. Type in what you want to do (jog, walk, sprint, or anything else), say how long work and rest can be, and the timer picks each round for you. No planning: every start gives you a freshly randomized workout.

Use it: https://interval-workout-timer-gilt.vercel.app

What it does

  • Your own exercises. One per line. Each round picks one at random, and avoids repeating the same one twice in a row when there is a choice.
  • Random lengths. Give a list (30, 45, 60), a range (20-90), or a mix. 1:30 and 2m work too. Rest works the same way; use 0 to skip rests.
  • Rounds and an estimate. Pick how many rounds and see roughly how long the workout will take.
  • Saved lists. Save exercise lists by name and switch between them with one tap.
  • Hard to miss cues. A big countdown, the color changes between work (orange) and rest (green), beeps for the last 3 seconds and at each switch, and vibration on phones that support it.
  • An honest summary. The finish screen shows the time you actually did, and marks rounds you skipped.
  • Start, pause, skip, end. Keyboard too: Space pauses, N skips, Esc ends.
  • Keeps the screen on during a workout, where the browser allows it.
  • Works offline. Install it to your home screen and use it with no signal.
  • Private. Everything is saved on your device only. No account, no cookies, no analytics scripts, no third-party scripts, and no tracking by the app. Like any website's host, Vercel keeps request logs that can include IP addresses and referring sites. We only look at weekly totals of requests to load the app, grouped by referring site, to see whether people find it; these count requests, not people. We don't look at individual requests.

Works on phones from 375px wide, follows your system's light or dark mode, and respects "reduce motion". Screen readers hear each new round, can read the time left at any point, and hear it on pause.

Develop

Needs Node 22+ and pnpm.

pnpm install
pnpm dev       # local dev server
pnpm test      # unit tests (vitest)
pnpm check     # typecheck + tests
pnpm build     # production build into dist/

The interesting logic is small and pure, in src/logic/:

  • rng.ts is a seedable random number generator (mulberry32), so plans are testable.
  • durations.ts parses what people type into the length boxes and picks a length.
  • plan.ts builds the whole workout up front from the settings.
  • timer.ts is a timestamp-based state machine (start, tick, pause, resume, skip), so the clock stays accurate even when the browser slows down background tabs. It records the time actually spent in each segment.

The offline logic is in src/sw/worker.js (tested in worker.test.ts); the build inlines it into /sw.js with the list of files to cache.

It is a static site (Vite + vanilla TypeScript) with no environment variables or secrets, hosted on Vercel.

Maintenance

This app is looked after, not left behind. Dependabot proposes dependency updates. The Somebody Build This steward checks on the app each month and reviews security alerts in a weekly security check. Updates go through review and automated checks before they are merged.

Found a problem? Open an issue on this repository and describe what happened.

Build your own version

Ideas on Somebody Build This never lock. This is just one take on the idea, and anyone is welcome to build their own version and ship it there too.

License

MIT

About

Random-interval workout timer you load with your own exercises. Offline PWA. 100% AI-generated from an idea on somebodybuildthis.dev

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Used by

Contributors

Languages