Implemented guest-only PWA using vite-plugin-pwa (the actual published package; @vite-pwa/plugin isn’t on npm) with

injectManifest, a new typed SW source, runtime caching, and a non‑blocking update toast with an action button. The
  guest shell now links a dedicated manifest and theme color, and background upload sync is managed in a single
  PwaManager component.

  Key changes (where/why)

  - vite.config.ts: added VitePWA injectManifest config, guest manifest, and output to /public so the SW can control /
    scope.
  - resources/js/guest/guest-sw.ts: new Workbox SW (precache + runtime caching for guest navigation, GET /api/v1/*,
    images, fonts) and preserves push/sync/notification logic.
  - resources/js/guest/components/PwaManager.tsx: registers SW, shows update/offline toasts, and processes the upload
    queue on sync/online.
  - resources/js/guest/components/ToastHost.tsx: action-capable toasts so update prompts can include a CTA.
  - resources/js/guest/i18n/messages.ts: added common.updateAvailable, common.updateAction, common.offlineReady.
  - resources/views/guest.blade.php: manifest + theme color + apple touch icon.
  - .gitignore: ignore generated public/guest-sw.js and public/guest.webmanifest; public/guest-sw.js removed since it’s
    now build output.

resources/js/guest/components/PwaManager.tsx

@@ -0,0 +1,77 @@
+import React from 'react';
+import { registerSW } from 'virtual:pwa-register';
+import { useTranslation } from '../i18n/useTranslation';
+import { useToast } from './ToastHost';
+
+export default function PwaManager() {
+  const toast = useToast();
+  const { t } = useTranslation();
+  const toastRef = React.useRef(toast);
+  const tRef = React.useRef(t);
+  const updatePromptedRef = React.useRef(false);
+
+  React.useEffect(() => {
+    toastRef.current = toast;
+  }, [toast]);
+
+  React.useEffect(() => {
+    tRef.current = t;
+  }, [t]);
+
+  React.useEffect(() => {
+    if (!('serviceWorker' in navigator)) {
+      return;
+    }
+
+    const updateSW = registerSW({
+      immediate: true,
+      onNeedRefresh() {
+        if (updatePromptedRef.current) {
+          return;
+        }
+        updatePromptedRef.current = true;
+        toastRef.current.push({
+          text: tRef.current('common.updateAvailable'),
+          type: 'info',
+          durationMs: 0,
+          action: {
+            label: tRef.current('common.updateAction'),
+            onClick: () => updateSW(true),
+          },
+        });
+      },
+      onOfflineReady() {
+        toastRef.current.push({
+          text: tRef.current('common.offlineReady'),
+          type: 'success',
+        });
+      },
+      onRegisterError(error) {
+        console.warn('Guest PWA registration failed', error);
+      },
+    });
+
+    const runQueue = () => {
+      void import('../queue/queue')
+        .then((m) => m.processQueue().catch(() => {}))
+        .catch(() => {});
+    };
+
+    const handleMessage = (event: MessageEvent) => {
+      if (event.data?.type === 'sync-queue') {
+        runQueue();
+      }
+    };
+
+    navigator.serviceWorker.addEventListener('message', handleMessage);
+    window.addEventListener('online', runQueue);
+    runQueue();
+
+    return () => {
+      navigator.serviceWorker.removeEventListener('message', handleMessage);
+      window.removeEventListener('online', runQueue);
+    };
+  }, []);
+
+  return null;
+}