Sign inSign up

iamnazzal/gopromotional-mugday

By iamnazzal

•Updated 8 days ago

Caffeine tracker with half-life estimate, sleep-ready time and reusable-cup stats.

Image
0

67

iamnazzal/gopromotional-mugday repository overview

⁠iamnazzal/gopromotional-mugday

Log coffee, tea and other drinks with typical caffeine values, compare the day's total with a limit (400 mg adult, 200 mg in pregnancy), estimate how much caffeine is still in your system, find out when it should drop below a sleep-friendly level, and track how often you used a reusable cup. Typical values only; not medical advice.

  • 16 drinks with typical caffeine (espresso 63 mg, filter coffee 140 mg, tea 75 mg, cola 40 mg...), or pass your own mg.
  • Daily total against a limit: 400 mg (adult) or 200 mg (pregnancy), or your own.
  • Caffeine in your system using a 5-hour half-life (configurable).
  • Sleep-ready time: when the level should fall below a threshold (default 50 mg), rounded up to 15 minutes.
  • Reusable-cup stats for the last 7 days.
  • Plain JSON log shared by the npm, PyPI, crates.io and RubyGems versions.

A small image (node:20-alpine, no dependencies, runs as the unprivileged node user) with the gopromotional-mugday CLI as its entrypoint.

⁠Usage

docker run --rm iamnazzal/gopromotional-mugday --help
docker run --rm -v "$PWD:/data" --user "$(id -u):$(id -g)" iamnazzal/gopromotional-mugday add flat-white --reusable

The working directory is /data; mount a host folder there to keep your log between runs.

$ gopromotional-mugday drinks
espresso               63 mg  (30 ml)
double-espresso       126 mg  (60 ml)
americano             126 mg  (350 ml)
latte                 126 mg  (350 ml)
cappuccino            126 mg  (350 ml)
...

$ gopromotional-mugday add flat-white --time 2026-10-19T08:00 --reusable
Logged flat-white (126 mg, reusable cup). Today: 126/400 mg.

$ gopromotional-mugday add tea --time 2026-10-19T11:00 --reusable
Logged tea (75 mg, reusable cup). Today: 201/400 mg.

$ gopromotional-mugday add filter-coffee --time 2026-10-19T14:00
Logged filter-coffee (140 mg). Today: 341/400 mg.

$ gopromotional-mugday today --date 2026-10-19
2026-10-19: 341 mg from 3 drink(s); 59 mg left of 400 mg.

$ gopromotional-mugday in-system --at 2026-10-19T22:00
About 81 mg of caffeine still in your system at 2026-10-19T22:00 (half-life 5 h).

$ gopromotional-mugday sleep-ready
Below 50 mg from about 2026-10-20 01:30.

$ gopromotional-mugday cups --date 2026-10-19
Last 7 days: 2 reusable, 1 disposable (67% reusable).

⁠Build

cd packages/travel-mugs
docker build -f docker/Dockerfile -t iamnazzal/gopromotional-mugday:1.0.1 -t iamnazzal/gopromotional-mugday:latest .

Image labels follow the OCI spec: org.opencontainers.image.url points to the project page and org.opencontainers.image.source to the repository.

⁠Links

Tag summary

Content type

Image

Digest

sha256:95a87b067…

Size

46.1 MB

Last updated

8 days ago

docker pull iamnazzal/gopromotional-mugday