EMI: feat: give the phase guide short tips and say that everyone is different by juliantellez · Pull Request #368 · atlantic-blue/emi

juliantellez · 2026-10-20T03:43:45Z

What. The phase guide now gives one short, practical tip for each area of each phase, and it ends with one line that says everyone is different. The guide title names the phase in plain words, for example "Before your period: what may help", and the Home card names it the same way. The lines of issue 323 that change the meaning also change, in English, Spanish and Russian.

Why. The beta group said the guide read like a lecture and did not help. Polina asked for short tips, plain names for the phase, and a line that people feel different things. Step 24 (#362) changed the Russian only lines. This step does the lines that change the meaning in all three languages.

flowchart LR
  A["Home: ring names the phase"] --> B["Card: Before your period, days 19 to 28"]
  B --> C["Cycle phase page"]
  C --> D["How you may feel and what may help"]
  D --> E["Guide: one short tip for Mood, Appetite, Body and Movement"]
  E --> F["Everyone is different"]

Stack. 1. #362 (step 24). 2. This pull request (step 30), based on the branch of 362. Merge 362 first.

Pictures. iPhone SE (3rd generation). In each row: the board where one exists, then the app before (the branch of step 24), then the app after (this branch).

Phase guide, English (the design is the phaseGuide board)

Phase guide, Russian

Home, ring and phase card, English

Home, ring and phase card, Russian

Day entry, Russian (after only)

I captured the pictures on the simulator from Metro on this checkout. The before pictures are the branch of step 24 at 992a406. The after pictures are this branch, with the app code of e7d019d. They are observed, not rendered. The phone holds a luteal day (day 20 of 28), so the after guide shows the luteal tips. The other three phases are in the tests and in the text below.

Issue. Closes #323: #323. The issue closes together with #362, which is merged first.

Draft text for review. Each changed key, in English, Russian and Spanish, old and new. Polina wrote the four luteal tips, the luteal title, the line that everyone is different, «Фаза определена приблизительно.», «Отметьте всё, что подходит.», «Здесь появятся ваши наблюдения» and «Запись за сегодня». I wrote the other three phases in the same shape, because she did not review them.

home.phaseCard.estimate
- English, new: This phase is an estimate.
- Russian, new: Фаза определена приблизительно.
- Spanish, new: Esta fase es una estimación.
home.phaseCard.period.day
- English, old: Period phase, day {from}
- English, new: During your period, day {from}
- Russian, old: Менструальная фаза, день {from}
- Russian, new: Во время месячных, день {from}
- Spanish, old: Fase del periodo, día {from}
- Spanish, new: Durante el periodo, día {from}
home.phaseCard.period.days
- English, old: Period phase, days {from} to {to}
- English, new: During your period, days {from} to {to}
- Russian, old: Менструальная фаза, дни с {from} по {to}
- Russian, new: Во время месячных, дни с {from} по {to}
- Spanish, old: Fase del periodo, días {from} a {to}
- Spanish, new: Durante el periodo, días {from} a {to}
home.phaseCard.follicular.day
- English, old: Follicular phase, day {from}
- English, new: After your period, day {from}
- Russian, old: Фолликулярная фаза, день {from}
- Russian, new: После месячных, день {from}
- Spanish, old: Fase folicular, día {from}
- Spanish, new: Después del periodo, día {from}
home.phaseCard.follicular.days
- English, old: Follicular phase, days {from} to {to}
- English, new: After your period, days {from} to {to}
- Russian, old: Фолликулярная фаза, дни с {from} по {to}
- Russian, new: После месячных, дни с {from} по {to}
- Spanish, old: Fase folicular, días {from} a {to}
- Spanish, new: Después del periodo, días {from} a {to}
home.phaseCard.more
- English, old: See what this phase means for you.
- English, new: How you may feel and what may help.
- Russian, unchanged: Что можно чувствовать и как себе помочь.
- Spanish, old: Mira lo que significa esta fase para ti.
- Spanish, new: Cómo puedes sentirte y qué puede ayudar.
home.phaseCard.ovulation.day
- English, old: Ovulation phase, day {from}
- English, new: Around ovulation, day {from}
- Russian, old: Фаза овуляции, день {from}
- Russian, new: В дни овуляции, день {from}
- Spanish, old: Fase de ovulación, día {from}
- Spanish, new: Cerca de la ovulación, día {from}
home.phaseCard.ovulation.days
- English, old: Ovulation phase, days {from} to {to}
- English, new: Around ovulation, days {from} to {to}
- Russian, old: Фаза овуляции, дни с {from} по {to}
- Russian, new: В дни овуляции, дни с {from} по {to}
- Spanish, old: Fase de ovulación, días {from} a {to}
- Spanish, new: Cerca de la ovulación, días {from} a {to}
home.phaseCard.luteal.day
- English, old: Luteal phase, day {from}
- English, new: Before your period, day {from}
- Russian, old: Лютеиновая фаза, день {from}
- Russian, new: Перед месячными, день {from}
- Spanish, old: Fase lútea, día {from}
- Spanish, new: Antes del periodo, día {from}
home.phaseCard.luteal.days
- English, old: Luteal phase, days {from} to {to}
- English, new: Before your period, days {from} to {to}
- Russian, old: Лютеиновая фаза, дни с {from} по {to}
- Russian, new: Перед месячными, дни с {from} по {to}
- Spanish, old: Fase lútea, días {from} a {to}
- Spanish, new: Antes del periodo, días {from} a {to}
log.title.today
- English, new: Entry for today
- Russian, new: Запись за сегодня
- Spanish, new: Registro de hoy
onboarding.today.question
- English, old: You can skip this.
- English, new: Choose all that apply.
- Russian, old: Это можно пропустить.
- Russian, new: Отметьте всё, что подходит.
- Spanish, old: Puedes saltarte esto.
- Spanish, new: Marca todo lo que corresponda.
phase.guide.everyone
- English, new: Everyone is different. If symptoms get in the way of daily life, talk to a doctor.
- Russian, new: Ощущения у всех разные. Если симптомы мешают обычной жизни, обсудите их с врачом.
- Spanish, new: Cada persona es diferente. Si los síntomas afectan a tu día a día, habla con un médico.
phase.guide.follicular.body
- English, old: Energy often rises day by day. Discharge can become easier to notice.
- English, new: Energy often comes back day by day. Discharge can become easier to notice.
- Russian, old: Энергия часто растёт день за днём. Выделения могут стать заметнее.
- Russian, new: Силы часто возвращаются день за днём. Выделения могут стать заметнее.
- Spanish, old: La energía suele subir día a día. El flujo puede notarse más.
- Spanish, new: La energía suele volver día a día. El flujo puede notarse más.
phase.guide.follicular.food
- English, old: Fresh food, protein and fibre help as your energy comes back. Keep regular meals.
- English, new: Fresh food and regular meals can help as your energy comes back.
- Russian, old: Свежая еда, белок и клетчатка помогают, пока возвращается энергия. Ешьте регулярно.
- Russian, new: Свежая еда и регулярное питание могут помочь, пока возвращаются силы.
- Spanish, old: La comida fresca, las proteínas y la fibra ayudan mientras vuelve la energía. Mantén comidas regulares.
- Spanish, new: La comida fresca y las comidas regulares pueden ayudar mientras vuelve la energía.
phase.guide.follicular.mood
- English, old: Many people feel lighter and more curious after the period. A good time to start new things.
- English, new: You may feel lighter after your period. A good time to start something new.
- Russian, old: Многие чувствуют себя легче и любопытнее после месячных. Хорошее время, чтобы начать новое.
- Russian, new: После месячных может стать легче. Хорошее время, чтобы начать что-то новое.
- Spanish, old: Muchas personas se sienten más ligeras y curiosas después del periodo. Un buen momento para empezar cosas nuevas.
- Spanish, new: Puedes sentirte más ligera después del periodo. Un buen momento para empezar algo nuevo.
phase.guide.follicular.training
- English, old: Many people can train harder now. Build up step by step, with a proper warm up.
- English, new: You may feel ready to do more. Build up step by step.
- Russian, old: Многие могут сейчас тренироваться интенсивнее. Наращивайте нагрузку постепенно, с хорошей разминкой.
- Russian, new: Может хотеться больше движения. Увеличивайте нагрузку постепенно.
- Spanish, old: Muchas personas pueden entrenar más fuerte ahora. Aumenta poco a poco, con un buen calentamiento.
- Spanish, new: Puede que tengas ganas de hacer más. Aumenta poco a poco.
phase.guide.food
- English, old: Food
- English, new: Appetite
- Russian, unchanged: Аппетит
- Spanish, old: Comida
- Spanish, new: Apetito
phase.guide.luteal.body
- English, old: Some people notice bloating, tender breasts or changes in their skin before the period.
- English, new: Bloating and tender breasts can occur. Choose comfortable clothes that do not feel tight.
- Russian, old: Некоторые замечают вздутие, чувствительность груди или изменения кожи перед месячными.
- Russian, new: Возможны вздутие и болезненность груди. Выбирайте удобную одежду, которая не давит.
- Spanish, old: Algunas personas notan hinchazón, pechos sensibles o cambios en la piel antes del periodo.
- Spanish, new: Pueden aparecer hinchazón y pechos sensibles. Elige ropa cómoda que no apriete.
phase.guide.luteal.food
- English, old: Cravings are common. Regular meals with whole grains and protein can help you feel steady.
- English, new: You may feel hungrier or crave sweet food. Try to eat regularly.
- Russian, old: Тяга к еде бывает часто. Регулярное питание с цельными злаками и белком помогает чувствовать себя ровнее.
- Russian, new: Может сильнее хотеться есть или тянуть на сладкое. Старайтесь есть регулярно.
- Spanish, old: Los antojos son frecuentes. Las comidas regulares con cereales integrales y proteínas pueden ayudarte a sentirte estable.
- Spanish, new: Puedes tener más hambre o ganas de dulce. Intenta comer con regularidad.
phase.guide.luteal.mood
- English, old: Some people feel calmer, and some feel more sensitive near the end. Leave room in your plans.
- English, new: You may feel irritable or anxious. If you feel overwhelmed, take a break.
- Russian, old: Одни чувствуют себя спокойнее, другие к концу становятся чувствительнее. Оставьте запас в своих планах.
- Russian, new: Может появиться раздражительность или тревога. Если чувствуете перегрузку, сделайте паузу.
- Spanish, old: Algunas personas se sienten más tranquilas, y otras más sensibles hacia el final. Deja espacio en tus planes.
- Spanish, new: Puedes sentirte irritable o ansiosa. Si te sientes desbordada, haz una pausa.
phase.guide.luteal.training
- English, old: Steady, moderate sessions often feel best. Rest more if you feel tired.
- English, new: Go by how you feel. If you are tired, do less or rest.
- Russian, old: Ровные умеренные тренировки обычно даются лучше всего. Отдыхайте больше, если чувствуете усталость.
- Russian, new: Ориентируйтесь на самочувствие. Если устали, снизьте нагрузку или отдохните.
- Spanish, old: Las sesiones constantes y moderadas suelen sentar mejor. Descansa más si te sientes cansada.
- Spanish, new: Guíate por cómo te sientes. Si estás cansada, baja la intensidad o descansa.
phase.guide.open
- English, old: What this phase can mean for you
- English, new: How you may feel and what may help
- Russian, unchanged: Что можно чувствовать и как себе помочь
- Spanish, old: Lo que esta fase puede significar para ti
- Spanish, new: Cómo puedes sentirte y qué puede ayudar
phase.guide.ovulation.food
- English, old: Fresh vegetables, fibre and enough water help as oestrogen peaks. Keep regular meals.
- English, new: Your appetite may change. Try to eat regularly and drink enough water.
- Russian, old: Свежие овощи, клетчатка и достаточно воды помогают на пике эстрогена. Ешьте регулярно.
- Russian, new: Аппетит может меняться. Старайтесь есть регулярно и пить достаточно воды.
- Spanish, old: Las verduras frescas, la fibra y suficiente agua ayudan cuando el estrógeno llega a su punto más alto. Mantén comidas regulares.
- Spanish, new: Tu apetito puede cambiar. Intenta comer con regularidad y beber suficiente agua.
phase.guide.ovulation.mood
- English, old: Many people feel more social and confident now. Plan the talks and the meetings that need energy.
- English, new: You may feel more social and confident. A good time for plans with other people.
- Russian, old: Многие сейчас общительнее и увереннее. Планируйте разговоры и встречи, которым нужна энергия.
- Russian, new: Может хотеться больше общаться, и появляется уверенность. Хорошее время для встреч с людьми.
- Spanish, old: Muchas personas se sienten más sociables y con más confianza ahora. Planea las charlas y las reuniones que piden energía.
- Spanish, new: Puedes sentirte más sociable y con más confianza. Un buen momento para planes con otras personas.
phase.guide.ovulation.training
- English, old: Strength and speed are often at their best. A good time for harder sessions, with a proper warm up.
- English, new: Energy is often high. If you feel strong, try a harder session, with a proper warm up.
- Russian, old: Сила и скорость часто на пике. Хорошее время для более тяжёлых тренировок, с хорошей разминкой.
- Russian, new: Сил часто больше. Если чувствуете себя хорошо, попробуйте нагрузку посильнее, с хорошей разминкой.
- Spanish, old: La fuerza y la velocidad suelen estar en su mejor momento. Un buen momento para sesiones más duras, con un buen calentamiento.
- Spanish, new: La energía suele estar alta. Si te sientes con fuerza, prueba una sesión más intensa, con un buen calentamiento.
phase.guide.period.body
- English, old: Cramps, a sore lower back or tiredness are common. Rest when you need it.
- English, new: Cramps, a sore lower back or tiredness can occur. Warmth and rest can help.
- Russian, old: Спазмы, боль в пояснице или усталость бывают часто. Отдыхайте, когда нужно.
- Russian, new: Возможны боль внизу живота, боль в пояснице или усталость. Могут помочь тепло и отдых.
- Spanish, old: Los cólicos, el dolor en la parte baja de la espalda o el cansancio son frecuentes. Descansa cuando lo necesites.
- Spanish, new: Pueden aparecer cólicos, dolor en la parte baja de la espalda o cansancio. El calor y el descanso pueden ayudar.
phase.guide.period.food
- English, old: Warm, regular meals and enough water can help you feel steady.
- English, new: Your appetite may change. Warm food, regular meals and enough water can help.
- Russian, old: Тёплая регулярная еда и достаточно воды помогают чувствовать себя ровнее.
- Russian, new: Аппетит может меняться. Могут помочь тёплая еда, регулярное питание и достаточно воды.
- Spanish, old: Las comidas calientes y regulares y suficiente agua pueden ayudarte a sentirte estable.
- Spanish, new: Tu apetito puede cambiar. La comida caliente, las comidas regulares y suficiente agua pueden ayudar.
phase.guide.period.mood
- English, old: Some people feel tired or low on the first days. Plan a quieter day where you can.
- English, new: You may feel tired or low on the first days. Plan a quieter day if you can.
- Russian, old: Некоторые в первые дни чувствуют усталость или упадок настроения. По возможности планируйте день поспокойнее.
- Russian, new: В первые дни может быть усталость или упадок настроения. По возможности планируйте день поспокойнее.
- Spanish, old: Algunas personas se sienten cansadas o bajas de ánimo los primeros días. Planea un día más tranquilo cuando puedas.
- Spanish, new: Puedes sentirte cansada o con el ánimo bajo los primeros días. Si puedes, planea un día más tranquilo.
phase.guide.period.training
- English, old: Gentle movement, such as walking or stretching, often feels best. Do what feels right.
- English, new: Go by how you feel. A gentle walk or stretching often feels good.
- Russian, old: Мягкое движение, например прогулка или растяжка, обычно даётся лучше всего. Делайте то, что подходит вам.
- Russian, new: Ориентируйтесь на самочувствие. Спокойная прогулка или растяжка обычно даются легко.
- Spanish, old: El movimiento suave, como caminar o estirarse, suele sentar mejor. Haz lo que te siente bien.
- Spanish, new: Guíate por cómo te sientes. Un paseo tranquilo o estirarte suele sentar bien.
phase.guide.title.follicular
- English, new: After your period: what may help
- Russian, new: После месячных: что может помочь
- Spanish, new: Después del periodo: qué puede ayudar
phase.guide.title.luteal
- English, new: Before your period: what may help
- Russian, new: Перед месячными: что может помочь
- Spanish, new: Antes del periodo: qué puede ayudar
phase.guide.title.ovulation
- English, new: Around ovulation: what may help
- Russian, new: В дни овуляции: что может помочь
- Spanish, new: Cerca de la ovulación: qué puede ayudar
phase.guide.title.period
- English, new: During your period: what may help
- Russian, new: Во время месячных: что может помочь
- Spanish, new: Durante el periodo: qué puede ayudar
phase.guide.training
- English, old: Training
- English, new: Movement
- Russian, unchanged: Движение
- Spanish, old: Entrenamiento
- Spanish, new: Movimiento
phase.past.heading.waiting
- English, new: Your observations will appear here
- Russian, new: Здесь появятся ваши наблюдения
- Spanish, new: Aquí aparecerán tus observaciones

Decisions.

The tips are general wellbeing. Each tip has at most two sentences and no number. No tip names a hormone, a medicine or a contraceptive. The old ovulation food line said "as oestrogen peaks". I removed it, because nothing in the app measures it. A new copy test holds the two sentence limit and the absence of numbers in all three languages.
The line that everyone is different says "talk to a doctor". That is a safety line, not advice. The claims gate passes it: «с врачом» does not hit «одобрено врачом», and «médico» does not hit «dispositivo médico».
The ovulation body tip keeps its words in all three languages. It already says where the pain is, and test painOnOneSideInRussian pins it.
The area names follow Step 24 in English and Spanish: Food becomes Appetite, and Training becomes Movement. The phaseGuide board says Food and Training. This is a change of words only.
The guide label over the title is now the scientific name of the phase, for example LUTEAL PHASE, without the days. The phaseGuide board puts the days there. The title now names the phase in plain words, so a label with the plain name and the days would say the same thing twice. The days stay on the page under the guide and on the Home card.
The board note "Draft copy. A specialist must review it before it ships." is a designer note, so it does not ship.
The Home card title names the phase in plain words for all four phases: During your period, After your period, Around ovulation, Before your period. Polina asked for this on the luteal card. I did all four, so the card always says one kind of thing.
The middle of the ring now uses the full name, for example "Luteal phase" («Лютеиновая фаза»), from the keys phase.name.. The todayLuteal board draws "Luteal phase" there. The names along the arcs keep the short keys cycle.phaseName., because the arc test pins «Фолликулярная» and the arc has no room. So cycle.phaseName.luteal does not change.
The Home card adds «Фаза определена приблизительно.» ("This phase is an estimate."). This is true: the app works the phase out from her lengths and her logged days, and it measures nothing.
Not done: the ring caption. Polina asked to remove «из примерно 27» and to write «27-й день цикла». The approved todayPhases board draws the caption "of about 33", and contract 22.8 holds it. The canvas wins, so the board must change first.
Not done: «Головная боль» for log.group.head. The Head group holds headache, migraine, brain fog, forgetfulness, poor concentration and sensitivity to light and sound. «Головная боль» would be false for six of the eight. The group keeps «Голова» and "Head".
«Запись за сегодня» is a new key, log.title.today ("Entry for today"), for the title of the day entry. calendar.today stays "Today" for the calendar and the first run.
onboarding.today.question becomes "Choose all that apply." in all three languages. The Skip button keeps the way past the question.
The empty heading of the past phases section becomes "Your observations will appear here" while no cycle is complete. With a complete cycle, the heading stays "In your past luteal phases".
Changed contracts: the ring middle tests (todayPhasesOnTheRing, 3.6, 9.2, 9.4, 15.3, 22.8, thePhaseRule and the behaviour steps of feature 2) now read the full phase name. The card tests read the plain names and the estimate line. 11.9 reads the new question and proves the old one is gone. The guide test proves the old title and the oestrogen line are gone. Scenario SCREEN-2 in feature 2 now presses "How you may feel and what may help" and checks the line that everyone is different.
No board exists for the day entry title or the empty heading, so they keep the existing look.

Checks.

make check: patches, format, lint, typecheck, documents, brand, reference, sheet, features, story, pictures and mockups pass. Workspace tests 124 of 124 and 1862 of 1862. Mobile tests 3620 of 3621. The one failure is test 10.7, the known local noise: the ~/.npmrc on this Mac prints "always-auth" and "email" warnings into the generator output. The lint step prints two warnings in exportScreen.picture.tsx, which this change does not touch.
npm run test:behaviour: 93 of 93 pass.
New tests: the guide title for each phase, the line that everyone is different, the empty heading, the entry title, the card without the scientific name, and tests/copy/phaseGuideTips.test.ts in three languages.
Mutation check: I made guideTitle return the old title. Five tests went red. I restored the file from a copy and the five went green.
I regenerated four brand pictures (onboarding, home screen, trend, patterns), because their words changed.
grep -c itvrepos package-lock.json prints 0.

…ifferent

# Conflicts: # apps/mobile/src/app/(tabs)/log/index.tsx # apps/mobile/src/language/russian.ts # apps/mobile/tests/fixtures/theFirstRunLook.tsx # brand/screens/onboarding.html # brand/screens/onboarding.png

EMI: feat: give the phase guide short tips and say that everyone is d…

e7d019d

…ifferent

juliantellez self-assigned this Oct 20, 2026

Base automatically changed from emi-fix-russian-home-day-entry-phase to main October 20, 2026 04:11

Merge remote-tracking branch 'origin/main' into HEAD

806b9db

# Conflicts: # apps/mobile/src/app/(tabs)/log/index.tsx # apps/mobile/src/language/russian.ts # apps/mobile/tests/fixtures/theFirstRunLook.tsx # brand/screens/onboarding.html # brand/screens/onboarding.png

juliantellez merged commit de8c4ed into main Oct 21, 2026
1 check passed

juliantellez deleted the emi-feat-phase-guide-tips branch October 21, 2026 17:36

Navigation Menu

Repository navigation

EMI: feat: give the phase guide short tips and say that everyone is different - #368

EMI: feat: give the phase guide short tips and say that everyone is different#368
juliantellez merged 2 commits into
mainfrom
emi-feat-phase-guide-tips

juliantellez commented Oct 20, 2026

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

1 participant

Conversation

juliantellez commented Oct 20, 2026

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

1 participant