# VERA — The Complete Manual

*Veste Health · founder reference · 2026-04-27*

This is the single source of truth for what VERA is, who she's for, what she does, and how to take her to market. Read top-to-bottom to build the full mental model. Jump to Section 6 for a tab-by-tab walkthrough. Jump to Sections 9–10 for marketing.

---

## 1. Executive Summary

**VERA is a specialist in you.** She is an evidence-based health agent built by Veste Health. She listens, remembers, and notices patterns across everything a person shares with her — sleep, food, movement, labs, symptoms, mood, connection, the body. She turns that into plain-English insight grounded in institutional science, and she does it in a voice that is warm, specific, and honest.

Most health apps are libraries. They show you charts and leave you to interpret them. VERA is the opposite — she reads the library *for* you. She is not a generalist wellness coach. She is not a fitness tracker. She is the one voice in your day who is paying attention to *your* pattern, citing real sources, and telling you what she sees.

The hook: **"She noticed before I did."** — `#SheNoticedBeforeIDid`

---

## 2. Brand Foundations

### 2.1 Name

- **Full name:** V.E.R.A. — **V**este **E**vidence-based **R**esponse **A**gent
- **Display name:** VERA
- **Brand line:** "Vera means Truth."

**Brand treatment rule:** On brand surfaces (landing page, splash, about, marketing, decks), always introduce with the full V.E.R.A. + expansion + "Vera means Truth." line together. In body copy and UI, use "VERA."

### 2.2 Voice

VERA speaks in the first person: **I, me, my.** Never "we / us / our." Plural voice is reserved for Veste Health brand and legal copy (Privacy Policy, Terms, About Veste).

### 2.3 Tone Principles

1. **Warm, not clinical.** Specific, not generic. Short, not monologuing.
2. **Specialist in YOU, not a generalist.** She answers for this person's situation — not for "users."
3. **Evidence-based.** Every factual claim cites an institutional source (AHA, CDC, NIH, USPSTF, Mayo Clinic, ACSM, AASM, JAMA, peer-reviewed journals). Never "research shows" / "studies suggest" — those are banned phrases.
4. **No personalities.** Individual health personalities (Attia, Huberman, Patrick, Schoenfeld, Sinclair, Mercola, etc.) are forbidden as sources.
5. **No clock commentary.** VERA does not unsolicited-nag about "it's late" or "you're up early." The clock is ambient, not a scold.
6. **No forced nudges.** A clean close is better than a tacked-on follow-up question. She can just answer.
7. **Respect for tense.** If a surgery is 7 days out, she says "7 days from now" — not "getting close."

### 2.4 Color Palette

| Role | Hex | Usage |
|---|---|---|
| Deep navy | `#1E2B6E` | Primary brand, text accents, CTA hover |
| Gold | `#F5C518` | Accent, highlights, CTA buttons |
| Sage teal | `#4A7C6F` | Secondary accent, section dividers |
| Cream | `#FAFAF8` | Background, card fills |

VERA is **not green.** She is navy + gold + sage. Cream background, never stark white.

### 2.5 The Crystal

The VERA crystal is the visual symbol of her presence. Currently a rendered GIF asset in the app. It's also the planned form factor for the future hardware device (see Section 12).

---

## 3. Who VERA Is (Positioning)

### 3.1 Core Tenant

> **VERA is a SPECIALIST in YOU, not a generalist.**
>
> She knows you from what you say and what your body says. She is not a search engine, not a chatbot, not a coach-in-general. She is the one voice that reads *your* signals across time.

This is the non-negotiable center of the brand. Every feature either deepens her specialization in the individual or it doesn't ship.

### 3.2 What VERA Is Not

- Not a diagnostic tool. She informs, she prepares you for your doctor, she does not replace them.
- Not a fitness app. Fitness is one domain she watches, not the product.
- Not a generalist wellness coach. She doesn't "motivate." She notices.
- Not a social network. Community & Connection is a metric she watches, not a feed.
- Not a pharmacy or supplement store. She logs what you take and reads it against peer-reviewed evidence.

### 3.3 Safety & Boundaries

- **Crisis detection** runs client-side on every user utterance across chat, free notes, quest entries, voice, food logs, symptom logs, and concerns. If VERA detects a crisis signal, she surfaces 988 Suicide & Crisis Lifeline and emergency services.
- **FDA stance:** VERA is an informational and organizational tool. She does not diagnose, treat, cure, or prevent disease. Disclosure is shown at signup and acknowledged before use.
- **Data:** User data is not sold, not shared with advertisers, not used to train third-party AI. Only the user can read their data. A full wipe from Settings is always available.

---

## 4. Who VERA Is For

### 4.1 Target User

Adults (18+) who are actively engaged in their health and want a single intelligent presence that:
- Understands their history and goals over time
- Reads labs, symptoms, habits, supplements, and sleep together — not in silos
- Prepares them for doctor visits
- Tells them the truth, with sources

### 4.2 Primary Use Cases

1. **The Pattern Reader.** "My energy has been off for two weeks. What's changed?" VERA cross-references sleep, hydration, nutrition, stress, cycle, and recent labs to identify candidate drivers.
2. **The Doctor Prep.** Before an appointment, VERA generates a one-page summary of trends, symptoms, and questions to ask — printable or shareable.
3. **The Daily Check-In.** One card on the dashboard, one modal, mood + energy + sleep + stress + water + notes. Thirty seconds a day. VERA learns from it.
4. **The Lab Translator.** Upload or log a lab value. VERA explains it plainly, cites the reference range and source, and flags whether it's part of a pattern.
5. **The Supplement Auditor.** Log what you take. VERA reads it against peer-reviewed evidence — what's supported, what's thin, what's interacting.
6. **The Symptom Tracker.** Short, structured symptom logs that build a timeline VERA can reason over.
7. **The Planner.** "Plan Ahead" tab — VERA builds today's meal suggestion, a weekly meal prep, today's workout, or a weekly exercise plan, personalized to goals, macros, and recent history.

### 4.3 Plans & Tiers

- **Free trial:** 15 days. Full access.
- **Monthly:** $19.99 / month
- **Annual:** $149.99 / year (≈ 37% savings)
- **Family plan:** Deferred. Not at launch.

Prices are being tested for 60 days post-launch and may adjust.

---

## 5. What VERA Does — Full Feature Catalog

The app has **five primary views** (sidebar nav): Chat, Dashboard, My Health, Insights & Tools, Settings. Plus a pre-auth "Learn More About VERA" splash.

### 5.1 Chat

The front door. A conversation with VERA that remembers.

- **Chat-first onboarding on Day 1.** New signups land in chat, not dashboard. VERA introduces herself, reassures about privacy, and asks three orienting questions (sleep last night, how you're feeling, what you hope to see in two weeks). No modals, no tour, no pop-ups on Day 1.
- **Voice** — click to hear VERA speak any reply (OpenAI TTS nova, streaming so playback starts within ~100ms of the first chunk).
- **Voice input** — microphone icon transcribes what you say and sends it as a message.
- **Tool use** — when you say "I drank 2 cups of water" or "I had scrambled eggs for breakfast," VERA silently logs it via her tool set. You see a small confirmation attached to her reply. The dashboard tile updates.
- **Available logging tools:** `log_food`, `log_water`, `log_symptom`, `log_workout`, `log_sleep`, `log_weight`, `log_blood_pressure`, `log_connection`, `log_meditation`, `log_body_comp`.
- **Memory** — Deep Memory (knowledge about the person — goals, conditions, upcoming events, preferences) is rendered with *[mentioned N ago]* tags so VERA respects tense and never asks about a trip as if it already happened.
- **Synthesis** — every week, VERA writes a weekly synthesis. Monthly, she writes an "About You" report. Both accessible in Insights & Tools → Reports.

### 5.2 Dashboard

The at-a-glance daily view. Top to bottom:

**A — Crystal + greeting (hero).** Centered VERA crystal, "Good morning, [name]," intention line, "Tap to talk with me →".

**B — VERA Score banner** (when ≥2 components have data). Today's score 0–100 against the user's *own* 14-day baseline. Plain-language takeaway underneath: top + bottom component ("Your sleep was strong. Movement light — easy to fix today."). During the first two weeks shows "Calibrating: X of 14 days." Marketing line: **"VERA scores you against you."**

**C — "Complete your profile" CTA banner** (only when critical Health Profile fields missing). Lists what's missing with a count: *"3 fields to add: biological sex, age, nicotine status · powers your scores"*. Tap → jumps to Settings → Health Profile.

**D — Daily Check-In card** (gold-bordered, prominent). Opens a modal with mood, energy, sleep, stress, water, and notes. One form, thirty seconds.

**E — Today's Vitals tiles** (8 tiles, each tappable to open the matching metric detail panel in My Health):

1. **Sleep** — hours + quality (AASM 2015)
2. **Heart** — resting HR, HRV, BP, **Cardio Fitness (VO2 max)** (AHA Scientific Statement, Ross et al. 2016)
3. **Movement** — steps, minutes, workouts (Lee et al. JAMA Internal Medicine 2019)
4. **Body** — weight, body composition, **Metabolic Age** (NIH NHLBI; Mifflin 1990; WHO/FAO 2001)
5. **Metabolic & Nutrition** — calories, macros, **Diet Quality (weekly self-rating)**, hydration (ADA 2024 + USDA Dietary Guidelines)
6. **Mindfulness** — mood, meditation, stress (NIH NCCIH)
7. **Cycle & Hormonal** — cycle status + 5 symptom sliders (NAMS, ACOG)
8. **Community** — daily social/community touchpoints (US Surgeon General Advisory 2023)

Each tile has: current value, status color, "+Log" entry, voice/chat option, and on combined tiles a deep-link to the original feature (e.g., Metabolic & Nutrition → "Open Food Tracker," Heart → "Lab results →", Mindfulness → "Mood trend →").

**F — Quest & Habits row** (below Vitals, intentional ordering — vitals first, gamification second). Vera Quest tile + Habit Streak tile side by side.

**G — Health Connect tiles, Recent Activity, Devices widget.** Devices widget is passive — never auto-pops. Connection always available, never forced.

**Daily Intention** — fires once per day at sign-in for returning users (not Day 1). If set, VERA weaves it into her greeting. Skip is remembered for the day. A small "Today" link in the sidebar reopens the intention modal so you can revisit today's reflection any time.

**Greeting on first gesture (autoplay safety net).** Chrome blocks audio autoplay until the user interacts with the page. VERA arms a one-shot listener — if the greeting didn't speak on load, the first click/tap/keypress triggers it automatically. The listener self-removes once VERA speaks.

### 5.3 My Health

The metric detail view. Opens to the same 8 tiles as the dashboard. Top of the page also shows two summary cards:

- **Metabolic Age card** — Mifflin–St Jeor BMR (or Katch–McArdle when body fat % available) reverse-looked-up against sex-matched population reference body across ages 18–80. Empty state has an "Open Health Profile →" jump.
- **Vitality Score card** — monthly score, AHA Life's Essential 8 + cardiorespiratory enhancement (10 components, see §5.3.1).

Tap any tile → metric detail panel with:

- **Explainer text** at the top of every detail panel — one paragraph + institutional citation (AASM, AHA, NIH, USDA, NAMS, etc.) so the user always knows *why this metric matters and where the science comes from*.
- Current reading + status
- History chart
- Trends
- Associated logs
- "+Log" and voice-log entry points
- Combined-tile deep links (preserve every legacy feature):
  - **Metabolic & Nutrition** → Diet Quality form, Open Food Tracker, Log water, Nutrition trend, Hydration trend
  - **Heart** → Cardio Fitness (VO2 max) section, Log/view BP, Lab results
  - **Mindfulness** → Log mood/meditation, Mood trend
- Tile-level "add this data" reminders next to "No data yet" entries — route to Daily check-in / Pair wearable / Log workout / Open Health Profile / Add lab result / Take walk test, depending on the missing component.

#### 5.3.1 Vitality Score (monthly, AHA Life's Essential 8 + cardiorespiratory)

10 components, weighted by mortality evidence:

| Component | Weight | Source |
|---|---|---|
| Physical activity | 10% | Lloyd-Jones 2022 (Circulation) |
| Diet (weekly self-rating) | 10% | Lloyd-Jones 2022 |
| Nicotine status | 10% | Lloyd-Jones 2022 |
| Sleep (chronic) | 10% | Lloyd-Jones 2022 |
| BMI | 10% | NHLBI categories |
| Lipids (non-HDL) | 10% | Lloyd-Jones 2022 |
| Glucose (HbA1c) | 10% | Lloyd-Jones 2022 |
| Blood pressure | 10% | AHA/ACC Whelton 2017 |
| **VO2 max** | **15%** | Mandsager 2018 (JAMA Network Open) |
| **Resting HR** | **5%** | Jensen 2013, Aladin 2014 |

Score is calculated against population norms — different from the daily VERA Score (which is against the user's own baseline). Coverage transparency: shown as "based on N of 10 components" so the user knows when the score is thin vs. complete.

#### 5.3.2 VERA Score (daily, adaptive personal baselines) — the product moat

**Scored against the user's own 14-day rolling baseline, not population norms.** This is the differentiator. Most apps tell you how you compare to a 35-year-old in Bend, Oregon. VERA tells you how you compare to *you, last week*.

6 components, literature-anchored weights:

| Component | Weight | Source |
|---|---|---|
| Sleep | 25% | AASM 2015 + Cappuccio 2010 |
| HRV | 25% | Buchheit 2014 (absorbs device "stress score") |
| Resting HR | 15% | Jensen 2013 |
| Movement | 15% | Lee 2019, Paluch 2022 |
| Mood | 10% | Steptoe 2015 |
| Hydration | 10% | Maughan & Shirreffs 2010 |

Z-score normalization against the 14-day baseline. Higher-is-better components: score = 50 + z×25. Lower-is-better: 50 − z×25.

**RHR baseline note.** VERA derives RHR from the *bottom-tertile mean* of each day's HR samples (the lowest ~33% of readings) — same approach Apple/Garmin use when device data isn't tagged. This avoids workouts pulling the baseline up.

**Calibration phase.** During the first 14 days, the banner says "Calibrating: X of 14 days." The detail panel shows a gold callout: *"Your score becomes more accurate as your personal baseline emerges. Most users reach a stable baseline in about two weeks."* The calibration indicator drops after day 14.

#### 5.3.3 Cardio Fitness (VO2 max) — three-path

Lives under the Heart tile. VERA picks the best available source in priority order:

1. **Wearable import** via Health Connect (`vo2max` or `cardioFitness` data type)
2. **Rockport 1-Mile Walk Test** — guided in-app: intro → walk timer → finish → enter end HR → result. Formula from Kline 1987: `VO2 = 132.853 − (0.0769 × weight_lbs) − (0.3877 × age) + (6.315 × sex[1=M, 0=F]) − (3.2649 × walk_min) − (0.1565 × end_HR)`. ±10% accuracy, validated 30–69.
3. **Manual entry** via the existing Fitness Benchmarks form (cited as "User-reported (likely from a lab test or wearable)")
4. **Uth non-exercise estimate**: `VO2max ≈ 15.3 × (HRmax / RHR)` where `HRmax = 208 − 0.7×age` (Tanaka 2001). Lowest priority — used only when nothing else is present.

Categories from FRIEND population norms (Kaminsky et al. 2019), age decade × sex.

Citations on every reading: Mandsager 2018 (JAMA Network Open); Ross et al. AHA 2016; Kaminsky 2019; Uth 2004 (Eur J Appl Physiol); Tanaka 2001; Kline 1987.

#### 5.3.4 Diet Quality (weekly self-rating)

5 questions, simplified Mediterranean / DASH adherence. Each answered 0–4 (Not at all → Every day). Sum × 5 = 0–100.

1. Vegetables — 3+ servings/day
2. Whole grains over refined
3. Fish or plant proteins (legumes/nuts)
4. Limited added sugar / processed foods
5. Mediterranean / whole-foods pattern overall

Stored in `state.dietRatings` as weekly entries. Feeds the Vitality Score's 10% diet weight (which was previously always null). Citations: AHA Life's Essential 8 (Lloyd-Jones 2022); USDA Dietary Guidelines.

#### 5.3.5 Cycle & Hormonal (women's-health tile)

For the 40–65 audience and anyone who wants symptom tracking through a cycle/menopause lens.

**Status options:** Regular cycles · Irregular cycles · Perimenopause · Menopause · Post-menopause · Pregnant or postpartum · Not applicable.

**5 symptom sliders (0–10):** 🔥 Hot flashes · 💧 Night sweats · 😴 Sleep disruption · 🌊 Mood changes · 🌫️ Brain fog.

Setup screen → main panel → daily symptom log. Today's symptoms render as colored bars (red ≥7, gold ≥4, sage <4). Last 7 days summary surfaces notable symptom icons. Tile shows status when nothing logged today, "N symptoms today" once logged.

Stored in `state.cycleLogs` (array of daily entries) + `STORE.get('cycleStatus')`.

Citations: NAMS (North American Menopause Society); ACOG.

### 5.4 Insights & Tools

Seven tabs (5 synthesis/tool tabs + 2 domain tabs):

1. **📊 Reports** — Weekly Report, Monthly "About You" synthesis. Archive of all past reports.
2. **🗓️ Plan Ahead** — VERA builds:
   - Today's Meal Suggestion (around remaining macros)
   - Weekly Meal Prep Plan
   - Today's Workout Suggestion (Zone 2, VO2 max, strength, balance — age-appropriate)
   - Weekly Exercise Plan
3. **💊 Supplements** — log what you take, VERA audits against peer-reviewed evidence.
4. **🧪 Labs** — upload or log lab values; VERA explains and flags patterns.
5. **🤕 Symptoms** — structured symptom log with timeline view.
6. **🩺 Doctor Prep** — one-page summary before an appointment.
7. **📤 Share** — export or share reports with your doctor (or anyone you choose).

### 5.5 Settings

- **Profile** — name, age, focus areas, typical bedtime, typical wake time
- **Health Profile** *(powers VERA Score, Vitality Score, Metabolic Age)* — biological sex, age, height (ft + in), weight (lbs), body fat % (optional), nicotine status (Never / Former / Current). Body fat % is also saved as a fresh `bodyComp` entry. Footer cites Mifflin 1990, WHO/FAO 2001, Lloyd-Jones 2022, Kline 1987.
- **Subscription** — manage trial / monthly / annual, Stripe-managed
- **Devices** — connect / disconnect integrations
- **About VERA** — the "Learn More About VERA" content, accessible anytime from Settings
- **Data controls** — export all data, wipe everything
- **Voice settings** — toggle VERA's voice on/off, choose voice
- **Notifications** — email preferences, in-app prompts

### 5.6 VERA Quest (Gamification — Under Review)

- 5 XP levels: Bronze → Silver → Gold → Platinum → Diamond
- ~12 badges (7-day streak, Lab Warrior, Sleep Champion, etc.)
- Daily quests auto-generated per focus area
- Auto-complete triggers on real thresholds (10k steps, sleep goal, etc.)
- Compass FAB (floating action button, bottom right) opens Quest

Status: Built, present. Pending founder review on whether it ships MVP, post-launch, or redesigns first (see Roadmap in Section 12).

### 5.7 Pre-Auth Surface: "Learn More About VERA"

Splash page between Landing and Auth. Meet-the-specialist framing. ~30s intro voice pre-rendered as static MP3 (instant playback). "Want more info?" gold CTA on landing.

---

## 6. Step-By-Step Usage

### 6.1 First-Time Signup (Day 1 Flow)

1. Open **https://vera.vestehealth.com**
2. Enter gate code **`Vera2026`** (gate stays up until trademark is filed)
3. Tap **"Get Started"** on landing
4. (Optional) tap **"Learn More About VERA"** for the ~30s intro
5. Tap **"Sign Up"** → enter email + password
6. Complete the wizard:
   - Step 1: name, age
   - Step 2: focus areas (what you care about most), typical bedtime, typical wake time
7. Acknowledge the health disclaimer
8. You land in **Chat**
9. VERA introduces herself
10. She asks three orienting questions. Answer in your own words.
11. After the third answer, normal chat opens

**What Day 1 intentionally does NOT do:** no device-connect modal, no daily intention prompt, no guided tour. Just talking.

### 6.2 Returning-User Daily Flow

1. Open the app
2. Daily Intention modal appears — set it, or skip
3. You land on Dashboard
4. Tap the **Daily Check-In** card → 30-second form → Save
5. Tiles update. Glance. Move on.
6. Anything notable? Tap the tile → detail panel → log or read trend.
7. Anything unclear? Tap the **Chat** icon in sidebar → ask VERA.
8. Want a plan? Sidebar → **Insights & Tools** → Plan Ahead → pick a button.

### 6.3 Logging a Meal (3 ways)

**Way 1 — by chat:** Type "I had scrambled eggs and toast for breakfast." VERA reads it, logs it, replies naturally. Calories tile updates.

**Way 2 — by tile:** Dashboard → Nutrition tile → "+Log" → enter meal → save.

**Way 3 — Food Tracker:** Dashboard → Nutrition tile → "Open Food Tracker" → full meal view with macro breakdown.

### 6.4 Logging Water

- Chat: "I just drank 2 cups of water" — VERA adds 2 cups to today's total.
- Tile: Dashboard → Hydration → "+Log" → bubble picker.

### 6.5 Logging Sleep

- Chat: "I slept 7 hours, felt rested" — VERA logs hours + quality.
- Tile: Dashboard → Sleep → "+Log" → hours + 1–5 quality selector.
- Auto: Samsung Galaxy Watch / Apple Health / Health Connect can auto-populate if connected.

### 6.6 Reading a Lab

1. Sidebar → **Insights & Tools** → 🧪 **Labs** tab
2. "+Log Lab" → enter value + unit + date, or upload a photo/PDF
3. VERA explains the value, cites the reference range source, flags if part of a pattern.

### 6.7 Prepping for a Doctor Visit

1. Sidebar → **Insights & Tools** → 🩺 **Doctor Prep** tab
2. Tap "Generate for [appointment type]"
3. VERA produces a one-page summary: recent trends, symptoms, questions to ask, current supplements/meds
4. Switch to **📤 Share** tab to export or send

### 6.8 Getting a Weekly Summary

- Sidebar → **Insights & Tools** → **📊 Reports** → tap **"Weekly Report"** button
- VERA generates a full synthesis: patterns she noticed, what's working, what's shifting, one thing to try next week.
- Archive below shows every prior weekly + monthly "About You" report.

### 6.9 Connecting Health Connect (mobile)

VERA reads from Android's Health Connect to auto-populate metrics from your wearable (Galaxy Watch, smart scale, BP cuff, CGM, etc.) into the Dashboard, My Health tiles, and the VERA + Vitality Scores.

**One-time setup, on the phone:**
1. Open VERA → Settings → Devices → tap **"Connect Health Connect"**
2. Android prompts you to grant 22 permission types — tap **Allow all** (or grant each individually). VERA needs every type to fill every score and tile correctly.
3. After grant, VERA auto-syncs immediately, then on every app launch, then on app-resume from background (throttled to once per 30 minutes to avoid hammering Health Connect).

**Two important things to know:**

- **After installing a new APK build that adds new metric types, Health Connect re-prompts for permissions.** If you don't see the new metrics on Dashboard / My Health after install, check Settings → Health Connect → confirm all 22 types are toggled on. Skipped permissions silently return empty — no error, just blank tiles.
- **The first sync after Connect pulls only the last 7 days of history.** If you've had Health Connect collecting data for months, the older data stays in Health Connect — VERA's calibration baselines (14 days for the daily VERA Score) build over the next 1-2 weeks of use.

**Data types VERA reads from Health Connect (24 total):**
Steps, distance, active calories, total calories, basal metabolic rate, heart rate, resting heart rate, heart-rate variability, oxygen saturation (SpO2), respiratory rate, body temperature, basal body temperature, sleep duration, weight, body fat %, height, blood pressure, blood glucose, flights climbed, distance cycling, mindfulness minutes, workouts, **VO2 max**, **hydration**.

**About the VO2 max and hydration bridges:** the upstream `@capgo/capacitor-health` plugin (v8.4.5) didn't expose Health Connect's `Vo2MaxRecord` or `HydrationRecord`. We patched the plugin in-place (2026-04-27) to add both. Patches live in `vera-android/node_modules/@capgo/capacitor-health/android/src/main/java/...` — they need re-applying after any `npm install` that overwrites node_modules. (Future work: file upstream PR or move to a `patch-package` workflow.)

---

## 7. Technical Foundation (Founder Reference)

*Skip if non-technical; included because Frederica asked for "everything."*

- **Web app:** Cloudflare Pages. Live at `https://vera.vestehealth.com`. Gate code `Vera2026` until trademark filed.
- **Mobile:** Android APK built via Capacitor, delivered via Google Drive (see install steps at top of this session). iOS: post-launch.
- **Backend:** Supabase — Postgres (16 tables with RLS), Auth (email), Storage (lab uploads, audio), Edge Functions.
- **Edge Functions:**
  - `vera-ai-proxy` — the brain. All Anthropic API calls go through it. System prompts live here (server-side for IP protection).
  - `vera-voice` — OpenAI TTS nova streaming.
  - `vera-unsubscribe` — HMAC-signed one-click email unsub (RFC 8058).
  - `welcome-email`, `daily-digest` — email lifecycle.
- **AI models (3-model hybrid):**
  - Opus 4.7 — complex analysis, monthly synthesis
  - Sonnet 4.6 — daily chat, weekly synthesis, vision (lab uploads)
  - Haiku 4.5 — simple tasks, tool-use calls
- **Payments:** Stripe (currently test mode; live cutover is a pre-launch step).
- **Email:** Resend.
- **Design assets:** `app/index.html` is the single-file app (~16K lines, pending Sprint H split).

### Key URLs / Paths
- Project root: `C:\Users\richa\vera-project`
- App: `app/index.html`
- Edge Functions: `supabase/functions/`
- APK output: `vera-android/android/app/build/outputs/apk/debug/app-debug.apk`
- Deploy scripts: `deploy-web.cmd`, `build-apk.cmd`, `copy-ai-proxy-function.cmd`

---

## 8. Data & Privacy Promise (Marketing-Ready)

> *I don't sell your data. I don't share it with advertisers. I don't use it to train any AI. Only you can read your data. You can wipe it from Settings, anytime.*

This is the literal copy used in VERA's intro. It's accurate, it's defensible, and it's the line that differentiates Veste Health from every adtech-funded health app.

---

## 9. How to Market VERA

### 9.1 Positioning

**Category:** Personal Health Intelligence (new category).

**Positioning statement:**
> For adults who want to actually understand their own health, VERA is the AI specialist who knows you — who listens, remembers, and reads your sleep, food, labs, and symptoms together so you can see the pattern before it becomes a problem. Unlike generalist wellness apps and siloed trackers, VERA is your single, evidence-based voice — grounded in institutional science, not influencers.

### 9.2 The Hook

> **"She noticed before I did."**
> `#SheNoticedBeforeIDid`

This is the one line that carries the whole brand. It's a user testimony shape (implied social proof), it's specific, it's emotional, it does the positioning work in five words.

### 9.3 Supporting Messages (Locked)

Use these verbatim or adapted, never diluted:
- **"Vera means Truth."**
- **"A specialist in you."**
- **"She knows you from what you say and what your body says."**
- **"Evidence-based. Personal. Honest."**
- **"Every claim, a real source. Never an influencer."**
- **"VERA isn't an app you download. She's a presence you invite into your life. The phone is just where she clocks in first."** *(Adopted 2026-04-24. Use this when the audience needs to understand what VERA* is *— a relationship, not a tool. Pairs with the hook "She noticed before I did.")*

### 9.4 Proof Points

- Cites institutional sources (AHA, CDC, NIH, USPSTF, Mayo, ACSM, AASM, JAMA)
- Three-model AI (Opus for depth, Sonnet for daily, Haiku for speed)
- Chat + voice + dashboard + labs + supplements + doctor prep — one place
- Privacy: data not sold, not shared, not used to train AI
- Built by Veste Health

### 9.5 Competitive Frame

| Category | Example | Why VERA is different |
|---|---|---|
| Fitness trackers | Whoop, Oura, Fitbit | They show data. VERA reads it for you. |
| Symptom checkers | WebMD, Ada | Generic answers. VERA answers for your pattern. |
| Wellness coaches | Noom, Lifesum | Generalist programs. VERA is specialist in you. |
| AI chatbots | ChatGPT health | No memory, no logging, no sources. VERA cites and remembers. |
| Lab readers | InsideTracker | Labs only. VERA reads labs against your full life. |

### 9.6 What We Don't Say

- Don't claim diagnosis, cure, or treatment.
- Don't cite individual health personalities.
- Don't say "research shows" or "studies suggest" — cite the institution.
- Don't use "we" in VERA's voice. "We" is Veste Health as a company.
- Don't name the founder or family in marketing copy. "Veste Health" is the named entity.

---

## 10. Where to Market VERA

### 10.1 Beta (Now → Launch)

- **Friends & family beta** — 3–5 testers at a time, APK via Google Drive, gate code `Vera2026`, feedback to `vestehealth@gmail.com`.
- Tester packet: `BETA_TESTER_PACKET.md` at project root.
- Goal: surface bugs, confirm voice/tone, refine onboarding, collect first testimonial for the hook.

### 10.2 Launch Channels (Priority Order)

1. **Health-curious Instagram / TikTok** — short-form video. "She noticed before I did" micro-stories. User POV of opening VERA, asking one question, seeing the pattern. Native feel, no glossy production.
2. **Substack / LinkedIn long-form** — the founder voice. Why generalist wellness fails. Why influencer-driven health is dangerous. Why a specialist AI grounded in institutional science is the answer. Build email list.
3. **Reddit (targeted subs)** — r/Biohackers, r/Supplements, r/AskDocs (carefully — informational only), r/Longevity, r/QuantifiedSelf. Genuine answers, not promotions. Founder account.
4. **Podcast appearances** — founder as guest. Health-curious, skeptical-of-influencers audience. Positioning: building the anti-influencer AI.
5. **Partnership: Deidre + legal network** — once legal review closes, B2B2C angle (clinician refers patient to VERA for home logging between visits).
6. **Veste Health device bundle** — four Veste-sold devices (Samsung Galaxy Watch, HydrateSpark, Withings Scale, Omron BP) become the natural onboarding wedge.

### 10.3 Paid (Post-Launch Only)

- Meta / IG / TikTok small-budget tests after 60-day pricing confirmation
- Google Search on intent keywords ("my labs mean," "prep for doctor visit," "why is my sleep worse lately")

### 10.4 Distribution

- **Web:** Cloudflare Pages — present. Gate down when trademark is filed.
- **Android:** APK via Drive now. **Google Play internal test track → open test → production** is the post-beta path.
- **iOS:** Post-launch.
- **Alexa Skill:** "Alexa, open VERA" → voice-only hands-free. 4–8 weeks of work. See roadmap.
- **Physical VERA Crystal:** dedicated hardware device (mic + speaker + LED + BLE). 6–18 months. See roadmap.

### 10.5 Content Pillars (Recurring Themes)

1. **Pattern stories** — "she noticed before I did" vignettes, user-permission-based.
2. **Source explainers** — "What the AHA actually says about [X]." Antidote to influencer misinformation.
3. **Daily life with a specialist** — short videos of asking VERA one real question and getting a real answer.
4. **Founder journey** — behind the build. Honest. Not glossy.

---

## 11. Launch Sequence (Recommended)

### Pre-Launch (Now)

1. Close external blockers — USPTO filing, Anthropic BAA, Deidre legal review, live Stripe cutover.
2. Finish beta with 3–5 testers.
3. Rebuild APK, upload current build to Drive.
4. Favicon asset finalized.
5. One real "she noticed before I did" testimonial captured.
6. Marketing-site unsubscribe wired (CAN-SPAM).

### Launch Week

1. Remove gate code (requires trademark filing done).
2. Cloudflare Pages → primary domain cutover (`vera.vestehealth.com` or similar).
3. Android Play Store open test.
4. First founder content drop (Instagram + Substack + LinkedIn, same day).
5. Three podcast outreach asks sent.
6. Monitor feedback email + crash logs daily.

### First 60 Days Post-Launch

1. Iterate on onboarding based on real funnel data.
2. Confirm pricing ($19.99 / $149.99) holds or adjust.
3. iOS build kickoff.
4. Partnership conversations.
5. Alexa skill scoping.

### Months 3–6

1. iOS live.
2. Alexa skill MVP.
3. Crystal hardware scoping and industrial design kickoff.
4. First cohort of Veste device bundles.

---

## 12. Roadmap — What's Next

### 12.1 Immediate (code-ready)

- Sprint H — split the 16K-line single file into 8 modules (developer hygiene, no user-facing change)
- Dashboard per-tile quick-entry (in-place sliders on each tile)
- Favicon finalization
- APK rebuild pipeline → Play Store internal test track

### 12.2 Business-Blocked (external)

- USPTO trademark (Class 9 + 44, ~$350, intent-to-use)
- Anthropic BAA (HIPAA)
- Deidre legal review (Privacy / Terms / TCPA sign-off)
- Live Stripe cutover
- Withings OAuth integration (needs developer account + API key)

### 12.3 Distribution Expansion

- Play Store open test
- iOS build
- **Alexa Skill** — "Alexa, open VERA" → Lambda → vera-ai-proxy. Voice-only. 4–8 weeks.
- Landing page cutover (vestehealth.com)

### 12.4 Hardware: The Physical VERA Crystal

A dedicated Veste-designed device. IoT with mic + speaker + ambient LED + BLE/WiFi. "Hey VERA" wake-word. Same backend as the app. 6–18 months: dev, firmware, industrial design, FCC/CE certification, manufacturing, inventory. Sells alongside the app as the physical presence of VERA in the home.

The crystal is also the evolving in-app visual — it "grows" as the user's engagement deepens.

### 12.5 Beyond Launch

- Genetic report import
- Coaching program import
- Additional device integrations (Fitbit, Garmin, Oura — beyond the 4 Veste-sold devices)
- Family plan
- Public preview page (between Landing and Signup)
- Crystal evolution (in-app visual)

### 12.6 The Long Arc — Beyond Apps (Strategic Vision)

*Adopted 2026-04-24, prompted by Frederica's reading of Diamandis's* We Are As Gods *and the question "what comes after apps?"*

The web app and the APK are the **first two surfaces** VERA lives on, not the product. The product is VERA herself — an AI specialist who knows the individual. The long-arc bet is that the surface count goes up and friction to reach her goes to zero. No more "open VERA." She is just present.

**The reframe (also in §9.3 Supporting Messages):**

> *Stop thinking of VERA as an app you ship. Think of her as a person you're hiring into your users' lives. The phone is just where she clocks in first.*

This is the line that anchors next-stage marketing, fundraising, partnership pitches, and product strategy.

**Surface order — lowest friction next:**

1. **Wrist (6–12 months).** Native Galaxy Watch / Apple Watch app. Moment-of-need check-ins, haptic nudges on HR spikes, voice from the wrist. Highest-leverage next surface — the watch already knows the body.
2. **Voice-everywhere (Alexa MVP 4–8 weeks; already in §12.3).** Alexa skill, Google Home, Siri shortcuts. *"Hey Vera, I feel off."* Health is voice-first by nature — people don't type when they're sick, scared, or tired.
3. **Crystal hardware — VERA's iPod moment (6–18 months; already detailed in §12.4).** A bedside object: ambient light + voice + always-present. Apps live inside phones; the crystal lives in the home. This is where VERA stops being software-you-open and becomes furniture-you-live-with.
4. **Glasses / AR (2–4 years).** When Meta / Apple ship daily-wear glasses, VERA becomes overlay — sees the plate and logs the meal, watches form mid-workout, reads stress from the face. Don't build now. Keep data shapes vision-friendly.
5. **Agentic on the user's behalf (mostly possible now — prompt + tool-use work).** VERA doesn't just *tell* the user to drink water. She reorders supplements when low, books a doctor when she sees a 5-day pattern, texts the spouse when she sees a real spiral. No new tech required — this is integration work on top of what already exists.

**The Diamandis / longevity-tech angle.** Exponential tech is folding into the body — implantable biosensors, continuous glucose monitors, neural interfaces, AI physicians. VERA's whole edge — *"she knows you from what your body says"* — **gets stronger the more body data flows in.** The future-proof bet isn't a new UI paradigm. It's owning the AI relationship layer with the user, while sensors and surfaces underneath get swapped out and upgraded over the next decade. Wrist today, crystal in 2 years, implant in 7, neural in 15 — same VERA on top.

**The architectural rule that keeps this door open:** VERA's brain stays in the `vera-ai-proxy` Edge Function — never embedded in any one client. Every new surface (watch, Alexa, crystal, glasses) is a thin client calling the same brain. Document a "voice contract" so a future watch app, Alexa skill, or crystal speaks the *same* VERA, not a different bot per channel.

**The decision filter for any new feature or surface:** *Does this deepen VERA's specialization in the individual, and does it survive when the underlying device generation changes?* If yes, ship. If no, defer.

---

## 13. Resources & URLs

- **Live app:** https://vera.vestehealth.com (gate `Vera2026`)
- **Project repo:** `C:\Users\richa\vera-project`
- **Beta tester packet:** `BETA_TESTER_PACKET.md`
- **Beta preflight:** `BETA_PREFLIGHT_CHECKLIST.md`
- **Execution plan (master):** `V24 Execution Plan REVISED v2` (Word doc at project root)
- **Action plan (go-to-market):** `vera-action-plan.md`
- **Feedback inbox:** `vestehealth@gmail.com`

---

## 14. Brand Rules — Quick Reference Card

| Rule | Details |
|---|---|
| Full name on brand surfaces | V.E.R.A. + Veste Evidence-Based Response Agent + "Vera means Truth." |
| Body copy | VERA |
| Voice | Singular — I / me / my |
| Brand "we" | Only for Veste Health company voice |
| Colors | Navy `#1E2B6E`, Gold `#F5C518`, Sage `#4A7C6F`, Cream `#FAFAF8` |
| Banned phrases | "Research shows," "studies suggest," any individual personality name |
| Approved sources | AHA, CDC, NIH, USPSTF, Mayo, ACSM, AASM, JAMA, peer-reviewed journals |
| Banned sources | Individual personalities (Attia, Huberman, Patrick, Schoenfeld, Sinclair, Mercola) |
| No version numbers | "v24 / Phase 6 / Sprint H" never appear in user-facing copy |
| No personal names | Founder and family are never named in UI, prompts, or marketing copy |
| Hook | "She noticed before I did." `#SheNoticedBeforeIDid` |
| Privacy line | "I don't sell it, share it with advertisers, or use it to train any AI. Only you can read your data. You can wipe it from Settings anytime." |

---

## 15. Beta-1 Release Log — 2026-04-24

The UX overhaul before sending VERA to beta testers. This section is the record of what changed, where it lives, and how to roll back if needed.

### 15.1 Release Identity

- **Git commit:** `3183cbd` on `master`
- **Git tag:** `beta-1` (pushed to GitHub)
- **Web URL (live):** https://vera.vestehealth.com (gate `Vera2026`)
- **APK:** `C:\Users\richa\vera-project\vera-android\android\app\build\outputs\apk\debug\app-debug.apk` (12 MB)
- **APK backup:** `C:\Users\richa\Desktop\vera-beta-1-apk\vera-beta-1.apk` — keep this; rebuild copies overwrite the first path.
- **APK on Drive:** uploaded to `vestehealth@gmail.com` Drive account. Tester install steps live in `feedback_apk_delivery.md` (Claude memory).

### 15.2 What Shipped in Beta-1

**Dashboard — VERA as the hero.**
- Crystal moved from inline-small (96px side) to **centered-hero (180px)** at the very top of the page.
- Stacked vertically: crystal → "Good afternoon, Frederica" → intention → "Tap to talk with me →".
- Greeting name bumped 22px → 26px.
- Removed sticky positioning so the big crystal doesn't eat screen real estate as you scroll down.
- **Latest Insight card shrunk ~60%** — now a compact horizontal row that only appears when there's a fresh weekly/monthly insight.
- **Daily Check-In card shrunk ~30%** — smaller title, tighter padding, still one-tap.
- **Devices widget moved** from above "Today's Vitals" to below "Recent Activity." **Auto-hides** once Health Connect is connected or any CGM/Apple Health data is logged. Users manage sync from Settings after the first run.

**Dashboard order (top to bottom):**
1. Crystal + greeting (hero)
2. Latest Insight (if fresh)
3. Daily Check-In button
4. Today's Vitals (grid of 4 tiles)
5. Habits (streak)
6. Health Connect live tiles (steps, HR, sleep, weight — when connected)
7. Recent Activity
8. Connect Your Devices widget (hidden once connected)
9. Today's Nutrition (when logged)
10. What Has VERA Noticed? (pattern analysis)
11. Quick Actions

**Chat page — larger crystal presence.**
- Desktop: 160×160 → **200×200**.
- Mobile: 110×110 → **150×150**.

**Sidebar — VERA now visible.**
- **Root cause fix:** the sidebar crystal was being rendered nearly invisible. A global `mix-blend-mode: multiply` (a trick to make the GIF's white background transparent on light pages) was turning the crystal into dark-on-dark against the navy sidebar.
- Override applied for `#sidebar-logo-crystal` and `.sidebar-crystal-img`: `mix-blend-mode: normal` + `border-radius: 50%` + `overflow: hidden` + `object-fit: cover`. VERA now shows in real color inside a clean circular crop.
- Header crystal bumped **52px → 72px** beside V.E.R.A.
- Second "tap to chat" crystal below the username kept at 52px (also now visible).

**My Health — health summary, not a VERA capture page.**
- **Removed** the "Tell VERA Anything" free-note textarea + Save Entry button + voice mic entirely. Chat is the universal capture path.
- **Added compact "What Has VERA Noticed?" hero card** at the top of My Health — sage left-border, 20px title beside ✨ icon, **Discover** + **View all →** buttons on the right. One-row header, body expands only when patterns are discovered.
- My Metrics tile grid untouched below.

**Insights & Tools — new dedicated VERA Noticed tab + nav fix.**
- **New tab #1: "✨ What VERA Noticed"** with its own full-page view. Large icon, sage-accented card, "Discover Patterns" button, cached insights rendered on page open.
- **Fixed stranded pages:** Labs and Symptoms views had NO tab bar before — you'd land there with no way back to the other Insights tabs. Standard 8-tab nav now appears on every Insights page.
- **Standard 8-tab Insights nav (all views):** What VERA Noticed · Reports · Plan Ahead · Supplements · Labs · Symptoms · Doctor Prep · Share. Previously Supplements was missing Plan Ahead — fixed.

**Symptoms page (Insights tab) — stripped to its purpose.**
- **Removed** Log a Meal, Meal Suggestions, Recent Timeline, and the old "← Back to Nutrition" leftover.
- **Kept** Log a Symptom + Correlations.
- **Correlations engine rewritten.** Was food→symptom only (required 3+ meals + 2+ symptoms). Now analyzes across **meals, sleep, mood, stress, energy, water, exercise, habits, supplements, and lab results** for each symptom. Threshold lowered to 2+ symptoms. Prompt asks the AI to find *any* repeated patterns across those factors.

**Food Tracker — restored as its own view.**
- New view `view-food-tracker` — separate from the now-stripped Symptoms page.
- Reached from My Health → Nutrition tile → "🍽️ Open Food Tracker — meals, macros, suggestions" button.
- Contains: Log a Meal form (with voice + photo input), Meal Suggestions card, Recent Timeline.
- "← Back to Nutrition" button at the top.

**Settings → Connect & Sync — one source of truth.**
- **Removed** 7 confusing per-device rows that all just `toast()`-ed "available in app."
- **Added "How Your Devices Sync"** explainer block — intro + supported-devices list + 2-step Android setup instructions + iOS note.
- **Added "✨ Veste Health Recommended Devices" shop card** — slim card with Withings · Omron · HydrateSpark · Samsung Galaxy Watch, each with a one-line description, gold accent preserved, `vestehealth.com →` link at the bottom in forest green underline.

**Settings — clearer section boundaries.**
- Every settings section (15 cards) got stronger visual separation:
  - Gap between cards **24px → 32px**.
  - Border **1px light → 2px solid**.
  - New subtle **navy-tinted shadow** (`0 2px 10px rgba(30,43,110,0.05)`) for depth.
  - Header background **cream → cream→warm-white gradient**.
  - Header color **mid-gray → navy `#1E2B6E`**, weight 600 → 700, padding bumped.

**Under the hood.**
- `discoverPatterns()` refactored — writes to every `[data-vera-insights]` block at once. Dashboard, My Health hero, and Insights "What VERA Noticed" page stay in sync automatically.
- New `hydrateInsightsFromCache()` helper — paints cached pattern analysis into all three pages the instant you open them (no waiting for the AI to re-run).
- `VIEW_TITLES` updated — `vera-noticed`, `food-tracker`, `labs`, `food-symptoms` all route to "Insights & Tools" (except food-tracker which shows "Food Tracker").
- `openMetricLog('nutrition')` now routes to the new `food-tracker` view (was routing to the gutted Symptoms page).

### 15.3 Also Committed in This Checkpoint (Prior Uncommitted Work)

Bundled into the same commit because it had been sitting on the tree:
- `supabase/functions/vera-ai-proxy/index.ts` — added **LOGGING directives** (when the user mentions trackable data, VERA silently calls the matching tool — log_food, log_water, log_symptom, etc.) and **TIMING directives** (real date math — if today is April 23 and surgery is the 30th, say "7 days out" not "getting close").
- `BETA_TESTER_PACKET.md` — rewritten step-by-step.
- `setup-supabase-cli.cmd` — one-shot login helper.
- `VERA_MANUAL.md` — this document.

### 15.4 Safety Net

| Safeguard | Location |
|---|---|
| Commit | `3183cbd` on `master` (local + GitHub) |
| Tag | `beta-1` (local + GitHub) |
| APK backup | `C:\Users\richa\Desktop\vera-beta-1-apk\vera-beta-1.apk` |
| Web deploy history | Cloudflare Pages dashboard (roll back any previous deploy with one click) |
| Supabase data | Always cloud-backed — independent of the laptop |
| Cloudflare token | Still gitignored inside `deploy-web.cmd` (never committed) |

### 15.5 Rollback Commands

If a future change breaks something, these get you back to beta-1:

```bash
# 1. Restore the exact beta-1 code locally
git checkout beta-1

# 2. Rebuild dist and redeploy web
build-dist.cmd
deploy-web.cmd

# 3. Rebuild the APK (or just reinstall the backup)
build-apk.cmd
# OR just upload vera-beta-1.apk from the Desktop backup folder

# To return to the latest master once fixed:
git checkout master
```

Or roll back web only, without touching code: **Cloudflare Pages dashboard → Deployments → click an earlier deploy → "Rollback to this deployment."**

### 15.6 URLs to Share With Beta Testers

- **App:** https://vera.vestehealth.com (gate code `Vera2026`)
- **APK install instructions:** follow `BETA_TESTER_PACKET.md`
- **Feedback:** `vestehealth@gmail.com`

---

## 16. Release Log — 2026-04-27 (My Health redesign + scoring system)

The largest in-app upgrade since beta-1: ~1,750 lines of code, ~63 new functions. My Health restructured around 8 organ-system tiles. Two scores added (one daily-personal, one monthly-population). VO2 max wired across three input paths. Cycle & Hormonal tile added for the women's-health audience. Crystal VERA voice and system prompts: 0 modifications (verified by diff).

### 16.1 What shipped

**My Health — 8-tile restructure (D5).** Replaces the prior tile lineup. New tiles: Sleep · Heart · Movement · Body · Metabolic & Nutrition · Mindfulness · Cycle & Hormonal · Community. Every legacy capability preserved through deep-link buttons on combined tiles (Open Food Tracker, Lab results, Mood trend, etc.) — *"all of the original items need to remain"* (Frederica, verbatim during session).

**Tile explainers (D1).** Every metric detail panel now opens with a one-paragraph explainer + institutional citation in a sage-bordered cream box. Sources: AASM (sleep), AHA + Ross 2016 (heart), Lee 2019 (movement), NHLBI (body), ADA + USDA (metabolic & nutrition), NIH NCCIH (mindfulness), NAMS (cycle), Surgeon General 2023 (community), plus legacy citations preserved for mood/hydration/nutrition/BP.

**Metabolic Age summary card (D2).** Mifflin–St Jeor BMR (Katch–McArdle when body fat % available) reverse-looked-up against sex-matched population reference body, ages 18–80. Reference body: 80 kg / 175 cm (M), 68 kg / 162 cm (F) — NHANES adult means. Citations: Mifflin 1990; WHO/FAO 2001.

**Cardio Fitness (VO2 max) — three-path (D3).** Wearable → Rockport result → manual Fitness Benchmarks entry → Uth non-exercise estimate. FRIEND population norms (Kaminsky 2019) for category labels. Lives under the Heart tile per AHA framing.

**Rockport 1-Mile Walk Test (D7).** Full guided in-app flow — intro → walk timer → finish → enter end HR → result. Kline 1987 formula, ±10% accuracy, validated 30–69. Saves to `fitnessBenchmarks` with `vo2maxRockport` field.

**Vitality Score (D6, monthly).** AHA Life's Essential 8 + cardiorespiratory enhancement: 8 LE8 components @ 10% each + VO2 max @ 15% (Mandsager 2018) + RHR @ 5% (Jensen 2013, Aladin 2014). Coverage transparency: "based on N of 10 components." Per-component rubrics from Lloyd-Jones et al. 2022 (Circulation).

**VERA Score (D4, daily — the moat).** 6 components: Sleep 25 / HRV 25 / RHR 15 / Movement 15 / Mood 10 / Hydration 10. Z-score normalization against the user's own 14-day rolling baseline. Banner shows "Calibrating: X of 14 days" until day 14, then steady. Plain-language takeaway under the score: top + bottom component. Hidden until ≥2 components have data. **Marketing line: "VERA scores you against you."**

**RHR baseline fix (Fix #1).** Daily RHR now derived from the bottom-tertile mean of each day's HR samples — same approach Apple/Garmin use when device data isn't tagged. Avoids workouts pulling the baseline up.

**Calibration messaging (Fix #4).** 14-day calibration phase clearly labeled in both the banner and the detail panel, with a gold callout explaining why scores get more accurate as the personal baseline emerges.

**Weekly Diet Quality self-rating (Fix #2).** 5-question survey (simplified Mediterranean / DASH). Sum × 5 = 0–100. Feeds the Vitality Score's 10% diet weight (previously always null). Citations: AHA Life's Essential 8; USDA Dietary Guidelines.

**Cycle & Hormonal panel (Fix #3).** Full UI replacing the prior placeholder. Status picker → main panel → daily symptom log. 5 sliders (hot flashes, night sweats, sleep disruption, mood changes, brain fog), 0–10 each. Today's symptoms render as colored bars (red ≥7, gold ≥4, sage <4). Last-7-days summary with notable-symptom icons. Citations: NAMS, ACOG.

**Settings → Health Profile section.** New card between Profile and AI & Chat. Fields: biological sex, age, height (ft + in), weight (lbs), body fat % (optional), nicotine status. Powers Metabolic Age, BMI, and the nicotine component of Vitality Score. Footer cites Mifflin 1990, WHO/FAO 2001, Lloyd-Jones 2022, Kline 1987.

**Dashboard "Complete your profile" CTA banner.** Hidden by default, shown only when critical Health Profile fields are missing. Lists missing fields with a count: *"3 fields to add: biological sex, age, nicotine status · powers your scores"*. Tap → jumps to Settings → Health Profile.

**Tile-level "add this data" reminders.** Per-component action links shown next to "No data yet" entries — route to Daily check-in / Pair wearable / Log workout / Open Health Profile / Add lab result / Take walk test, depending on which component is missing.

**Brand — V.E.R.A. trademark expansion.** Sidebar header now shows V.E.R.A. + "Vesté Evidence-Based Response Agent" + "by Vesté Health" stacked. Home footer expanded to match. Total: 14 V.E.R.A. brand surfaces across the app, 10 with the full expansion (the 4 without are tooltips/metadata — acceptable).

**Dashboard order.** Crystal greeting → VERA Score banner → Profile completeness CTA → Daily Check-In → **Today's Vitals** → **Quest & Habits** (intentionally below vitals — vitals first, gamification second) → Health Connect tiles → Recent Activity. Default landing view is now Dashboard (was Chat); first-run users still route to Chat for the welcome sequence.

**Insights & Tools default landing.** Tapping the sidebar "Insights & Tools" item now lands on **What VERA Noticed** first (was Reports). Frederica's call — surface the synthesis VERA produces before the static tabs.

**Speech autoplay safety net.** Chrome blocks audio autoplay until the page receives a user gesture. VERA arms a one-shot listener at app init — if the greeting didn't speak on load, the first click/tap/keypress fires it automatically. The listener self-removes once VERA has spoken. Solves the "VERA went silent" intermittent issue without touching her voice or system prompt.

**Speech-cut-off bug fix.** `veraSpeak` interruption logic was returning early for auto-invocations that should have spoken. One-line fix; auto-greetings and different play buttons now correctly play new text instead of silently no-op'ing.

### 16.2 Bugs caught and fixed during session audit

1. **`profile.heightIn` doesn't exist** — schema is `heightFeet` + `heightInches`. Added `_profileTotalInches(profile)` helper. Affected `calculateMetabolicAge` and `_scoreBMI`.
2. **Wrong RHR field** — `_latestRestingHR` looked for `fb[i].restingHR` but schema uses `fb[i].rhr`. Fixed to check both for safety.
3. **Manual VO2 max wasn't being read** — added `fb[i].vo2` to `calculateVO2max` priority chain so values from the existing Fitness Benchmarks form actually feed the score.

### 16.3 Crystal VERA preservation (verified)

```
diff backup vs current | grep "callVera|getSystemPrompt|VERA_SYSTEM|toneOfVoice|persona ="
→ 0 matches
```

Voice config also verified intact: nova default, premium enabled, rate 0.92, pitch 1.0, all OpenAI TTS endpoints unchanged. Voice rule compliance: 0 instances of "research shows," "studies suggest," or any forbidden personality.

### 16.4 Files changed

| File | Change |
|---|---|
| `app/index.html` | 16,527 → 18,278+ lines. ~63 new functions/constants. ~764 KB inline JS. |
| `deploy-preview.cmd` *(new)* | Preview-branch deploy without touching production. |
| Backup files in `app/` | `index.html.backup-before-myhealth-redesign-2026-04-26`, `index.html.backup-before-profile-fields-2026-04-26`, `index.html.backup-before-quest-habits-unify-2026-04-25` |

### 16.5 Deploy

- Built dist (`build-dist.cmd`)
- Deployed to preview branch (`deploy-preview.cmd`) and verified
- Promoted to production (`deploy-web.cmd`) at https://vera.vestehealth.com
- APK rebuilt 2026-04-27 morning (`build-apk.cmd`) — 11.9 MB — staged for Drive upload to beta testers

### 16.6 Marketing implications

- **VERA Score, Vitality Score, adaptive baselines, and Cycle tracking are real product moats** — defensible against generalist wellness apps and siloed trackers. Use in differentiation copy.
- **"VERA scores you against you."** — promote alongside the existing hook *"She noticed before I did."*
- **Cycle & Hormonal tile** opens the women's-health 40–65 segment cleanly. Powerful angle for perimenopause/menopause-curious audiences who are underserved by mainstream health apps.
- **VO2 max via 1-mile walk test** is a sticky beta feature — testers can run it on day 1 without a wearable and get a real cardio fitness number. Surfaces well in short-form video ("she had me walk a mile and gave me my heart age").

### 16.7 Rollback (if needed)

Restore from `app/index.html.backup-before-myhealth-redesign-2026-04-26` and redeploy. Cloudflare Pages dashboard also offers one-click rollback to any prior deployment.

---

*End of manual. Any section that should grow, flag it and I'll expand.*