The app

The server in this repository is optional. This is the thing it is optional for.

The app is in closed testing. It is not on the App Store yet, and these pages describe a build that is still going to TestFlight. The source of the app itself is not in this repository — only the backend it can optionally talk to.

About these pictures

They are taken from the running app on a simulator, one launch per screen, no manual tapping, a fixed random seed. Everything above the data layer is the shipping code: the same views, the same analysis, the same wording.

The person in them does not exist. A fresh simulator’s Health database is empty, so the screens are fed from a generated five-month history rather than from anyone’s measurements. The numbers are lifelike, and none of them are real.

The app ships in English and Hungarian, and follows the phone’s own language and region — there is no language switch inside it. Both sets are here, because a translation you cannot see is a translation nobody checked.

Today — The opening tab, in four named bands of cards. Every card can be switched off and reordered. — **Today**The opening tab, in four named bands of cards. Every card can be switched off and reordered.

Trends — 120 metrics, grouped; day, week, month and year. The dashed line is the previous period. — **Trends**120 metrics, grouped; day, week, month and year. The dashed line is the previous period.

Workouts — Grouped by month with a count and a total, filterable by type, place, duration, distance, energy and heart rate. — **Workouts**Grouped by month with a count and a total, filterable by type, place, duration, distance, energy and heart rate.

Sleep — The night as it was recorded, with stages, efficiency, and the pattern across the period. — **Sleep**The night as it was recorded, with stages, efficiency, and the pattern across the period.

Water — The daily amount, and a moss that dries out and comes back. Written to Apple Health, not kept separately. — **Water**The daily amount, and a moss that dries out and comes back. Written to Apple Health, not kept separately.

Events — What the watch recorded, and what you felt at the time. The second half is the part no other app keeps. — **Events**What the watch recorded, and what you felt at the time. The second half is the part no other app keeps.

Challenge — The monthly streak, with rest days built in rather than bolted on. — **Challenge**The monthly streak, with rest days built in rather than bolted on.

Settings — Everything is off by default, including notifications and the calendar. — **Settings**Everything is off by default, including notifications and the calendar.

Apple Health is the only store

Everything the app records goes into Apple Health: the daily journal, the symptoms written on events, the water. There is no separate Helsa store for measurements — not on the phone, and not on the server this repository builds. What a server holds is a copy for reading on other screens, never the original.

It is what lets the app be removed without taking anything with it. The price is worth saying out loud rather than leaving to be discovered:

Body water percentage: No type exists.
Skeletal muscle mass: No type exists. Health has lean body mass, which measures something else — bone, water and organs are counted in it.
Lab results: Health displays them, but only when sent by a healthcare institution. No app may write them.
Circumferences other than the waist: Only the waist has a type.

A scale is not useless because of this: body mass and body fat percentage do have types and arrive normally. It is these extra numbers that stop at the door.

If Apple adds a type, it appears in the app on its own — it works from the list of types rather than from a list of its own. The reverse would create data that exists nowhere else, which is the one thing the design is built to avoid.

What is not shown here

The Apple Watch app and the complications, because the app has not yet run on a watch — the minimum is watchOS 26, which needs a Series 6 or newer. The widgets, for the same reason a widget is hard to photograph honestly: what they show depends on the hour you look.

Run the optional server →