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/lib/__tests__/motion.test.ts

@@ -0,0 +1,41 @@
+import { describe, expect, it, vi } from 'vitest';
+import { FADE_SCALE, FADE_UP, STAGGER_FAST, getMotionContainerProps, getMotionItemProps, prefersReducedMotion } from '../motion';
+
+describe('motion helpers', () => {
+  it('returns disabled props when motion is off', () => {
+    const props = getMotionContainerProps(false, STAGGER_FAST);
+    expect(props.initial).toBe(false);
+  });
+
+  it('returns variants when motion is on', () => {
+    const containerProps = getMotionContainerProps(true, STAGGER_FAST);
+    const itemProps = getMotionItemProps(true, FADE_UP);
+    expect(containerProps.initial).toBe('hidden');
+    expect(containerProps.animate).toBe('show');
+    expect(itemProps.variants).toBe(FADE_UP);
+  });
+
+  it('detects reduced motion preference safely', () => {
+    const original = window.matchMedia;
+    Object.defineProperty(window, 'matchMedia', {
+      configurable: true,
+      value: undefined,
+    });
+    expect(prefersReducedMotion()).toBe(false);
+
+    Object.defineProperty(window, 'matchMedia', {
+      configurable: true,
+      value: vi.fn().mockReturnValue({ matches: true }),
+    });
+    expect(prefersReducedMotion()).toBe(true);
+
+    Object.defineProperty(window, 'matchMedia', {
+      configurable: true,
+      value: original,
+    });
+  });
+
+  it('exposes distinct base variants', () => {
+    expect(FADE_UP).not.toBe(FADE_SCALE);
+  });
+});

resources/js/guest/lib/motion.ts

@@ -0,0 +1,58 @@
+import type { Variants } from 'framer-motion';
+
+export const IOS_EASE = [0.22, 0.61, 0.36, 1] as const;
+export const IOS_EASE_SOFT = [0.25, 0.8, 0.25, 1] as const;
+
+export const STAGGER_FAST: Variants = {
+  hidden: {},
+  show: {
+    transition: {
+      staggerChildren: 0.06,
+      delayChildren: 0.04,
+    },
+  },
+};
+
+export const FADE_UP: Variants = {
+  hidden: { opacity: 0, y: 10 },
+  show: {
+    opacity: 1,
+    y: 0,
+    transition: {
+      duration: 0.24,
+      ease: IOS_EASE,
+    },
+  },
+};
+
+export const FADE_SCALE: Variants = {
+  hidden: { opacity: 0, scale: 0.98 },
+  show: {
+    opacity: 1,
+    scale: 1,
+    transition: {
+      duration: 0.22,
+      ease: IOS_EASE,
+    },
+  },
+};
+
+export function prefersReducedMotion(): boolean {
+  if (typeof window === 'undefined') {
+    return false;
+  }
+
+  return Boolean(window.matchMedia?.('(prefers-reduced-motion: reduce)')?.matches);
+}
+
+export function getMotionContainerProps(enabled: boolean, variants: Variants) {
+  if (!enabled) {
+    return { initial: false } as const;
+  }
+
+  return { variants, initial: 'hidden', animate: 'show' } as const;
+}
+
+export function getMotionItemProps(enabled: boolean, variants: Variants) {
+  return enabled ? { variants } : {};
+}