@djangocfg/layouts 2.1.36 → 2.1.37

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@djangocfg/layouts",
-  "version": "2.1.36",
+  "version": "2.1.37",
   "description": "Simple, straightforward layout components for Next.js - import and use with props",
   "keywords": [
     "layouts",
@@ -92,9 +92,9 @@
     "check": "tsc --noEmit"
   },
   "peerDependencies": {
-    "@djangocfg/api": "^2.1.36",
-    "@djangocfg/centrifugo": "^2.1.36",
-    "@djangocfg/ui-nextjs": "^2.1.36",
+    "@djangocfg/api": "^2.1.37",
+    "@djangocfg/centrifugo": "^2.1.37",
+    "@djangocfg/ui-nextjs": "^2.1.37",
     "@hookform/resolvers": "^5.2.0",
     "consola": "^3.4.2",
     "lucide-react": "^0.545.0",
@@ -114,7 +114,7 @@
     "uuid": "^11.1.0"
   },
   "devDependencies": {
-    "@djangocfg/typescript-config": "^2.1.36",
+    "@djangocfg/typescript-config": "^2.1.37",
     "@types/node": "^24.7.2",
     "@types/react": "^19.1.0",
     "@types/react-dom": "^19.1.0",

package/src/layouts/AppLayout/BaseApp.tsx

@@ -6,6 +6,7 @@
  * - TooltipProvider (tooltip positioning)
  * - SWRConfig (data fetching)
  * - AuthProvider (authentication context)
+ * - PwaProvider (PWA context, optional)
  * - ErrorTrackingProvider (error handling)
  * - ErrorBoundary (React error boundary, enabled by default)
  * - MCP Chat Widget (optional, lazy loaded)
@@ -14,10 +15,11 @@
  * ```tsx
  * import { BaseApp } from '@djangocfg/layouts';
  *
- * // With MCP Chat enabled
+ * // With PWA and MCP Chat enabled
  * <BaseApp
  *   theme={{ defaultTheme: 'system' }}
  *   auth={{ loginPath: '/auth/login' }}
+ *   pwa={{ enabled: true }}
  *   mcpChat={{ enabled: true, autoDetectEnvironment: true }}
  * >
  *   {children}
@@ -40,6 +42,7 @@ import { AuthProvider } from '@djangocfg/api/auth';
 import { ErrorTrackingProvider } from '../../components/errors/ErrorsTracker';
 import { ErrorBoundary } from '../../components/errors/ErrorBoundary';
 import { PageProgress } from '../../components/core/PageProgress';
+import { PwaProvider } from '../../snippets/PWA';
 import type { BaseLayoutProps } from '../shared/types';
 
 // Lazy load MCP Chat Widget with dynamic import
@@ -65,6 +68,7 @@ export function BaseApp({
   errorBoundary,
   swr,
   mcpChat,
+  pwa,
 }: BaseAppProps) {
   // ErrorBoundary is enabled by default
   const enableErrorBoundary = errorBoundary?.enabled !== false;
@@ -83,31 +87,33 @@ export function BaseApp({
           }}
         >
           <AuthProvider config={auth}>
-            <ErrorTrackingProvider
-              validation={errorTracking?.validation}
-              cors={errorTracking?.cors}
-              network={errorTracking?.network}
-              onError={errorTracking?.onError}
-            >
-              {children}
-              <PageProgress />
-              <Toaster />
+            <PwaProvider {...pwa}>
+              <ErrorTrackingProvider
+                validation={errorTracking?.validation}
+                cors={errorTracking?.cors}
+                network={errorTracking?.network}
+                onError={errorTracking?.onError}
+              >
+                {children}
+                <PageProgress />
+                <Toaster />
 
-              {/* MCP Chat Widget - lazy loaded */}
-              {mcpChat?.enabled && (
-                <AIChatWidget
-                  apiEndpoint={mcpChat.apiEndpoint}
-                  title={mcpChat.title}
-                  placeholder={mcpChat.placeholder}
-                  greeting={mcpChat.greeting}
-                  position={mcpChat.position}
-                  variant={mcpChat.variant}
-                  enableStreaming={mcpChat.enableStreaming}
-                  autoDetectEnvironment={mcpChat.autoDetectEnvironment}
-                  className={mcpChat.className}
-                />
-              )}
-            </ErrorTrackingProvider>
+                {/* MCP Chat Widget - lazy loaded */}
+                {mcpChat?.enabled && (
+                  <AIChatWidget
+                    apiEndpoint={mcpChat.apiEndpoint}
+                    title={mcpChat.title}
+                    placeholder={mcpChat.placeholder}
+                    greeting={mcpChat.greeting}
+                    position={mcpChat.position}
+                    variant={mcpChat.variant}
+                    enableStreaming={mcpChat.enableStreaming}
+                    autoDetectEnvironment={mcpChat.autoDetectEnvironment}
+                    className={mcpChat.className}
+                  />
+                )}
+              </ErrorTrackingProvider>
+            </PwaProvider>
           </AuthProvider>
         </SWRConfig>
       </TooltipProvider>

package/src/layouts/shared/types.ts

@@ -88,6 +88,39 @@ export interface McpChatConfig {
   className?: string;
 }
 
+// ============================================================================
+// PWA Configuration
+// ============================================================================
+
+export interface PwaConfig {
+  /** Enable PWA provider and features */
+  enabled?: boolean;
+
+  /** Show A2HS hint (enabled by default when pwa.enabled is true) */
+  showInstallHint?: boolean;
+
+  /** Number of days before re-showing dismissed hint */
+  resetAfterDays?: number | null;
+
+  /** Delay before showing hint (ms) */
+  delayMs?: number;
+
+  /** App logo URL to display in hint */
+  logo?: string;
+
+  /** Push notifications configuration */
+  pushNotifications?: {
+    /** VAPID public key for push notifications */
+    vapidPublicKey: string;
+    /** API endpoint for subscription */
+    subscribeEndpoint?: string;
+    /** Delay before showing push prompt after PWA install (ms) */
+    delayMs?: number;
+    /** Number of days before re-showing dismissed push prompt */
+    resetAfterDays?: number;
+  };
+}
+
 // ============================================================================
 // Base Layout Props
 // ============================================================================
@@ -112,6 +145,9 @@ export interface BaseLayoutProps {
 
   /** MCP chat configuration */
   mcpChat?: McpChatConfig;
+
+  /** PWA configuration */
+  pwa?: PwaConfig;
 }
 
 // ============================================================================

package/src/snippets/McpChat/context/ChatContext.tsx

@@ -98,6 +98,7 @@ export function ChatProvider({
   const [error, setError] = useState<Error | null>(null);
   const [isMinimized, setIsMinimized] = useState(false);
   const isHydratedRef = useRef(false);
+  const mobileResetRef = useRef(false);
 
   // Display mode with localStorage persistence
   const [storedMode, setStoredMode] = useLocalStorage<ChatDisplayMode>(storageKeys.mode, 'closed');
@@ -110,6 +111,14 @@ export function ChatProvider({
 
   const isMobile = useIsMobile();
 
+  // On mobile, always start closed on page load (don't restore state)
+  useEffect(() => {
+    if (isMobile && !mobileResetRef.current && storedMode !== 'closed') {
+      mobileResetRef.current = true;
+      setStoredMode('closed');
+    }
+  }, [isMobile, storedMode, setStoredMode]);
+
   // Generate user ID if not exists
   useEffect(() => {
     if (!userId) {