Synced from the repo — do not edit here
Canonical source: docs/claude/app-redesign-wireframes.md. This page is generated by docs/scripts/sync-handbook.mjs. Edit the source file in the repo; changes appear here on the next build.
App Redesign Wireframes — basishybrid
Generated 2026-07-09. Companion to app-redesign-roadmap.md. ASCII wireframes are the reference; high-fidelity HTML/Figma mockups pending user's mockup-path choice.
Information Architecture — 5 tabs + persistent Atlas pill
Today · Plan · Health · Chat · More
Plus a persistent Ask Atlas pill on every screen, sitting above the bottom nav. Voice-in + text — never voice-out.
Why 5 tabs (not 3): Oura/Whoop compress to 3 because they're single-focus (recovery/sleep). basishybrid has 5 concurrent jobs (booking + protocol + biomarkers + clinician chat + shop) that don't collapse cleanly. Compressible to 4 (fold Chat into Today's hero) if we later prove chat traffic is low.
New surfaces/primitives to add beyond current app
| # | Surface / primitive | What it is | Where accessed |
|---|---|---|---|
| 1 | Today (renamed Home) | Oura's "one big thing" with time-of-day dynamic content | Tab 1 |
| 2 | Diagnostic card | Canonical AI card: title + reasoning + one action + confidence + source. Reusable. | Everywhere AI speaks |
| 3 | Camera Capture Sheet | One-tap sheet for meal / med / lab. Visual Intelligence parity. | Plan, Health tabs |
| 4 | Live Activity | iOS Lock-Screen / Dynamic Island / Watch / Mac / CarPlay | System — 1 impl, 7 surfaces |
| 5 | Ask Atlas pill | Persistent voice+text input above tab bar | Every screen |
| 6 | "Why am I seeing this?" expand | Perplexity blue-frame pattern — reasoning + data trail | Every AI card |
| 7 | Timeline sub-view | Cross-surface longitudinal axis (bookings + retests + protocol milestones) | Health tab |
| 8 | Cowork inline action card | Clinician-AI proposal in chat: [Approve] [Discuss] [Decline] | Chat tab |
Wireframes
1) Today (Home)
┌──────────────────────────────────────────────┐
│ 🏛 Clinic mark 🔍 search 👤 │ translucent header
│ │
│ Good morning, Georges │ serif greeting
│ │
│ ┌────────────────────────────────────────┐ │
│ │ ★ ONE BIG THING TODAY │ │ ← dynamic AI hero
│ │ │ │ (time-of-day
│ │ Your HRV dropped 14 pts overnight — │ │ aware)
│ │ likely echo of Sunday's late training.│ │
│ │ │ │
│ │ [ Take a rest day → ] [ Discuss ] │ │
│ │ ⓘ 78% confidence · 3 signals │ │ ← confidence+source
│ └────────────────────────────────────────┘ │
│ │
│ Ready Age 27.3 ↓ 0.2 │ ← composite score
│ ▓▓▓▓▓▓▓▓▓░░░ your baseline: 27.5 │ (biological age)
│ │
│ ───────── UP NEXT ───────── │
│ ┌────────────────────────────────────────┐ │
│ │ Tue · 8:00 AM PT (in 14h) │ │ ← next appointment
│ │ Strength w/ Coach James · Studio B │ │ (also a Live
│ │ [ ↳ ] [ ✎ ] │ │ Activity)
│ └────────────────────────────────────────┘ │
│ │
│ ───────── YOUR PROTOCOL ──────── │
│ Recovery Week · Day 3 of 7 │
│ ⬤ ⬤ ⬤ ○ ○ ○ ○ │
│ 2 of 3 today complete │
│ Next: Evening walk (30m) [ Start ] │
│ │
│ ───────── TODAY'S SYNC ───────── │
│ 🛌 7h 12m · 78 score · Whoop │ ← wearable summary
│ 🏃 Z2 45m · 138 avg HR │ (tap for sheet)
│ │
│ ┌────────────────────────────────────────┐ │
│ │ 🎙 Ask Atlas… │ │ ← persistent voice
│ └────────────────────────────────────────┘ │ (above tab bar)
├──────────────────────────────────────────────┤
│ ● Today Plan Health Chat More │
└──────────────────────────────────────────────┘
2) Plan (Programs / Tasks / Learn)
┌──────────────────────────────────────────────┐
│ Plan 👤 │
│ │
│ Programs · Tasks · Learn │ ← sub-tabs
│ ──────── │
│ │
│ ─── ACTIVE PROTOCOL ─── │
│ ┌────────────────────────────────────────┐ │
│ │ Recovery Week │ │
│ │ Day 3 of 7 ⬤ ⬤ ⬤ ○ ○ ○ ○ │ │
│ │ ── │ │
│ │ Today 2 / 3 │ │
│ │ ✅ Morning breathwork · 8m │ │
│ │ ✅ Cold plunge · 3m │ │
│ │ ⬜ Evening walk · 30m [Start] │ │
│ └────────────────────────────────────────┘ │
│ │
│ ─── SUGGESTED BY ATLAS ─── │ ← Cowork card
│ ┌────────────────────────────────────────┐ │
│ │ 📋 Skip strength Tuesday? │ │
│ │ │ │
│ │ Your HRV has trended down 4 days. │ │
│ │ Your recovery pattern suggests adding │ │
│ │ 1 rest day would maximize the block. │ │
│ │ ── │ │
│ │ Dr. Lu will see your response. │ │
│ │ [ Approve ] [ Discuss ] [ Decline ] │ │ ← Cursor/Cowork
│ │ ⓘ Why · 65% conf · 4 signals › │ │
│ └────────────────────────────────────────┘ │
│ │
│ ─── THIS WEEK ─── │
│ Mon ⬤ Recovery Week Day 1 │
│ Tue ○ Strength (proposed skip) │
│ Wed ○ Sauna 20m │
│ Thu ○ Recovery Week Day 5 │
│ Fri ○ Strength │
│ ───────── │
│ 📚 Learn: "Why HRV matters for recovery" │
│ │
│ 🎙 Ask Atlas… │
├──────────────────────────────────────────────┤
│ Today ● Plan Health Chat More │
└──────────────────────────────────────────────┘
3) Health (Biomarkers / Wearables / Labs)
┌──────────────────────────────────────────────┐
│ Health 👤 │
│ │
│ Ready Age 27.3 ↓ 0.2 this week │
│ ▓▓▓▓▓▓▓▓▓░░░ │
│ │
│ ─── NEEDS ATTENTION ─── │ ← "one big thing"
│ ┌────────────────────────────────────────┐ │ for biomarkers
│ │ ApoB · 92 mg/dL │ │
│ │ ═════════●═══ │ │ ← Function pattern
│ │ 70 ─── optimal ─── 100 │ │ range chip
│ │ │ │
│ │ ↗ +7 mg/dL since Mar 3 panel │ │
│ │ ⓘ Dr. Lu note (Jun 12) › │ │ ← clinician note
│ │ [ Discuss with Dr. Lu ] │ │
│ └────────────────────────────────────────┘ │
│ │
│ ─── WEARABLES · TODAY ─── │
│ ┌────────────┬───────────┬───────────────┐ │
│ │ Sleep │ HRV │ Resting HR │ │
│ │ 7h 12m │ 42 ms │ 62 bpm │ │
│ │ ▁▄▂█▁▄▂█ │ ↓ -14 │ ↑ +2 │ │
│ │ 78 score │ vs base │ vs base │ │
│ └────────────┴───────────┴───────────────┘ │
│ │
│ ─── BIOMARKERS · BY SYSTEM ─── │
│ ┌────────────────────────────────────────┐ │
│ │ Cardiovascular 6 of 10 optimal │ │
│ │ ▓▓▓▓▓▓░░░░ ApoB, LDL out │ │
│ └────────────────────────────────────────┘ │
│ ┌────────────────────────────────────────┐ │
│ │ Hormones 8 of 8 optimal │ │
│ │ ▓▓▓▓▓▓▓▓▓▓ ✓ │ │
│ └────────────────────────────────────────┘ │
│ ┌────────────────────────────────────────┐ │
│ │ Metabolic 4 of 5 optimal │ │
│ │ ▓▓▓▓▓▓▓▓░░ Fasting insulin border │ │
│ └────────────────────────────────────────┘ │
│ │
│ ─── RECENT LABS ─── │
│ Jun 12 · Comprehensive · 47 markers │
│ Mar 03 · Comprehensive · 45 markers │
│ [ + Upload lab PDF ] [ 📷 Scan ] │ ← Camera Capture
│ │
│ 🎙 Ask Atlas… │
├──────────────────────────────────────────────┤
│ Today Plan ● Health Chat More │
└──────────────────────────────────────────────┘
4) Chat (Care team + Atlas actions)
┌──────────────────────────────────────────────┐
│ ← Care team 👤 │
│ Dr. Lu · online · replies within 4h │ ← SLA per Chat v2
│ │
│ ─────── Yesterday ─────── │
│ │
│ Dr. Lu │
│ ┌────────────────────────────────────┐ │
│ │ Great work this week. Let's chat │ │
│ │ about your ApoB trend — up 7 from │ │
│ │ March. I'm drafting an update. │ │
│ └────────────────────────────────────┘ │
│ │
│ You │
│ ┌─────────────────────────┐ │
│ │ Sounds good. Fiber has │ │
│ │ been inconsistent tbh │ │
│ └─────────────────────────┘ │
│ │
│ Atlas · drafted by Dr. Lu │ ← attribution
│ ┌────────────────────────────────────┐ │
│ │ 📋 Protocol update proposed │ │
│ │ │ │
│ │ • Add 5g soluble fiber daily │ │
│ │ • Shift Zone 2 cardio to AM │ │
│ │ • Retest ApoB in 8 weeks │ │
│ │ ── │ │
│ │ ⓘ Why: ApoB up 7, HRV pattern │ │
│ │ Sources: 6 markers, protocol log │ │
│ │ │ │
│ │ [ Approve ] [ Discuss ] [ Decline ]│ │
│ └────────────────────────────────────┘ │
│ │
│ ─────── Today ─────── │
│ │
│ Atlas │
│ ┌────────────────────────────────────┐ │
│ │ Booking suggestion │ │
│ │ Follow-up with Dr. Lu in 2 weeks? │ │
│ │ [ Book Wed 6/24 · 2pm ] [ Other ] │ │ ← inline action
│ └────────────────────────────────────┘ │
│ │
│ ┌────────────────────────────────────────┐ │
│ │ 💬 Type… 🎙 📷 │ │ ← voice + camera
│ └────────────────────────────────────────┘ │
├──────────────────────────────────────────────┤
│ Today Plan Health ● Chat More │
└──────────────────────────────────────────────┘
5) More (settings drawer)
┌──────────────────────────────────────────────┐
│ More 👤 │
│ │
│ Georges Karahalios │
│ Silver Longevity · Member since 2024 │
│ │
│ ─── ACCOUNT ─── │
│ Profile & health history › │
│ Membership & billing › │
│ Payment methods › │
│ │
│ ─── DATA & DEVICES ─── │
│ Wearables (Whoop, Oura, Apple) › │
│ Health Connect / HealthKit › │
│ Lab & document uploads › │
│ Export my data › │
│ │
│ ─── PREFERENCES ─── │
│ Notifications › │
│ Theme (dark / light / auto) › │
│ Motion & haptic intensity › │
│ Language › │
│ │
│ ─── ATLAS (AI) ─── │
│ What Atlas can access › │
│ Personalization (learned defaults) › │
│ Reset Atlas memory › │
│ │
│ ─── CLINIC ─── │
│ Locations › │
│ Care team › │
│ Shop / marketplace › │
│ │
│ ─── SUPPORT ─── │
│ Help center › │
│ Contact support › │
│ Privacy · Terms · Compliance › │
│ │
│ Sign out │
├──────────────────────────────────────────────┤
│ Today Plan Health Chat ● More │
└──────────────────────────────────────────────┘
6) Camera Capture Sheet (new — accessible from Today, Plan, Health)
▲ ← drag handle
┌──────────────────────────────────────────────┐
│ │
│ [ camera viewport ] │
│ │
│ auto-classifying… │ ← Visual Intel
│ │
│ I see: a lab report │ ← detected type
│ │
│ ┌────────────────────────────────────────┐ │
│ │ 📋 Lab report │ │
│ │ 📄 Document │ │
│ │ 💊 Med / supplement │ │
│ │ 🍽 Meal │ │
│ └────────────────────────────────────────┘ │
│ │
│ ● Capture 🖼 From library │
└──────────────────────────────────────────────┘
7) Live Activity (iOS Lock Screen — 1 impl → 7 surfaces)
┌──────────────────────────────────────────────┐
│ 📅 Next up · Basis │
│ ──────── │
│ Tue 8:00 AM PT · in 14h 22m │
│ Strength w/ Coach James │
│ Studio B · Silver Longevity │
│ │
│ [ Directions ] [ Reschedule ] │
└──────────────────────────────────────────────┘
Design DNA per surface (research-verified)
| Surface | Steal from | Pattern |
|---|---|---|
| Today | Oura Today | "One big thing" hero; time-of-day dynamic |
| Today | Whoop Coach | Daily Outlook proactive card |
| Today | Function | Composite score display |
| Plan | Cursor Mobile / Claude Cowork | Approve/Discuss/Decline on clinician-AI proposal |
| Health | Function | Sparkline + range chip + clinician note per biomarker |
| Health | Oura Vitals | Personal-baseline color coding + haptic-on-graph |
| Health | Everlab | Muted warm palette, longitudinal history |
| Chat | Linear (Saarinen 6 principles) | Attribution, disclosure, immediate feedback, human accountability |
| Chat | Perplexity | "Why" expand on every AI card |
| More | Apple Health redesign | Scan-and-go grouped sections |
| Camera | Apple Visual Intelligence | Auto-classify → confirm-card → log |
| Live Activity | Apple ActivityKit (WWDC26) | 4KB payload, one impl → 7 render surfaces |
Mockup-path options (pending user choice)
Option A — Local HTML mockups (RECOMMENDED)
- 6 HTML files with Fraunces + Inter + real warm-neutral palette
- Local http server, browser-viewable
- Fastest iteration (~2-3 min per revision)
- ~30-45 min to first version
Option B — Figma via MCP
- Real Figma frames with components + variants
- Needs auth flow first
- ~45-60 min plus auth
Option C — User-provided Figma file
- Paste file key, I write into existing file
Robustness callbacks (from roadmap)
- Every AI card in the wireframes above carries confidence + source + "why" — non-negotiable.
- No voice-out. Voice input → structured card output.
- Chat is NOT the home surface. Atlas is embedded in Today's hero + as inline cards in Chat/Plan.
- Layouts respect Reduce Transparency + user tint slider (Liquid Glass discipline).
- All spacing / color / motion / haptic values are semantic-token references, never hardcoded.