How it works · A year, in eight chapters
The first year,
in eight chapters.
What follows is not a feature list. It is the shape of a year as a chronic-illness patient actually lives it — the first day, a typical Tuesday, a flare night at three a.m., week one, month three, the appointment that almost went well, six months in, and finally year one. Read it as a story. Then decide whether you want to be in it.
the first day
Chapter the First · The first day.
You install the app. You select the conditions that apply — fibromyalgia, migraine, ADHD, whichever ones live in your day. You tell Vaely what you would like the AI to focus on. The onboarding takes roughly four minutes. Most of that is reading.
Then a microphone appears, and a small instruction below it: "Try one entry the way you would describe it to a friend." You say something like, "Today is okay, about a four out of ten." The structured fields fill in. The confirmation card appears. You tap save. There is, briefly, the relief of wait, that worked.
a typical day
Chapter the Second · A typical day.
You wake. You take the morning meds. You log in fifteen seconds without opening the app — Siri handles it: "Log fatigue at four, magnesium taken." Lunch arrives. You note that the head pain is creeping in. You log from your wrist while the kettle boils, twenty seconds. Evening comes. You take the next dose. You speak the entry into the iPhone while you wash a dish.
Three logs. Ninety seconds, total, across the day. The app does not ask you anything else. There are no streak warnings, no way to go! banners, no daily-check-in modal. The journal exists; it does not perform.
two-forty-seven a.m.
Chapter the Third · A flare night.
You wake at two-forty-seven. The pain is at a seven, maybe an eight. The phone is face-down on the nightstand because the brightness is the enemy. The watch is on your wrist because it always is.
You do not turn on the light. You do not unlock the phone. You raise the wrist and say, half-aloud, half-into-the-pillow, head pain seven, maybe nausea coming in. The watch hums once, briefly. The entry saves. You close your eyes again. The journal will hold the sentence until morning.
week one
Chapter the Fourth · The first weekly summary.
On the seventh day, a card appears on the home screen of the app. It is plain English, written in the same voice you wrote the entries in. Not a chart that demands interpretation. Not a score that ranks you against last week. A few short paragraphs that say, more or less, here is what your journal shows.
You read it twice, because nobody has summarized your symptoms back to you in your own words before. Your therapist's notes do not. Your patient portal does not. The first weekly summary is a small, warm thing that you did not know you wanted, until it was there.
month three
Chapter the Fifth · A pattern, surfacing.
Three months in, you open the app on a Sunday afternoon and find an observation card waiting. It says, Your journal shows you log more joint pain on days following sleep under five hours. Twenty-three entries. Across March through May. You read it. You sit with it. You consider that you had suspected this for years and never had the entries to prove it.
The observation is retrospective. It is not a prediction. It does not say tomorrow's risk. It says this is what happened, in your own data, when these two things lined up. That is enough. That is, in fact, the whole point.
the appointment
Chapter the Sixth · An appointment that almost went well — and then did.
Tuesday at ten. You have eleven minutes with the rheumatologist. Two days before, the app surfaces a pre-visit briefing — three patterns from the journal worth bringing up. You read it on the bus to work, on Sunday, at your own pace. You forget two of them by Tuesday. The PDF, generated on your phone the night before, holds all three.
You hand the doctor the PDF. She reads it in the time it takes you to settle into the chair. She has a question you would not have thought to invite. The eleven minutes go better than the last six appointments combined. In the parking lot, you press a button and speak the recommendations into the phone — nadolol five mg mornings, magnesium down to two hundred, follow up in eight weeks. By the time you are home, it is in your timeline.
six months in
Chapter the Seventh · The medication, finally legible.
Six months in, the medication-effectiveness card surfaces something you suspected and could never prove: since the switch to naratriptan in March, headache severity drops within two hours in nine of eleven logged uses. Before the switch, ibuprofen worked that quickly in three of fourteen. The numbers are there because the entries are there.
You bring the chart to the next appointment. The doctor sees it before you do — two months of consistent improvement that nobody had a way to render. She asks if you want to try lowering the prophylactic dose. You discuss it. You decide. The record is yours, and it is making the conversation possible.
year one
Chapter the Eighth · A record you own.
By the end of the first year, the journal is twelve months long. Several hundred entries. A handful of doctor PDFs. A few weekly summaries you re-read on bad days because they reminded you of better ones. The patterns you suspected are now documented. The patterns you did not suspect are listed too.
And the record is yours. Not held hostage by a patient portal you cannot leave. Not locked to a provider who will not exist for you in two years. You can write the whole year to Apple Health and trust the system you already trust. You can generate an encrypted backup file the size of a couple of photos. You can switch insurance, switch doctors, file a disability claim, change continents — and the record comes with you, because it never lived anywhere except your phone.
By year two, the journal is yours. And so is the year.
Questions about the year
The plain answers.
Do I have to log every day to get value?
No. The AI works with whatever you give it. Some patients log every day. Some log only during flares. Some log three times a week. The patterns surface from the entries that exist; missing days do not break anything. Vaely is anti-guilt by design — the streaks and badges in Pro are off by default.
What happens if I miss a week or a month?
Nothing. The journal waits. There are no nudges that escalate, no shame screens, no recovery onboarding. When you come back, you pick up where you were. The AI uses everything that is there and ignores the gaps.
How long until real patterns are visible?
Roughly four to eight weeks of consistent-enough logging produces patterns the AI can summarize with confidence. Some patterns appear earlier — a clear medication response can be visible in two weeks. Multi-variable patterns (sleep × pain, weather × flare, stress × symptom) take longer because they need a few cycles of co-occurrence. The pattern observations are conservative on purpose.
What if I get a new diagnosis after I have started using it?
Add it in Settings. The AI re-tunes for the new condition without losing your prior history. Your past entries continue to be searchable and continue to feed pattern analysis; the new condition just shapes how the doctor PDF is structured and what symptoms the onboarding emphasized. Your record extends, it does not reset.
Is this primarily an iPhone app or an Apple Watch app?
iPhone-primary, Watch-companion. The full app lives on the iPhone — the doctor PDF generation, the pattern analysis, the settings, the long reading. The Apple Watch is the logging surface for the moments when reaching for a phone is the wrong move. Watch is most-loved during flares; iPhone is most-loved during appointment week.
Chapter one,
when you are ready.
The free tier is enough to start. Pro adds the patterns, the doctor PDFs, the watch app, and the rest.