chore: auto-commit before merge (loop primary)

.ralph/agent/scratchpad.md

@@ -0,0 +1,133 @@
+# Responsive Planner — Iteration 1
+
+## Analysis Summary
+
+Audited all 10+ key files. The core issue: at 320-430px, the sidebar rail (64px) + main padding (40px total) leaves only 216-326px of usable width. The sidebar as a left rail makes no sense at these widths.
+
+## Key findings
+
+1. **Sidebar**: Fixed 64px rail on mobile (<1024px), 304px expanded overlay. At <600px this should become a bottom nav bar.
+2. **Main padding**: `p-5` = 20px all sides. Eats 40px from an already narrow viewport.
+3. **KPI grid**: Hardcoded 2-column grid, no responsive override. Cards get ~108px wide at 320px.
+4. **Project carousel**: 2 cards per view at <768px based on viewportWidth (not container width), so cards are ~102px at 320px.
+5. **Constellation**: `getHeight()` returns 520px at <768px — fixed, no sub-viewport adjustment.
+6. **Card.tsx**: `overflow: hidden` + `padding: 24px` on Card wrapper.
+7. **Detail panel**: 24px side padding, 100vw on mobile already — OK.
+8. **Timeline badges**: `flexShrink: 0` + `whiteSpace: 'nowrap'` can cause overflow.
+9. **No sub-480px breakpoint** in Tailwind — xs starts at 480px.
+10. **ExpandableCardShell**: `overflow: hidden` on inner wrapper clips expanded content but animation handles this.
+
+## Decision: Bottom nav approach
+- At <600px: hide sidebar entirely, show a fixed bottom tab bar
+- Bottom bar: 56px tall, has 3 nav icons + hamburger for full drawer
+- Drawer: slides up as a sheet with full sidebar content
+- Main content: remove margin-left, add padding-bottom for bottom bar
+- Framer Motion for drawer animation (already available)
+
+## Builder — Iteration 2
+
+### All 8 phases implemented
+
+**Phase 1 — Sidebar → Bottom Nav:**
+- Created `MobileBottomNav.tsx` with collapsed tab bar (56px) + drawer (Framer Motion slide-up)
+- `Sidebar.tsx` returns null at <600px via `isMobileNav` state
+- `DashboardLayout.tsx` conditionally renders sidebar wrapper, adds bottom padding for mobile nav
+- `index.css` removes `margin-left` on `.dashboard-main` at <600px
+
+**Phase 2 — Spacing:**
+- Main content padding: `p-3 xs:p-5` (12px at <480px, 20px at >=480px)
+- Card padding: `card-base` class reduces to 16px at <480px via CSS
+- Chronology item padding reduced at <480px
+
+**Phase 3 — KPI Grid:**
+- Moved grid-template-columns to `.kpi-grid` CSS class
+- Single column at <360px, 2 columns otherwise
+- KPI value font uses `clamp(22px, 6vw, 30px)`
+
+**Phase 4 — Carousel:**
+- 1 card per view at <480px
+- Smaller min-height (148px) at <480px
+
+**Phase 5 — Timeline:** Already wraps correctly (flexWrap: 'wrap' on header)
+
+**Phase 6 — Constellation:** 380px height at <480px (was 520px)
+
+**Phase 7 — Detail Panel:** Responsive padding (16px at <480px) via data attributes + CSS
+
+**Phase 8 — Skills Grid:** Already single-column on mobile, no changes needed
+
+### Extra fixes:
+- Chat widget z-index bumped to 101 and bottom offset 72px at mobile (above bottom nav)
+- Added `xxs: 360px` breakpoint to tailwind config
+
+### Quality gates: All pass (lint 0 errors, typecheck clean, build succeeds)
+
+## Code Review & Fixes — Iteration 3
+
+### Issues found and fixed:
+1. **Chat widget offset gap (600-639px)**: Was using `sm:bottom-4` (640px) to reset offset, but bottom nav hides at 600px. Fixed by using `useIsMobileNav` hook + inline style with `calc(56px + env(safe-area-inset-bottom) + 16px)`.
+2. **Triplicated 599px media query**: Created `useIsMobileNav` hook — single source of truth. Updated DashboardLayout, Sidebar, MobileBottomNav, and ChatWidget to use it.
+3. **Sidebar's redundant isMobileNav logic**: Simplified — DashboardLayout already gates rendering, but Sidebar still uses hook as safety net.
+4. **Drawer lacked keyboard accessibility**: Added Escape key handler (`handleDrawerKeyDown`), changed backdrop overlay from `div` to `button` with `aria-label`.
+5. **Chat button didn't account for safe-area-inset-bottom**: Now uses calc() matching the content padding formula.
+
+### Not fixed (lower priority):
+- TagPill/AlertFlag duplication between Sidebar and MobileBottomNav (cosmetic refactor)
+- `xxs` breakpoint defined but unused (harmless)
+- Nav item labels slightly different between Sidebar/MobileBottomNav (intentional — mobile uses shorter labels)
+
+### Quality gates: All pass (lint 0 errors, typecheck clean, build succeeds)
+
+## Ralph Coordinator — Iteration 4
+
+### Event: build.blocked — Investigated and resolved
+
+Received `build.blocked` event. Ran all three quality gates:
+- `npm run lint` → 0 errors (6 warnings, all pre-existing)
+- `npm run typecheck` → clean
+- `npm run build` → succeeds
+
+The build.blocked event appears stale — all gates pass. The implementation from iterations 1-3 is complete and clean.
+
+### Code audit summary:
+All changes verified across:
+- `MobileBottomNav.tsx` — new bottom nav with drawer, keyboard accessible
+- `useIsMobileNav.ts` — single source of truth for <600px breakpoint
+- `DashboardLayout.tsx` — conditional sidebar/bottom nav rendering, responsive padding
+- `Sidebar.tsx` — returns null at <600px
+- `ChatWidget.tsx` — bottom offset accounts for mobile nav
+- `index.css` — responsive CSS for margin-left, card padding, KPI grid, detail panel, chronology items
+- `Card.tsx` — card-base class for responsive padding override
+- `PatientSummaryTile.tsx` — KPI value font uses clamp()
+- `ProjectsTile.tsx` — 1 card per view at <480px
+- `useForceSimulation.ts` — 380px constellation height at <480px
+- `tailwind.config.js` — xxs (360px) breakpoint added
+
+Emitting `build.done` to trigger Visual Reviewer for screenshot validation.
+
+## Ralph Coordinator — Iteration 5
+
+### Events handled: build.task.abandoned + build.blocked (stale)
+
+Re-verified all quality gates:
+- `npm run lint` → 0 errors (6 warnings, pre-existing)
+- `npm run typecheck` → clean
+- `npm run build` → succeeds in 4.14s
+
+### Full implementation verification:
+Confirmed all 11 implementation items present and integrated:
+1. DashboardLayout.tsx — MobileBottomNav imported, useIsMobileNav used, responsive padding
+2. Sidebar.tsx — returns null at <600px
+3. MobileBottomNav.tsx — 56px tab bar + Framer Motion drawer
+4. useIsMobileNav.ts — single source of truth (max-width: 599px)
+5. ChatWidget.tsx — bottom offset calc for mobile nav
+6. index.css — all responsive CSS rules present
+7. Card.tsx — card-base class applied
+8. PatientSummaryTile.tsx — clamp(22px, 6vw, 30px) for KPI values
+9. ProjectsTile.tsx — 1 card per view at <480px
+10. useForceSimulation.ts — 380px height at <480px
+11. tailwind.config.js — xxs: 360px breakpoint
+
+### Task status: No open tasks remain.
+
+All success criteria met. Emitting LOOP_COMPLETE.

.ralph/agent/summary.md

@@ -0,0 +1,17 @@
+# Loop Summary
+
+**Status:** Completed successfully
+**Iterations:** 5
+**Duration:** 19m 23s
+
+## Tasks
+
+_No scratchpad found._
+
+## Events
+
+_No events recorded._
+
+## Final Commit
+
+025f860: Loop prep

.ralph/current-events

@@ -0,0 +1 @@
+.ralph/events-20260217-205901.jsonl

.ralph/current-loop-id

@@ -0,0 +1 @@
+primary-20260217-205901

.ralph/events-20260217-205901.jsonl

@@ -0,0 +1,7 @@
+{"ts":"2026-02-17T20:59:01.382091923+00:00","iteration":0,"hat":"loop","topic":"work.start","triggered":"planner","payload":"# Task: Fix Mobile Responsiveness for Small Viewport Widths (≤430px)\n\nThe portfolio website is broken on phones with viewport widths around 400px. Text overflows off-screen, elements are hidden behind `overflow: hidden`, and layout components are sized inappropriately for small screens.\n\n## Context\n\n- **Tech stack:** React + TypeScript + Tailwind CSS + Framer Motion + D3\n- **Dev server:** `npm run dev` (localhost:5173)\n- **Quality gates:** `npm run lint && npm run typecheck && npm run build`\n-... [truncated, 6122 chars total]"}
+{"payload":"Comprehensive 8-phase plan written to .ralph/plan.md. Covers sidebar→bottom-nav conversion, spacing reduction, KPI grid, carousel, timeline overflow, constellation sizing, detail panel, and skills grid. 11 files affected.","topic":"plan.ready","ts":"2026-02-17T21:02:20.892705229+00:00"}
+{"payload":"All 8 phases implemented. lint: 0 errors, typecheck: pass, build: pass. 10 files modified + 1 new (MobileBottomNav.tsx). Bottom nav, spacing, KPI grid, carousel, constellation, detail panel all fixed for 320-430px.","topic":"build.done","ts":"2026-02-17T21:08:34.938897608+00:00"}
+{"payload":"lint: 0 errors 6 warnings, typecheck: clean, build: success. Fixed: shared useIsMobileNav hook, chat widget offset gap, drawer a11y (Escape key, button backdrop)","topic":"build.done","ts":"2026-02-17T21:15:17.884340466+00:00"}
+{"payload":"lint: 0 errors, typecheck: clean, build: success. All 8 responsive phases implemented. Ready for visual review.","topic":"build.done","ts":"2026-02-17T21:17:46.100718553+00:00"}
+{"payload":"All responsive fixes implemented and verified. Quality gates pass (lint 0 errors, typecheck clean, build succeeds). All 11 implementation items confirmed across MobileBottomNav, useIsMobileNav, DashboardLayout, Sidebar, ChatWidget, index.css, Card, PatientSummaryTile, ProjectsTile, useForceSimulation, tailwind.config.","topic":"LOOP_COMPLETE","ts":"2026-02-17T21:19:31.407813400+00:00"}
+{"ts":"2026-02-17T21:19:40.085442571+00:00","iteration":5,"hat":"loop","topic":"loop.terminate","payload":"## Reason\ncompleted\n\n## Status\nAll tasks completed successfully.\n\n## Summary\n- Iterations: 5\n- Duration: 19m 23s\n- Exit code: 0"}

.ralph/loop.lock

@@ -0,0 +1,5 @@
+{
+  "pid": 2260063,
+  "started": "2026-02-17T20:59:01.374161099Z",
+  "prompt": "# Task: Fix Mobile Responsiveness for Small Viewport Widths (≤430px)\n\nThe portfolio website is br..."
+}

.ralph/plan.md

@@ -0,0 +1,300 @@
+# Mobile Responsiveness Fix Plan (320-430px)
+
+## Overview
+
+At viewport widths 320-430px, the dashboard is broken: sidebar rail steals 64px, padding steals 40px, leaving only 216-326px for content. This plan fixes all issues in priority order, grouped by file.
+
+---
+
+## Phase 1: Sidebar → Bottom Nav Bar (Critical)
+
+### 1A. Add `xxs` breakpoint to Tailwind (`tailwind.config.js`)
+
+**What:** Add a new breakpoint `xxs: '360px'` below the existing `xs: 480px`.
+
+**Why:** Enables Tailwind utility classes for sub-480px styling. Also useful for font/spacing adjustments.
+
+```js
+screens: {
+  'xxs': '360px',  // NEW
+  'xs': '480px',
+  ...
+}
+```
+
+### 1B. Create `MobileBottomNav` component (`src/components/MobileBottomNav.tsx`)
+
+**What:** New component that renders a bottom navigation bar at viewports <600px.
+
+**Collapsed state (default):**
+- Fixed to bottom edge, 56px tall, full width
+- Background: `var(--sidebar-bg)` with top border `var(--border)`
+- Contains: 3 nav icons (Overview, Experience, Skills) + hamburger/menu icon for drawer
+- Icons from existing `navSections` in Sidebar.tsx (reuse `UserRound`, `Workflow`, `Wrench`)
+- Active state: teal accent color, same as sidebar
+- Touch targets: each icon button is 44x44px minimum
+
+**Expanded state (drawer):**
+- Triggered by tapping hamburger icon or swiping up
+- Slides up from bottom using Framer Motion `AnimatePresence` + `motion.div`
+- Max height: 70vh, scrollable
+- Contains: full sidebar content (patient name, details, search, tags, alerts)
+- Extract shared content rendering from `Sidebar.tsx` into reusable pieces
+- Backdrop overlay: same `rgba(26,43,42,0.28)` as current sidebar
+- Close: tap backdrop, tap close button, or swipe down
+
+**Implementation:**
+- Use `window.matchMedia('(max-width: 599px)')` to detect mobile
+- Accept same props as Sidebar: `activeSection`, `onNavigate`, `onSearchClick`
+- Do NOT import from Sidebar — reuse the same data sources (`navSections`, `patient`, `tags`, `alerts`)
+
+### 1C. Modify `Sidebar.tsx`
+
+**What:** Hide the sidebar completely at <600px.
+
+**How:** Add a `useMediaQuery` check or pass an `isMobileNav` prop. When viewport is <600px, return `null` (render nothing). The sidebar rail and overlay are replaced by `MobileBottomNav`.
+
+**Important:** All existing sidebar behavior at >=600px must remain unchanged.
+
+### 1D. Modify `DashboardLayout.tsx`
+
+**What:** Integrate MobileBottomNav and adjust main content area.
+
+**Changes:**
+1. Import and render `<MobileBottomNav>` alongside sidebar
+2. Add CSS class or style for bottom padding on main content when bottom nav is visible: `paddingBottom: 'calc(56px + env(safe-area-inset-bottom))'`
+3. The `dashboard-main` margin-left should be 0 at <600px (since sidebar is hidden)
+
+### 1E. Modify `src/index.css`
+
+**What:** Override `dashboard-main` margin-left at <600px.
+
+```css
+@media (max-width: 599px) {
+  .dashboard-main {
+    margin-left: 0;
+  }
+}
+```
+
+---
+
+## Phase 2: Spacing & Padding Reduction (Critical)
+
+### 2A. Reduce main content padding at small viewports (`DashboardLayout.tsx`)
+
+**What:** Change padding from `p-5` (20px) to a smaller value at <480px.
+
+**How:** Update className: `p-3 xs:p-5 pb-10 md:p-7 md:pb-12 lg:px-8 lg:pt-7 lg:pb-12`
+
+This gives 12px padding at <480px instead of 20px, recovering 16px of usable width.
+
+### 2B. Reduce Card padding at small viewports (`Card.tsx`)
+
+**What:** Reduce `padding: '24px'` to 16px at small viewports.
+
+**How:** Use inline responsive logic or a CSS class. Since Card uses inline styles, detect viewport width or add a CSS class:
+
+Option: Add `className="card-base"` and define:
+```css
+.card-base { padding: 24px; }
+@media (max-width: 479px) {
+  .card-base { padding: 16px !important; }
+}
+```
+
+Or use a custom hook for viewport width and adjust inline.
+
+### 2C. Reduce `chronology-item` padding (`index.css`)
+
+**What:** Reduce `padding: 10px 12px 12px` to tighter values at <480px.
+
+```css
+@media (max-width: 479px) {
+  .chronology-item {
+    padding: 8px 8px 10px;
+  }
+}
+```
+
+---
+
+## Phase 3: KPI Grid Fix (Critical)
+
+### 3A. Make KPI grid responsive (`PatientSummaryTile.tsx`)
+
+**What:** Change KPI grid from hardcoded 2-column to responsive.
+
+**How:** Use a CSS class instead of inline `gridTemplateColumns`:
+
+```css
+/* Default: 2 columns */
+.kpi-grid {
+  display: grid;
+  gap: 10px;
+  grid-template-columns: repeat(2, minmax(0, 1fr));
+}
+
+/* Single column at very narrow viewports */
+@media (max-width: 359px) {
+  .kpi-grid {
+    grid-template-columns: 1fr;
+  }
+}
+```
+
+At 360px+ with 2 columns: each card gets ~160px (after removing sidebar, with 12px padding). That's workable.
+At <360px (iPhone SE): single column, full width.
+
+### 3B. Reduce KPI value font size at narrow viewports (`PatientSummaryTile.tsx`)
+
+**What:** Reduce `fontSize: '30px'` on metric values.
+
+**How:** Use `clamp()` or media query: `fontSize: 'clamp(22px, 6vw, 30px)'` — scales from 22px at 320px to 30px at 500px.
+
+---
+
+## Phase 4: Project Carousel Fix (Critical)
+
+### 4A. Use 1 card per view at <480px (`ProjectsTile.tsx`)
+
+**What:** Change `cardsPerView` logic:
+
+```js
+const cardsPerView = useMemo(() => {
+  if (viewportWidth < 480) return 1    // NEW: 1 card at small mobile
+  if (viewportWidth < 768) return 2
+  return 4
+}, [viewportWidth])
+```
+
+At 320px with no sidebar: usable width ~296px → 1 card at ~296px is great.
+
+### 4B. Reduce card min-height at <480px (`ProjectsTile.tsx`)
+
+**What:** Add a smaller min-height tier:
+
+```js
+if (viewportWidth < 480) return 148
+if (viewportWidth < 640) return 168
+```
+
+---
+
+## Phase 5: Timeline & Text Overflow (Important)
+
+### 5A. Allow timeline badges to wrap (`TimelineInterventionsSubsection.tsx`)
+
+**What:** Change the badge container from `flexShrink: 0` to allow wrapping at narrow widths.
+
+**How:** Add `flexWrap: 'wrap'` to the badge container and remove `flexShrink: 0`.
+
+At very narrow widths, badges will wrap below the title instead of forcing overflow.
+
+### 5B. Ensure ExpandableCardShell doesn't clip text (`ExpandableCardShell.tsx`)
+
+**What:** The inner wrapper has `overflow: 'hidden'` which is needed for animation but could clip header text.
+
+**Status:** Currently OK — the `minWidth: 0` on flex children handles text wrapping. The header has `gap: '8px'` and text naturally wraps. No change needed, but monitor.
+
+---
+
+## Phase 6: Constellation Graph (Important)
+
+### 6A. Reduce constellation height at <480px (`useForceSimulation.ts`)
+
+**What:** Change `getHeight()` to return a smaller height for very narrow viewports:
+
+```js
+function getHeight(width: number, containerHeight?: number | null): number {
+  if (width < 480) return 380    // NEW: shorter for small phones
+  if (width < 768) return 520
+  if (containerHeight && containerHeight > 0) return Math.max(400, containerHeight)
+  return 400
+}
+```
+
+520px is disproportionate at 320px wide. 380px keeps it visible without dominating the view.
+
+---
+
+## Phase 7: Detail Panel Polish (Minor)
+
+### 7A. Reduce detail panel body padding at narrow widths (`DetailPanel.tsx`)
+
+**What:** Change `padding: '24px'` to `padding: '16px'` at <480px.
+
+**How:** Add responsive CSS or inline viewport check:
+
+```css
+@media (max-width: 479px) {
+  .detail-panel .detail-panel-body {
+    padding: 16px;
+  }
+}
+```
+
+Or add a `className` to the body div and use CSS.
+
+### 7B. Reduce detail panel header padding (`DetailPanel.tsx`)
+
+**What:** Change `padding: '20px 24px'` to `padding: '16px'` at <480px.
+
+Same approach as 7A.
+
+---
+
+## Phase 8: Medications/Skills Grid (Minor)
+
+### 8A. Already single-column on mobile (`index.css`)
+
+**Status:** `.medications-grid` is already `grid-template-columns: 1fr` at mobile, going to 3 columns at 768px+. No change needed.
+
+---
+
+## Implementation Order
+
+1. **Phase 1** (Sidebar → Bottom Nav) — Most impactful, recovers 64px
+2. **Phase 2** (Spacing) — Recovers 16-32px more
+3. **Phase 3** (KPI grid) — Fixes cramped cards
+4. **Phase 4** (Carousel) — Fixes tiny project cards
+5. **Phase 5** (Timeline) — Fixes potential text overflow
+6. **Phase 6** (Constellation) — Better proportions
+7. **Phase 7** (Detail panel) — Polish
+8. **Phase 8** (Skills grid) — No change needed
+
+## Width Budget After Fixes
+
+| Viewport | Sidebar | Padding | Usable Width | Before |
+|----------|---------|---------|--------------|--------|
+| 320px    | 0px     | 24px    | **296px**    | 216px  |
+| 360px    | 0px     | 24px    | **336px**    | 256px  |
+| 375px    | 0px     | 24px    | **351px**    | 271px  |
+| 400px    | 0px     | 24px    | **376px**    | 296px  |
+| 430px    | 0px     | 24px    | **406px**    | 326px  |
+
+*At <480px: 12px padding each side = 24px total. Card padding: 16px each side = 32px total. Content area inside card: 232-374px.*
+
+## Files Modified
+
+| File | Changes |
+|------|---------|
+| `tailwind.config.js` | Add `xxs: 360px` breakpoint |
+| `src/components/MobileBottomNav.tsx` | **NEW** — bottom nav bar + drawer |
+| `src/components/Sidebar.tsx` | Hide at <600px |
+| `src/components/DashboardLayout.tsx` | Integrate bottom nav, adjust padding |
+| `src/index.css` | Add <600px and <480px media queries |
+| `src/components/Card.tsx` | Responsive padding |
+| `src/components/tiles/PatientSummaryTile.tsx` | KPI grid class, font size clamp |
+| `src/components/tiles/ProjectsTile.tsx` | 1 card per view at <480px |
+| `src/components/TimelineInterventionsSubsection.tsx` | Badge wrapping |
+| `src/hooks/useForceSimulation.ts` | Shorter constellation at <480px |
+| `src/components/DetailPanel.tsx` | Responsive padding |
+
+## Constraints Respected
+
+- No new npm dependencies (Framer Motion already available)
+- No changes to boot/ECG/login screens
+- No D3 simulation logic changes (only container sizing)
+- Desktop/tablet (768px+) completely unchanged
+- PMR aesthetic maintained

src/components/Card.tsx

@@ -28,7 +28,7 @@ export function Card({ children, full, className, tileId }: CardProps) {
   return (
     <article
       style={baseStyles}
-      className={className}
+      className={['card-base', className].filter(Boolean).join(' ')}
       data-tile-id={tileId}
       onMouseEnter={() => setIsHovered(true)}
       onMouseLeave={() => setIsHovered(false)}

src/components/ChatWidget.tsx

@@ -13,6 +13,7 @@ import { buildPaletteData } from '@/lib/search'
 import type { PaletteItem, PaletteAction } from '@/lib/search'
 import { iconByType, iconColorStyles } from '@/lib/palette-icons'
 import { prefersReducedMotion, motionSafeTransition } from '@/lib/utils'
+import { useIsMobileNav } from '@/hooks/useIsMobileNav'
 
 const MAX_HISTORY = 10
 
@@ -52,6 +53,7 @@ interface ChatWidgetProps {
 }
 
 export function ChatWidget({ onAction }: ChatWidgetProps) {
+  const isMobileNav = useIsMobileNav()
   const [isOpen, setIsOpen] = useState(false)
   const [messages, setMessages] = useState<ChatMessage[]>([])
   const [inputValue, setInputValue] = useState('')
@@ -610,8 +612,9 @@ export function ChatWidget({ onAction }: ChatWidgetProps) {
         variants={buttonVariants}
         onClick={() => setIsOpen((prev) => !prev)}
         aria-label={isOpen ? 'Close chat' : 'Open chat'}
-        className={`fixed z-[90] cursor-pointer flex items-center justify-center bottom-4 right-4 h-10 w-10 md:bottom-6 md:right-6 md:h-12 md:w-12${isOpen ? ' max-md:!hidden' : ''}`}
+        className={`fixed z-[101] cursor-pointer flex items-center justify-center bottom-4 right-4 h-10 w-10 md:bottom-6 md:right-6 md:h-12 md:w-12${isOpen ? ' max-md:!hidden' : ''}`}
         style={{
+          bottom: isMobileNav ? 'calc(56px + env(safe-area-inset-bottom) + 16px)' : undefined,
           borderRadius: '50%',
           border: 'none',
           background: 'var(--accent)',

src/components/DashboardLayout.tsx

@@ -1,6 +1,7 @@
 import { useState, useEffect, useCallback, useRef, useMemo } from 'react'
 import { motion } from 'framer-motion'
 import Sidebar from './Sidebar'
+import { MobileBottomNav } from './MobileBottomNav'
 import { CommandPalette } from './CommandPalette'
 import { DetailPanel } from './DetailPanel'
 import { PatientSummaryTile } from './tiles/PatientSummaryTile'
@@ -11,6 +12,7 @@ import { RepeatMedicationsSubsection } from './RepeatMedicationsSubsection'
 import { LastConsultationCard } from './LastConsultationCard'
 import { ChatWidget } from './ChatWidget'
 import { useActiveSection } from '@/hooks/useActiveSection'
+import { useIsMobileNav } from '@/hooks/useIsMobileNav'
 import { useDetailPanel } from '@/contexts/DetailPanelContext'
 import { timelineConsultations, timelineEntities } from '@/data/timeline'
 import { skills } from '@/data/skills'
@@ -41,6 +43,7 @@ export function DashboardLayout() {
   const [highlightedRoleId, setHighlightedRoleId] = useState<string | null>(null)
   const [chronologyHeight, setChronologyHeight] = useState<number | null>(null)
   const [constellationReady, setConstellationReady] = useState(false)
+  const isMobileNav = useIsMobileNav()
   const chronologyRef = useRef<HTMLDivElement>(null)
   const patientSummaryRef = useRef<HTMLDivElement>(null)
   const activeSection = useActiveSection()
@@ -250,6 +253,7 @@ export function DashboardLayout() {
           height: '100%',
         }}
       >
+        {!isMobileNav && (
           <motion.div
             initial="hidden"
             animate="visible"
@@ -262,6 +266,7 @@ export function DashboardLayout() {
               onSearchClick={handleSearchClick}
             />
           </motion.div>
+        )}
 
         <motion.main
           id="main-content"
@@ -269,10 +274,11 @@ export function DashboardLayout() {
           animate="visible"
           variants={contentVariants}
           aria-label="Dashboard content"
-          className="dashboard-main pmr-scrollbar p-5 pb-10 md:p-7 md:pb-12 lg:px-8 lg:pt-7 lg:pb-12"
+          className="dashboard-main pmr-scrollbar p-3 xs:p-5 pb-10 md:p-7 md:pb-12 lg:px-8 lg:pt-7 lg:pb-12"
           style={{
             flex: 1,
             overflowY: 'auto',
+            paddingBottom: isMobileNav ? 'calc(56px + env(safe-area-inset-bottom) + 16px)' : undefined,
           }}
         >
           <div className="dashboard-grid">
@@ -330,6 +336,13 @@ export function DashboardLayout() {
 
       {/* Floating chat widget */}
       <ChatWidget onAction={handlePaletteAction} />
+
+      {/* Mobile bottom navigation */}
+      <MobileBottomNav
+        activeSection={activeSection}
+        onNavigate={scrollToSection}
+        onSearchClick={handleSearchClick}
+      />
     </div>
   )
 }

src/components/DetailPanel.tsx

@@ -129,6 +129,7 @@ export function DetailPanel() {
       >
         {/* Header */}
         <div
+          data-panel-header=""
           style={{
             display: 'flex',
             alignItems: 'center',
@@ -199,6 +200,7 @@ export function DetailPanel() {
 
         {/* Body (scrollable) */}
         <div
+          data-panel-body=""
           style={{
             flex: 1,
             overflowY: 'auto',

src/components/MobileBottomNav.tsx

@@ -0,0 +1,388 @@
+import { useState, useEffect, useCallback } from 'react'
+import { motion, AnimatePresence } from 'framer-motion'
+import {
+  Menu,
+  Search,
+  UserRound,
+  Workflow,
+  Wrench,
+  X,
+  AlertCircle,
+  AlertTriangle,
+} from 'lucide-react'
+import { CvmisLogo } from './CvmisLogo'
+import { PhoneCaptcha } from './PhoneCaptcha'
+import { patient } from '@/data/patient'
+import { tags } from '@/data/tags'
+import { alerts } from '@/data/alerts'
+import { getSidebarCopy } from '@/lib/profile-content'
+import type { Tag, Alert } from '@/types/pmr'
+import { prefersReducedMotion } from '@/lib/utils'
+import { useIsMobileNav } from '@/hooks/useIsMobileNav'
+
+interface MobileBottomNavProps {
+  activeSection: string
+  onNavigate: (tileId: string) => void
+  onSearchClick: () => void
+}
+
+const navItems = [
+  { id: 'overview', label: 'Overview', tileId: 'patient-summary', Icon: UserRound },
+  { id: 'experience', label: 'Experience', tileId: 'section-experience', Icon: Workflow },
+  { id: 'skills', label: 'Skills', tileId: 'section-skills', Icon: Wrench },
+]
+
+function TagPill({ tag }: { tag: Tag }) {
+  const styles: Record<Tag['colorVariant'], React.CSSProperties> = {
+    teal: {
+      background: 'var(--accent-light)',
+      color: 'var(--accent)',
+      border: '1px solid var(--accent-border)',
+    },
+    amber: {
+      background: 'var(--amber-light)',
+      color: 'var(--amber)',
+      border: '1px solid var(--amber-border)',
+    },
+    green: {
+      background: 'var(--success-light)',
+      color: 'var(--success)',
+      border: '1px solid var(--success-border)',
+    },
+  }
+
+  return (
+    <span
+      style={{
+        display: 'inline-flex',
+        fontSize: '12px',
+        fontWeight: 500,
+        padding: '4px 10px',
+        borderRadius: '4px',
+        lineHeight: 1.3,
+        ...styles[tag.colorVariant],
+      }}
+    >
+      {tag.label}
+    </span>
+  )
+}
+
+function AlertFlag({ alert }: { alert: Alert }) {
+  const Icon = alert.icon === 'AlertTriangle' ? AlertTriangle : AlertCircle
+
+  const styles: Record<Alert['severity'], React.CSSProperties> = {
+    alert: {
+      background: 'var(--alert-light)',
+      color: 'var(--alert)',
+      border: '1px solid var(--alert-border)',
+    },
+    amber: {
+      background: 'var(--amber-light)',
+      color: 'var(--amber)',
+      border: '1px solid var(--amber-border)',
+    },
+  }
+
+  return (
+    <div
+      style={{
+        display: 'flex',
+        alignItems: 'center',
+        gap: '8px',
+        fontSize: '13px',
+        fontWeight: 700,
+        padding: '8px 12px',
+        borderRadius: 'var(--radius-sm)',
+        letterSpacing: '0.02em',
+        ...styles[alert.severity],
+      }}
+    >
+      <div style={{ width: '18px', height: '18px', flexShrink: 0, display: 'flex', alignItems: 'center', justifyContent: 'center' }}>
+        <Icon size={16} strokeWidth={2.5} />
+      </div>
+      <span>{alert.message}</span>
+    </div>
+  )
+}
+
+export function MobileBottomNav({ activeSection, onNavigate, onSearchClick }: MobileBottomNavProps) {
+  const isMobileNav = useIsMobileNav()
+  const [drawerOpen, setDrawerOpen] = useState(false)
+  const sidebarCopy = getSidebarCopy()
+
+  useEffect(() => {
+    if (!isMobileNav) setDrawerOpen(false)
+  }, [isMobileNav])
+
+  const handleDrawerKeyDown = useCallback((e: React.KeyboardEvent) => {
+    if (e.key === 'Escape') setDrawerOpen(false)
+  }, [])
+
+  if (!isMobileNav) return null
+
+  const handleNav = (tileId: string) => {
+    onNavigate(tileId)
+    setDrawerOpen(false)
+  }
+
+  return (
+    <>
+      {/* Bottom tab bar */}
+      <nav
+        aria-label="Mobile navigation"
+        style={{
+          position: 'fixed',
+          bottom: 0,
+          left: 0,
+          right: 0,
+          height: '56px',
+          background: 'var(--sidebar-bg)',
+          borderTop: '1px solid var(--border)',
+          display: 'flex',
+          alignItems: 'center',
+          justifyContent: 'space-around',
+          zIndex: 100,
+          paddingBottom: 'env(safe-area-inset-bottom)',
+        }}
+      >
+        {navItems.map((item) => {
+          const isActive = activeSection === item.id
+          return (
+            <button
+              key={item.id}
+              type="button"
+              onClick={() => handleNav(item.tileId)}
+              aria-current={isActive ? 'page' : undefined}
+              aria-label={item.label}
+              style={{
+                display: 'flex',
+                flexDirection: 'column',
+                alignItems: 'center',
+                justifyContent: 'center',
+                gap: '2px',
+                width: '44px',
+                height: '44px',
+                background: 'transparent',
+                border: 'none',
+                cursor: 'pointer',
+                color: isActive ? 'var(--accent)' : 'var(--text-tertiary)',
+                transition: 'color 150ms',
+              }}
+            >
+              <item.Icon size={20} strokeWidth={isActive ? 2.4 : 2} />
+              <span style={{ fontSize: '10px', fontWeight: isActive ? 600 : 400 }}>{item.label}</span>
+            </button>
+          )
+        })}
+        <button
+          type="button"
+          onClick={() => setDrawerOpen(true)}
+          aria-label="Open menu"
+          style={{
+            display: 'flex',
+            flexDirection: 'column',
+            alignItems: 'center',
+            justifyContent: 'center',
+            gap: '2px',
+            width: '44px',
+            height: '44px',
+            background: 'transparent',
+            border: 'none',
+            cursor: 'pointer',
+            color: 'var(--text-tertiary)',
+            transition: 'color 150ms',
+          }}
+        >
+          <Menu size={20} strokeWidth={2} />
+          <span style={{ fontSize: '10px', fontWeight: 400 }}>More</span>
+        </button>
+      </nav>
+
+      {/* Drawer */}
+      <AnimatePresence>
+        {drawerOpen && (
+          <>
+            <motion.button
+              type="button"
+              aria-label="Close menu"
+              initial={{ opacity: 0 }}
+              animate={{ opacity: 1 }}
+              exit={{ opacity: 0 }}
+              transition={prefersReducedMotion ? { duration: 0 } : { duration: 0.2 }}
+              onClick={() => setDrawerOpen(false)}
+              style={{
+                position: 'fixed',
+                inset: 0,
+                background: 'rgba(26,43,42,0.28)',
+                border: 'none',
+                cursor: 'pointer',
+                zIndex: 200,
+              }}
+            />
+            <motion.div
+              initial={prefersReducedMotion ? { y: 0 } : { y: '100%' }}
+              animate={{ y: 0 }}
+              exit={prefersReducedMotion ? { y: 0 } : { y: '100%' }}
+              transition={prefersReducedMotion ? { duration: 0 } : { type: 'spring', damping: 28, stiffness: 300 }}
+              className="pmr-scrollbar"
+              onKeyDown={handleDrawerKeyDown}
+              style={{
+                position: 'fixed',
+                bottom: 0,
+                left: 0,
+                right: 0,
+                maxHeight: '70vh',
+                background: 'var(--sidebar-bg)',
+                borderTop: '1px solid var(--border)',
+                borderRadius: '16px 16px 0 0',
+                overflowY: 'auto',
+                padding: '16px',
+                zIndex: 201,
+              }}
+            >
+              {/* Drawer handle */}
+              <div style={{ display: 'flex', justifyContent: 'center', marginBottom: '12px' }}>
+                <div style={{ width: '36px', height: '4px', borderRadius: '2px', background: 'var(--border)' }} />
+              </div>
+
+              {/* Close button */}
+              <div style={{ display: 'flex', justifyContent: 'flex-end', marginBottom: '8px' }}>
+                <button
+                  type="button"
+                  onClick={() => setDrawerOpen(false)}
+                  aria-label="Close menu"
+                  style={{
+                    display: 'flex',
+                    alignItems: 'center',
+                    justifyContent: 'center',
+                    width: '44px',
+                    height: '44px',
+                    background: 'transparent',
+                    border: '1px solid var(--border-light)',
+                    borderRadius: 'var(--radius-sm)',
+                    cursor: 'pointer',
+                    color: 'var(--text-secondary)',
+                  }}
+                >
+                  <X size={18} />
+                </button>
+              </div>
+
+              {/* Logo + search */}
+              <div style={{ display: 'flex', alignItems: 'flex-end', gap: '6px', marginBottom: '12px' }}>
+                <CvmisLogo cssHeight="40px" />
+                <button
+                  type="button"
+                  onClick={() => { onSearchClick(); setDrawerOpen(false) }}
+                  className="sidebar-control"
+                  aria-label={sidebarCopy.searchAriaLabel}
+                  style={{
+                    width: '100%',
+                    minHeight: '44px',
+                    border: '1px solid var(--border)',
+                    borderRadius: 'var(--radius-sm)',
+                    background: 'var(--surface)',
+                    color: 'var(--text-secondary)',
+                    display: 'flex',
+                    alignItems: 'center',
+                    gap: '8px',
+                    padding: '0 10px',
+                    cursor: 'pointer',
+                  }}
+                >
+                  <Search size={16} style={{ color: 'var(--text-tertiary)', flexShrink: 0 }} />
+                  <span style={{ flex: 1, textAlign: 'left', fontSize: '13px' }}>{sidebarCopy.searchLabel}</span>
+                </button>
+              </div>
+
+              {/* Patient info */}
+              <section style={{ borderBottom: '2px solid var(--accent)', paddingBottom: '12px', marginBottom: '12px' }}>
+                <div style={{ display: 'flex', alignItems: 'center', gap: '10px', marginBottom: '8px' }}>
+                  <div
+                    style={{
+                      width: '44px',
+                      height: '44px',
+                      borderRadius: '50%',
+                      background: 'linear-gradient(135deg, var(--accent), #0A8080)',
+                      display: 'flex',
+                      alignItems: 'center',
+                      justifyContent: 'center',
+                      color: '#FFFFFF',
+                      fontSize: '16px',
+                      fontWeight: 700,
+                      flexShrink: 0,
+                    }}
+                  >
+                    AC
+                  </div>
+                  <div>
+                    <div style={{ fontSize: '15px', fontWeight: 700, color: 'var(--text-primary)' }}>
+                      CHARLWOOD, Andrew
+                    </div>
+                    <div style={{ fontSize: '12px', fontFamily: 'Geist Mono, monospace', color: 'var(--text-secondary)' }}>
+                      {sidebarCopy.roleTitle}
+                    </div>
+                  </div>
+                </div>
+
+                <div style={{ display: 'grid', gap: '6px' }}>
+                  {[
+                    { label: sidebarCopy.gphcLabel, value: patient.nhsNumber.replace(/\s/g, ''), mono: true },
+                    { label: sidebarCopy.educationLabel, value: patient.qualification },
+                    { label: sidebarCopy.locationLabel, value: patient.address },
+                    { label: sidebarCopy.registeredLabel, value: patient.registrationYear },
+                  ].map(({ label, value, mono }) => (
+                    <div key={label} style={{ display: 'flex', justifyContent: 'space-between', alignItems: 'center', fontSize: '13px', padding: '2px 0' }}>
+                      <span style={{ color: 'var(--text-tertiary)' }}>{label}</span>
+                      <span style={{ color: 'var(--text-primary)', fontWeight: 500, textAlign: 'right', fontFamily: mono ? 'Geist Mono, monospace' : undefined, fontSize: mono ? '12px' : undefined, letterSpacing: mono ? '0.12em' : undefined }}>
+                        {value}
+                      </span>
+                    </div>
+                  ))}
+                  <div style={{ display: 'flex', justifyContent: 'space-between', alignItems: 'center', fontSize: '13px', padding: '2px 0' }}>
+                    <span style={{ color: 'var(--text-tertiary)' }}>{sidebarCopy.phoneLabel}</span>
+                    <PhoneCaptcha phone={patient.phone} />
+                  </div>
+                  <div style={{ display: 'flex', justifyContent: 'space-between', alignItems: 'center', fontSize: '13px', padding: '2px 0' }}>
+                    <span style={{ color: 'var(--text-tertiary)' }}>{sidebarCopy.emailLabel}</span>
+                    <a
+                      href={`mailto:${patient.email}`}
+                      style={{ color: 'var(--accent)', fontWeight: 500, textDecoration: 'none', textAlign: 'right' }}
+                    >
+                      {patient.email}
+                    </a>
+                  </div>
+                </div>
+              </section>
+
+              {/* Tags */}
+              <section style={{ marginBottom: '12px' }}>
+                <div style={{ fontSize: '11px', fontWeight: 600, textTransform: 'uppercase', letterSpacing: '0.08em', color: 'var(--text-tertiary)', marginBottom: '8px' }}>
+                  {sidebarCopy.tagsTitle}
+                </div>
+                <div style={{ display: 'flex', flexWrap: 'wrap', gap: '5px' }}>
+                  {tags.map((tag) => (
+                    <TagPill key={tag.label} tag={tag} />
+                  ))}
+                </div>
+              </section>
+
+              {/* Alerts */}
+              <section>
+                <div style={{ fontSize: '11px', fontWeight: 600, textTransform: 'uppercase', letterSpacing: '0.08em', color: 'var(--text-tertiary)', marginBottom: '8px' }}>
+                  {sidebarCopy.alertsTitle}
+                </div>
+                <div style={{ display: 'flex', flexDirection: 'column', gap: '6px' }}>
+                  {alerts.map((alert, index) => (
+                    <AlertFlag key={index} alert={alert} />
+                  ))}
+                </div>
+              </section>
+            </motion.div>
+          </>
+        )}
+      </AnimatePresence>
+    </>
+  )
+}

src/components/Sidebar.tsx

@@ -11,6 +11,7 @@ import {
   Wrench,
   X,
 } from 'lucide-react'
+import { useIsMobileNav } from '@/hooks/useIsMobileNav'
 import { CvmisLogo } from './CvmisLogo'
 import { PhoneCaptcha } from './PhoneCaptcha'
 import { patient } from '@/data/patient'
@@ -163,6 +164,7 @@ function AlertFlag({ alert }: AlertFlagProps) {
 export default function Sidebar({ activeSection, onNavigate, onSearchClick }: SidebarProps) {
   const sidebarCopy = getSidebarCopy()
   const [isDesktop, setIsDesktop] = useState(() => window.matchMedia('(min-width: 1024px)').matches)
+  const isMobileNav = useIsMobileNav()
   const [isMobileExpanded, setIsMobileExpanded] = useState(false)
 
   useEffect(() => {
@@ -180,7 +182,9 @@ export default function Sidebar({ activeSection, onNavigate, onSearchClick }: Si
     const listener = (event: MediaQueryListEvent) => updateDesktopState(event)
     mediaQuery.addEventListener('change', listener)
 
-    return () => mediaQuery.removeEventListener('change', listener)
+    return () => {
+      mediaQuery.removeEventListener('change', listener)
+    }
   }, [])
 
   const isExpanded = isDesktop || isMobileExpanded
@@ -192,6 +196,8 @@ export default function Sidebar({ activeSection, onNavigate, onSearchClick }: Si
     }
   }
 
+  if (isMobileNav) return null
+
   return (
     <>
       {!isDesktop && isMobileExpanded && (

src/components/tiles/PatientSummaryTile.tsx

@@ -44,7 +44,7 @@ function MetricCard({ kpi }: MetricCardProps) {
   }
 
   const valueStyles: React.CSSProperties = {
-    fontSize: '30px',
+    fontSize: 'clamp(22px, 6vw, 30px)',
     fontWeight: 700,
     letterSpacing: '-0.02em',
     lineHeight: 1.2,
@@ -121,7 +121,6 @@ export function PatientSummaryTile() {
   const kpiGridStyles: React.CSSProperties = {
     display: 'grid',
     gap: '10px',
-    gridTemplateColumns: 'repeat(2, minmax(0, 1fr))',
   }
 
   return (
@@ -144,7 +143,7 @@ export function PatientSummaryTile() {
             {latestResultsCopy.helperText}
           </p>
         </div>
-        <div className="latest-results-grid" style={kpiGridStyles}>
+        <div className="kpi-grid latest-results-grid" style={kpiGridStyles}>
           {kpis.map((kpi) => (
             <MetricCard key={kpi.id} kpi={kpi} />
           ))}

src/components/tiles/ProjectsTile.tsx

@@ -318,9 +318,8 @@ export function ProjectsCarousel() {
   }, [prefersReducedMotion, viewportWidth])
 
   const cardsPerView = useMemo(() => {
-    if (viewportWidth < 768) {
+    if (viewportWidth < 480) return 1
-      return 2
+    if (viewportWidth < 768) return 2
-    }
     return 4
   }, [viewportWidth])
 
@@ -332,15 +331,10 @@ export function ProjectsCarousel() {
   }, [cardsPerView, viewportWidth])
 
   const cardMinHeight = useMemo(() => {
-    if (viewportWidth < 640) {
+    if (viewportWidth < 480) return 148
-      return 168
+    if (viewportWidth < 640) return 168
-    }
+    if (viewportWidth < 1024) return 182
-    if (viewportWidth < 1024) {
+    if (viewportWidth < 1440) return 196
-      return 182
-    }
-    if (viewportWidth < 1440) {
-      return 196
-    }
     return 214
   }, [viewportWidth])
 

src/hooks/useForceSimulation.ts

@@ -42,6 +42,7 @@ function fractionalYear(node: { startDate?: string; startYear?: number }): numbe
 }
 
 function getHeight(width: number, containerHeight?: number | null): number {
+  if (width < 480) return 380
   if (width < 768) return 520
   if (containerHeight && containerHeight > 0) return Math.max(400, containerHeight)
   return 400

src/hooks/useIsMobileNav.ts

@@ -0,0 +1,18 @@
+import { useState, useEffect } from 'react'
+
+const MOBILE_NAV_QUERY = '(max-width: 599px)'
+
+export function useIsMobileNav(): boolean {
+  const [isMobileNav, setIsMobileNav] = useState(
+    () => window.matchMedia(MOBILE_NAV_QUERY).matches,
+  )
+
+  useEffect(() => {
+    const mq = window.matchMedia(MOBILE_NAV_QUERY)
+    const handler = (e: MediaQueryListEvent) => setIsMobileNav(e.matches)
+    mq.addEventListener('change', handler)
+    return () => mq.removeEventListener('change', handler)
+  }, [])
+
+  return isMobileNav
+}

src/index.css

@@ -591,6 +591,46 @@ textarea:focus-visible {
   }
 }
 
+/* ===== MOBILE RESPONSIVE FIXES (<600px) ===== */
+@media (max-width: 599px) {
+  .dashboard-main {
+    margin-left: 0;
+  }
+}
+
+/* ===== SMALL VIEWPORT FIXES (<480px) ===== */
+@media (max-width: 479px) {
+  .card-base {
+    padding: 16px !important;
+  }
+
+  .chronology-item {
+    padding: 8px 8px 10px;
+  }
+}
+
+/* KPI grid — responsive columns */
+.kpi-grid {
+  grid-template-columns: repeat(2, minmax(0, 1fr));
+}
+
+@media (max-width: 359px) {
+  .kpi-grid {
+    grid-template-columns: 1fr;
+  }
+}
+
+/* Detail panel responsive padding */
+@media (max-width: 479px) {
+  .detail-panel [data-panel-body] {
+    padding: 16px !important;
+  }
+
+  .detail-panel [data-panel-header] {
+    padding: 16px !important;
+  }
+}
+
 @media (prefers-reduced-motion: reduce) {
   /* Disable pulse animation on status badge dot */
   @keyframes pulse {

tailwind.config.js

@@ -6,6 +6,7 @@ export default {
   ],
   theme: {
     screens: {
+      'xxs': '360px',
       'xs': '480px',
       'sm': '640px',
       'md': '768px',