From d9891ff9fe5e96bc1a779052885db2ea8a63b503 Mon Sep 17 00:00:00 2001
From: nmemmert <67961292+nmemmert@users.noreply.github.com>
Date: Tue, 27 Oct 2026 15:13:18 -0400
Subject: [PATCH] Pin reader and tab bars to their own compositing layer

iOS Safari/PWA can strand fixed and sticky bars mid-screen after the
toolbar collapses or the page rubber-bands. Add a .fixed-bar class
(translateZ(0), will-change: transform) to the reader top/bottom bars
and the phone tab bar.

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
---
 src/components/reader/ReaderBars.jsx | 4 ++--
 src/components/study/PageShell.jsx   | 2 +-
 src/index.css                        | 8 ++++++++
 3 files changed, 11 insertions(+), 3 deletions(-)

diff --git a/src/components/reader/ReaderBars.jsx b/src/components/reader/ReaderBars.jsx
index 86af8d8..b5f0763 100644
--- a/src/components/reader/ReaderBars.jsx
+++ b/src/components/reader/ReaderBars.jsx
@@ -8,7 +8,7 @@ const iconBtn = 'flex h-9 w-9 items-center justify-center rounded-lg text-[var(-
 
 export function TopBar({ title, onBack, onOpenNavigator, onSearch, onBookmarks, bookmarkCount, onHighlights, highlightCount, onCompare, compareActive, onSettings, onDoneDrawing }) {
   return (
-    <div className="safe-top sticky top-0 z-30 border-b border-[var(--r-line)] bg-[var(--r-bar)] font-sans">
+    <div className="fixed-bar safe-top sticky top-0 z-30 border-b border-[var(--r-line)] bg-[var(--r-bar)] font-sans">
       <div className="mx-auto flex h-12 max-w-4xl items-center gap-1 px-2">
         <HomeButton onClick={onBack} />
         <button type="button" onClick={onOpenNavigator}
@@ -44,7 +44,7 @@ export function BottomBar({
 }) {
   const active = 'text-[var(--r-accent)]';
   return (
-    <div className="fixed inset-x-0 bottom-0 z-30 border-t border-[var(--r-line)] bg-[var(--r-bar)] pb-[env(safe-area-inset-bottom)] font-sans">
+    <div className="fixed-bar fixed inset-x-0 bottom-0 z-30 border-t border-[var(--r-line)] bg-[var(--r-bar)] pb-[env(safe-area-inset-bottom)] font-sans">
       <div className="mx-auto flex h-14 max-w-4xl items-center gap-0.5 px-2">
         <button type="button" onClick={onPrev} disabled={prevDisabled} className={iconBtn} aria-label="Previous chapter" data-tip="Previous chapter (←)"><ChevronLeft /></button>
         <button type="button" onClick={onAudio} className={`${iconBtn} ${audioActive ? active : ''}`} aria-label="Listen" data-tip="Listen to this chapter"><HeadphonesIcon /></button>
diff --git a/src/components/study/PageShell.jsx b/src/components/study/PageShell.jsx
index faaa10b..f40e7a2 100644
--- a/src/components/study/PageShell.jsx
+++ b/src/components/study/PageShell.jsx
@@ -132,7 +132,7 @@ export default function PageShell({ title, onBack, actions, active = null, maxWi
       {phone && (
         <>
           <div aria-hidden="true" className="h-[calc(5rem+env(safe-area-inset-bottom,0px))]" />
-          <nav aria-label="Main" className="fixed inset-x-0 bottom-0 z-30 grid grid-cols-5 border-t border-[var(--r-line)] bg-[var(--r-bar)] pb-[env(safe-area-inset-bottom)]">
+          <nav aria-label="Main" className="fixed-bar fixed inset-x-0 bottom-0 z-30 grid grid-cols-5 border-t border-[var(--r-line)] bg-[var(--r-bar)] pb-[env(safe-area-inset-bottom)]">
             {NAV.map((n) => (
               <button key={n.id} type="button" onClick={go[n.id]} aria-current={active === n.id ? 'page' : undefined} aria-label={n.label}
                 className={`flex min-h-[52px] flex-col items-center justify-center gap-0.5 text-[11px] ${active === n.id ? 'text-[var(--r-text)]' : 'text-[var(--r-sub)]'}`}>
diff --git a/src/index.css b/src/index.css
index a4ec446..e43ed5a 100644
--- a/src/index.css
+++ b/src/index.css
@@ -79,6 +79,14 @@ input,
 
 /* Top bars leave room for the status bar / notch when the app is installed or full-screen
    (env() is 0 in an ordinary browser tab). */
+/* iOS Safari/PWA can leave fixed and sticky bars stranded mid-screen after the toolbar collapses or the page
+   rubber-bands. Giving them their own compositing layer keeps them pinned to the viewport edge. */
+.fixed-bar {
+  transform: translateZ(0);
+  -webkit-transform: translateZ(0);
+  will-change: transform;
+}
+
 .safe-top {
   padding-top: env(safe-area-inset-top, 0px);
 }