feat: Implement Progressive Web App (PWA) functionality and update branding assets

Author: 403errors

.gitignore

@@ -40,3 +40,9 @@ yarn-error.log*
 # typescript
 *.tsbuildinfo
 next-env.d.ts
+
+# PWA
+public/sw.js
+public/sw.js.map
+public/workbox-*.js
+public/workbox-*.js.map

next-pwa.d.ts

@@ -0,0 +1,31 @@
+declare module 'next-pwa' {
+    import { NextConfig } from 'next';
+
+    interface PWAConfig {
+        dest?: string;
+        register?: boolean;
+        skipWaiting?: boolean;
+        disable?: boolean;
+        fallbacks?: {
+            document?: string;
+            image?: string;
+            audio?: string;
+            video?: string;
+            font?: string;
+        };
+        runtimeCaching?: Array<{
+            urlPattern: RegExp | string;
+            handler: 'CacheFirst' | 'NetworkFirst' | 'StaleWhileRevalidate' | 'NetworkOnly' | 'CacheOnly';
+            options?: {
+                cacheName?: string;
+                networkTimeoutSeconds?: number;
+                expiration?: {
+                    maxEntries?: number;
+                    maxAgeSeconds?: number;
+                };
+            };
+        }>;
+    }
+
+    export default function withPWA(config: PWAConfig): (nextConfig: NextConfig) => NextConfig;
+}

next.config.ts

@@ -1,11 +1,68 @@
 import type { NextConfig } from "next";
+import withPWA from "next-pwa";
 
 const nextConfig: NextConfig = {
+  turbopack: {}, // Silence Turbopack warning for webpack-based next-pwa
   experimental: {
     serverActions: {
       bodySizeLimit: '5mb',
     },
   },
 };
 
-export default nextConfig;
+export default withPWA({
+  dest: 'public',
+  register: true,
+  skipWaiting: true,
+  disable: false, // Enable in dev for testing
+  fallbacks: {
+    document: '/_offline.html',
+  },
+  runtimeCaching: [
+    {
+      urlPattern: /^https:\/\/fonts\.(?:gstatic|googleapis)\.com\/.*/i,
+      handler: 'CacheFirst',
+      options: {
+        cacheName: 'google-fonts',
+        expiration: {
+          maxEntries: 4,
+          maxAgeSeconds: 365 * 24 * 60 * 60, // 1 year
+        },
+      },
+    },
+    {
+      urlPattern: /^https:\/\/api\.github\.com\/.*/i,
+      handler: 'NetworkFirst',
+      options: {
+        cacheName: 'github-api',
+        networkTimeoutSeconds: 10,
+        expiration: {
+          maxEntries: 50,
+          maxAgeSeconds: 5 * 60, // 5 minutes
+        },
+      },
+    },
+    {
+      urlPattern: /\.(?:png|jpg|jpeg|svg|gif|webp|ico)$/i,
+      handler: 'CacheFirst',
+      options: {
+        cacheName: 'static-images',
+        expiration: {
+          maxEntries: 60,
+          maxAgeSeconds: 30 * 24 * 60 * 60, // 30 days
+        },
+      },
+    },
+    {
+      urlPattern: /\.(?:js|css)$/i,
+      handler: 'StaleWhileRevalidate',
+      options: {
+        cacheName: 'static-resources',
+        expiration: {
+          maxEntries: 100,
+          maxAgeSeconds: 24 * 60 * 60, // 24 hours
+        },
+      },
+    },
+  ],
+})(nextConfig);