From 712dc5632c9f8c6d5b41f43564bf4bf5abaadaff Mon Sep 17 00:00:00 2001
From: agent-company <agent@leeworks.dev>
Date: Thu, 26 Mar 2026 04:12:20 +0000
Subject: [PATCH] feat: add PWA manifest and service worker

Add Progressive Web App support for installable mobile experience
on iOS Safari and Android Chrome.

- static/manifest.json: app name, standalone display, dark theme,
  icon references for 192px and 512px
- static/sw.js: service worker with cache-first strategy for static
  assets, network-first for HTML/HTMX, offline fallback to cache
- static/icon-192.png, static/icon-512.png: placeholder app icons
- Apple meta tags: apple-mobile-web-app-capable, status bar style,
  apple-touch-icon for iOS Add to Home Screen
- Service worker registration in base layout template

Closes leeworks-agents/gitea-mobile#6

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
---
 internal/handlers/handlers.go |  12 +++++
 static/.gitkeep               |   0
 static/icon-192.png           | Bin 0 -> 547 bytes
 static/icon-512.png           | Bin 0 -> 1881 bytes
 static/manifest.json          |  24 ++++++++++
 static/sw.js                  |  86 ++++++++++++++++++++++++++++++++++
 6 files changed, 122 insertions(+)
 delete mode 100644 static/.gitkeep
 create mode 100644 static/icon-192.png
 create mode 100644 static/icon-512.png
 create mode 100644 static/manifest.json
 create mode 100644 static/sw.js
diff --git a/internal/handlers/handlers.go b/internal/handlers/handlers.go
index 47fd1d9..460ecda 100644
--- a/internal/handlers/handlers.go
+++ b/internal/handlers/handlers.go
@@ -97,6 +97,11 @@ var basePage = template.Must(template.New("base").Parse(`<!DOCTYPE html>
 <head>
   <meta charset="UTF-8">
   <meta name="viewport" content="width=device-width, initial-scale=1.0, viewport-fit=cover">
+  <meta name="apple-mobile-web-app-capable" content="yes">
+  <meta name="apple-mobile-web-app-status-bar-style" content="black-translucent">
+  <meta name="theme-color" content="#161b22">
+  <link rel="manifest" href="/static/manifest.json">
+  <link rel="apple-touch-icon" href="/static/icon-192.png">
   <title>{{.Title}} — Gitea Mobile</title>
   <style>
     * { box-sizing: border-box; margin: 0; padding: 0; }
@@ -162,6 +167,13 @@ var basePage = template.Must(template.New("base").Parse(`<!DOCTYPE html>
       Settings
     </a>
   </nav>
+  <script>
+    if ('serviceWorker' in navigator) {
+      navigator.serviceWorker.register('/static/sw.js').catch(function(err) {
+        console.log('SW registration failed:', err);
+      });
+    }
+  </script>
 </body>
 </html>`))
 
diff --git a/static/.gitkeep b/static/.gitkeep
deleted file mode 100644
index e69de29..0000000
diff --git a/static/icon-192.png b/static/icon-192.png
new file mode 100644
index 0000000000000000000000000000000000000000..144de24cec39f06d36b908c23411175c2c37aa9c
GIT binary patch
literal 547
zcmeAS@N?(olHy`uVBq!ia0vp^2SAvE2}s`E_d9@rf$^26i(^Q|oVS-Yaxy3|957g4
zQ26=3^527eN-RYV?R`7VVx-S=|CrV2!Q+yoAjCXTqT`5z3Y(IlK<B8?&<Y9mzb2bD
UmtB4q42*mRPgg&ebxsLQ0Qy~*&j0`b

literal 0
HcmV?d00001

diff --git a/static/icon-512.png b/static/icon-512.png
new file mode 100644
index 0000000000000000000000000000000000000000..5c524bb043a3038612527e81fd7588dcffc99fa4
GIT binary patch
literal 1881
zcmeAS@N?(olHy`uVBq!ia0y~yU;;9k7&t&wwUqN(1_pKoPZ!6KiaBqu8uBt2@Eq8%
z=*H&!KaPBE{SihDH8YFl85}pqF&yAxX6P_tXwVp?MuT896^v$t(XwE)I2;i*!U}#L
XBjHkoWdHlXDwDy})z4*}Q$iB}#5;ZE

literal 0
HcmV?d00001

diff --git a/static/manifest.json b/static/manifest.json
new file mode 100644
index 0000000..9e73884
--- /dev/null
+++ b/static/manifest.json
@@ -0,0 +1,24 @@
+{
+  "name": "Gitea Mobile",
+  "short_name": "Gitea",
+  "description": "Mobile-first PWA for managing Gitea issues and pull requests",
+  "start_url": "/",
+  "display": "standalone",
+  "background_color": "#0d1117",
+  "theme_color": "#161b22",
+  "orientation": "portrait",
+  "icons": [
+    {
+      "src": "/static/icon-192.png",
+      "sizes": "192x192",
+      "type": "image/png",
+      "purpose": "any maskable"
+    },
+    {
+      "src": "/static/icon-512.png",
+      "sizes": "512x512",
+      "type": "image/png",
+      "purpose": "any maskable"
+    }
+  ]
+}
diff --git a/static/sw.js b/static/sw.js
new file mode 100644
index 0000000..201068d
--- /dev/null
+++ b/static/sw.js
@@ -0,0 +1,86 @@
+// Service Worker for Gitea Mobile PWA
+// Caches the app shell for offline/fast loading.
+
+const CACHE_NAME = 'gitea-mobile-v1';
+const APP_SHELL = [
+  '/',
+  '/static/style.css',
+  '/static/manifest.json',
+  '/static/icon-192.png',
+  '/static/icon-512.png',
+  'https://unpkg.com/htmx.org@1.9.10'
+];
+
+// Install: cache app shell resources.
+self.addEventListener('install', (event) => {
+  event.waitUntil(
+    caches.open(CACHE_NAME).then((cache) => {
+      return cache.addAll(APP_SHELL);
+    })
+  );
+  // Activate immediately.
+  self.skipWaiting();
+});
+
+// Activate: clean up old caches.
+self.addEventListener('activate', (event) => {
+  event.waitUntil(
+    caches.keys().then((cacheNames) => {
+      return Promise.all(
+        cacheNames
+          .filter((name) => name !== CACHE_NAME)
+          .map((name) => caches.delete(name))
+      );
+    })
+  );
+  // Take control of all clients immediately.
+  self.clients.claim();
+});
+
+// Fetch: network-first for API/HTML, cache-first for static assets.
+self.addEventListener('fetch', (event) => {
+  const url = new URL(event.request.url);
+
+  // Cache-first for static assets.
+  if (url.pathname.startsWith('/static/')) {
+    event.respondWith(
+      caches.match(event.request).then((cached) => {
+        return cached || fetch(event.request).then((response) => {
+          // Cache the fetched response for next time.
+          const responseClone = response.clone();
+          caches.open(CACHE_NAME).then((cache) => {
+            cache.put(event.request, responseClone);
+          });
+          return response;
+        });
+      })
+    );
+    return;
+  }
+
+  // Network-first for HTML/API requests.
+  if (event.request.headers.get('accept')?.includes('text/html') ||
+      event.request.headers.get('HX-Request')) {
+    event.respondWith(
+      fetch(event.request)
+        .then((response) => {
+          // Cache successful GET responses.
+          if (event.request.method === 'GET' && response.ok) {
+            const responseClone = response.clone();
+            caches.open(CACHE_NAME).then((cache) => {
+              cache.put(event.request, responseClone);
+            });
+          }
+          return response;
+        })
+        .catch(() => {
+          // Fallback to cache if network fails.
+          return caches.match(event.request);
+        })
+    );
+    return;
+  }
+
+  // Default: network only.
+  event.respondWith(fetch(event.request));
+});
