Evinlo Explainers

How Evinlo works

Every number in Evinlo comes from rules you can read. Each explainer takes one area from what your Apple Watch records to what you see in the app, in a few minutes of reading.

Each one starts with the one-minute version, then goes through the steps with a figure for each, a worked example, what you see in the app and the honest limits. The last pages are for experts: every parameter, formula and source. The figures and examples are calculated by Evinlo’s own algorithms on made-up people, never on anyone’s real data.

  1. Sleep, explained

    The sleep score, your sleep need and sleep debt, tonight’s need, naps, and what your answer to “How did you wake up?” changes.

    The question it answersWhy did last night get this score, and where does tonight’s need come from?

  2. Alertness and the daily check-in, explained

    A published model of alertness, driven by your sleep times and tuned to your own one-tap answers.

    The question it answersHow awake may I feel today, and why does Evinlo ask me first?

  3. The overnight layer, explained

    Which nights count, how each night’s values are taken from Apple Health, how your usual ranges form, and the heart signal.

    The question it answersWhat does “your usual” mean, and which nights does it come from?

  4. Body signals, explained

    Overnight HRV, sleeping heart rate, respiratory rate, wrist temperature and blood oxygen, each against your own recent nights.

    The question it answersWas anything my body recorded last night outside my usual range?

  5. Overnight changes, explained

    A narrow check for several overnight signals moving away from your usual together. It shows that something changed, never why. Not a diagnosis.

    The question it answersDid several of my overnight signals change together?

  6. Readiness, explained

    A score from 0 to 100 for how ready your body is for effort today, from your night, your overnight signals and yesterday’s activity, against your own usual.

    The question it answersHow ready is my body for effort today, and what moved the score?

  7. Stress, explained

    Recovery and stress across the waking day: when your heart rate at rest was above your own usual level, and for how long. There is no daily stress number.

    The question it answersWhen was my heart rate at rest above my usual level today?

  8. Movement, explained

    Steps, active energy, exercise minutes and time in daylight against your own usual, with no score, no goal and no ring.

    The question it answersHow does today’s movement compare with what is usual for me?

The complete reference

The explainers follow docs/scoring.md, the scoring document next to the code on GitHub. It describes every area in full: each rule and parameter, the data it reads, the studies it rests on and what is a design choice, how each version was validated, and the questions still open.

If an explainer ever says something different from the code, the code is what the app runs, and the difference is a mistake worth reporting. To question a rule or propose a better one, see how to contribute, or send feedback.