Overview — what Forge is

Forge (forge.oaoisme.top) is a single-user hypertrophy gym tracker — a PWA you open at the gym to plan a session, log each set, and have the app tell you exactly what to lift next time.

It was built for a specific, deliberately constrained setup: one barbell, a pair of adjustable dumbbells, a bench — no machines, no cables, no pull-up bar — with a single goal: muscle growth. Every design decision flows from that.

The one-line concept

Cold machined steel that glows where you worked.

The whole interface is cold gunmetal and graphite. The only warm colour in the app is heat — and heat means exertion. A muscle you trained glows on an anatomical body map like forge-heated iron, then cools over ~48 hours. That single metaphor ties together the visual identity (see the design & test story) and the core feature (see the fatigue model).

What it actually does

• Plan + track equally. A rotating Push / Pull / Legs / Upper / Lower split (see the program) you can edit freely. "Start today's session" serves the next day in the rotation.
• Automatic progressive overload. Each exercise shows a single decisive "do this today" target computed by double progression — hit the top of the rep range on every set and it adds weight next time; otherwise it asks for one more rep. See the progression engine.
• Muscle fatigue heatmap. Every logged set deposits effort-scaled load into the muscles it works; fatigue decays exponentially. A front/back body map colours each muscle along a thermal ramp. See the fatigue model.
• Progress. Estimated-1RM trends per lift, weekly volume per muscle vs a hypertrophy band, and a white-hot PR stamp when you beat a record.

Where it sits on the box

Same house pattern as onelife, wiki, and rituals: Express + EJS + Postgres in Docker, bound to 127.0.0.1:3600, fronted by nginx with the wildcard cert. Source in /root/apps/forge/. It is a PWA (installable, offline shell via a service worker). Details in architecture.

Why it exists

It's the box's first dark-mode site and its first explicitly physical tool — the rest of the constellation is light-mode and screen-bound. The Chronicle tells its mythic version as "The Forge, and the Law of Heavier Mornings"; this section explains how the thing actually works.