DaxtonD · DaxtonD · Feb 8, 2026 · Feb 8, 2026
diff --git a/.gitignore b/.gitignore
@@ -26,3 +26,9 @@ logs/
 # Local scratch / testing artifacts
 /1.mp4
 /frames-focus/
+
+# Runtime uploads (served from /uploads)
+/uploads/
+
+# Local capture artifacts
+/drag ghosting.mp4
diff --git a/client-dist/assets/index-zH6tZKqf.css → client-dist/assets/index-8QhtjFsl.css b/client-dist/assets/index-zH6tZKqf.css → client-dist/assets/index-8QhtjFsl.css
diff --git a/client-dist/assets/index-CIHictPt.js b/client-dist/assets/index-CIHictPt.js
diff --git a/client-dist/assets/index-DwDMtocl.js b/client-dist/assets/index-DwDMtocl.js
diff --git a/client-dist/assets/manifest-D-CrtgCD.webmanifest b/client-dist/assets/manifest-D-CrtgCD.webmanifest
@@ -0,0 +1,13 @@
+{
+  "name": "FreemanNotes",
+  "short_name": "Freeman",
+  "start_url": "/",
+  "scope": "/",
+  "display": "standalone",
+  "background_color": "#121212",
+  "theme_color": "#121212",
+  "icons": [
+    { "src": "/icons/icon-192.png", "sizes": "192x192", "type": "image/png", "purpose": "any maskable" },
+    { "src": "/icons/icon-512.png", "sizes": "512x512", "type": "image/png", "purpose": "any maskable" }
+  ]
+}
diff --git a/client-dist/assets/manifest-DdfYsMAL.webmanifest b/client-dist/assets/manifest-DdfYsMAL.webmanifest
diff --git a/client-dist/icons/icon-192.png b/client-dist/icons/icon-192.png
diff --git a/client-dist/icons/icon-512.png b/client-dist/icons/icon-512.png
diff --git a/client-dist/index.html b/client-dist/index.html
@@ -5,9 +5,9 @@
     <meta name="viewport" content="width=device-width,initial-scale=1" />
     <title>FreemanNotes — Phase 1</title>
     <link rel="icon" href="/icons/darkicon.png" type="image/png" />
-    <link rel="manifest" href="/assets/manifest-DdfYsMAL.webmanifest" />
-    <script type="module" crossorigin src="/assets/index-CIHictPt.js"></script>
-    <link rel="stylesheet" crossorigin href="/assets/index-zH6tZKqf.css">
+    <link rel="manifest" href="/assets/manifest-D-CrtgCD.webmanifest" />
+    <script type="module" crossorigin src="/assets/index-DwDMtocl.js"></script>
+    <link rel="stylesheet" crossorigin href="/assets/index-8QhtjFsl.css">
   </head>
   <body>
     <div id="root"></div>

diff --git a/client-dist/sw.js b/client-dist/sw.js
@@ -0,0 +1,16 @@
+// Minimal service worker to satisfy PWA installability criteria.
+// Intentionally no offline caching yet; fetch is pass-through.
+
+self.addEventListener('install', (event) => {
+  try { self.skipWaiting(); } catch {}
+});
+
+self.addEventListener('activate', (event) => {
+  event.waitUntil((async () => {
+    try { await self.clients.claim(); } catch {}
+  })());
+});
+
+self.addEventListener('fetch', (event) => {
+  // No-op: allow browser to handle requests normally.
+});
diff --git a/client/manifest.webmanifest b/client/manifest.webmanifest
@@ -2,11 +2,12 @@
   "name": "FreemanNotes",
   "short_name": "Freeman",
   "start_url": "/",
+  "scope": "/",
   "display": "standalone",
   "background_color": "#121212",
   "theme_color": "#121212",
   "icons": [
-    { "src": "/icons/darkicon.png", "sizes": "any", "type": "image/png", "purpose": "any maskable" },
-    { "src": "/icons/freemannotes-dark.svg", "sizes": "512x512", "type": "image/svg+xml", "purpose": "any maskable" }
+    { "src": "/icons/icon-192.png", "sizes": "192x192", "type": "image/png", "purpose": "any maskable" },
+    { "src": "/icons/icon-512.png", "sizes": "512x512", "type": "image/png", "purpose": "any maskable" }
   ]
 }
diff --git a/client/public/icons/icon-192.png b/client/public/icons/icon-192.png
diff --git a/client/public/icons/icon-512.png b/client/public/icons/icon-512.png
diff --git a/client/public/sw.js b/client/public/sw.js
@@ -0,0 +1,16 @@
+// Minimal service worker to satisfy PWA installability criteria.
+// Intentionally no offline caching yet; fetch is pass-through.
+
+self.addEventListener('install', (event) => {
+  try { self.skipWaiting(); } catch {}
+});
+
+self.addEventListener('activate', (event) => {
+  event.waitUntil((async () => {
+    try { await self.clients.claim(); } catch {}
+  })());
+});
+
+self.addEventListener('fetch', (event) => {
+  // No-op: allow browser to handle requests normally.
+});
diff --git a/client/src/App.tsx b/client/src/App.tsx
@@ -2,9 +2,11 @@ import React from "react";
 import Header from "./components/Header";
 import Sidebar from "./components/Sidebar";
 import AuthGate from "./components/AuthGate";
+import PwaInstallModal from "./components/PwaInstallModal";
 import { AuthProvider, useAuth } from "./authContext";
 import { ThemeProvider } from "./themeContext";
 import { DEFAULT_SORT_CONFIG, SortConfig } from './sortTypes';
+import { usePwaInstall } from './lib/pwaInstall';
 
 /**
  * Phase 1 app shell.
@@ -22,6 +24,9 @@ export default function App(): JSX.Element {
 
 function AppShell(): JSX.Element {
 	const { user, token } = useAuth();
+	const { canInstall, isInstalled } = usePwaInstall();
+	const [showPwaInstall, setShowPwaInstall] = React.useState(false);
+	const lastPwaNudgeAtRef = React.useRef<number>(0);
 	const [selectedLabelIds, setSelectedLabelIds] = React.useState<number[]>([]);
 	const [selectedCollaboratorId, setSelectedCollaboratorId] = React.useState<number | null>(null);
 	const [collectionStack, setCollectionStack] = React.useState<Array<{ id: number; name: string }>>([]);
@@ -101,6 +106,26 @@ function AppShell(): JSX.Element {
 		};
 	}, []);
 
+	React.useEffect(() => {
+		// We can’t show the native browser install prompt without a user gesture.
+		// Instead, show our own modal nudge when install becomes available.
+		if (!user) return;
+		if (isInstalled) return;
+		if (!canInstall) return;
+		try {
+			const now = Date.now();
+			const dismissedAt = Number(localStorage.getItem('pwa.installNudge.dismissedAt') || '0') || 0;
+			const coolDownMs = 7 * 24 * 60 * 60 * 1000;
+			if (dismissedAt && (now - dismissedAt) < coolDownMs) return;
+			if (lastPwaNudgeAtRef.current && (now - lastPwaNudgeAtRef.current) < 30_000) return;
+			lastPwaNudgeAtRef.current = now;
+			const t = window.setTimeout(() => {
+				try { setShowPwaInstall(true); } catch {}
+			}, 900);
+			return () => { try { window.clearTimeout(t); } catch {} };
+		} catch {}
+	}, [user, canInstall, isInstalled]);
+
 	React.useEffect(() => {
 		if (!isPhone) return;
 		if (backRootArmedRef.current) return;
@@ -475,6 +500,16 @@ function AppShell(): JSX.Element {
 					</div>
 				</>
 			)}
+
+			{showPwaInstall && (
+				<PwaInstallModal
+					isPhone={isPhone}
+					onClose={() => {
+						try { localStorage.setItem('pwa.installNudge.dismissedAt', String(Date.now())); } catch {}
+						setShowPwaInstall(false);
+					}}
+				/>
+			)}
 		</div>
 	);
 }