From 66e7bc65ce6373ff3a6552a58df2b0821734dde1 Mon Sep 17 00:00:00 2001
From: Zhicheng Han <43314240+hanzckernel@users.noreply.github.com>
Date: Fri, 19 Jun 2026 09:00:34 +0200
Subject: [PATCH] fix: add mobile PWA install metadata (#1663)

---
 packages/client/index.html                  |  5 ++++
 packages/client/public/manifest.webmanifest | 18 ++++++++++++++
 tests/client/pwa-metadata.test.ts           | 27 +++++++++++++++++++++
 3 files changed, 50 insertions(+)
 create mode 100644 packages/client/public/manifest.webmanifest
 create mode 100644 tests/client/pwa-metadata.test.ts
diff --git a/packages/client/index.html b/packages/client/index.html
index fb9beb0b..98c3768a 100644
--- a/packages/client/index.html
+++ b/packages/client/index.html
@@ -4,6 +4,11 @@
 <head>
   <meta charset="UTF-8" />
   <link rel="icon" type="image/svg+xml" href="/favicon.ico" />
+  <link rel="apple-touch-icon" href="/logo.png" />
+  <link rel="manifest" href="/manifest.webmanifest" />
+  <meta name="theme-color" content="#f7f7f4" />
+  <meta name="apple-mobile-web-app-capable" content="yes" />
+  <meta name="apple-mobile-web-app-title" content="Hermes Studio" />
   <meta name="viewport" content="width=device-width, initial-scale=1.0" />
   <title>Hermes Studio</title>
   <style>
diff --git a/packages/client/public/manifest.webmanifest b/packages/client/public/manifest.webmanifest
new file mode 100644
index 00000000..df086e94
--- /dev/null
+++ b/packages/client/public/manifest.webmanifest
@@ -0,0 +1,18 @@
+{
+  "name": "Hermes Studio",
+  "short_name": "Hermes",
+  "description": "Self-hosted AI chat dashboard for Hermes Agent",
+  "start_url": "/#/hermes/chat",
+  "scope": "/",
+  "display": "standalone",
+  "background_color": "#f7f7f4",
+  "theme_color": "#f7f7f4",
+  "icons": [
+    {
+      "src": "/logo.png",
+      "sizes": "1254x1254",
+      "type": "image/png",
+      "purpose": "any maskable"
+    }
+  ]
+}
diff --git a/tests/client/pwa-metadata.test.ts b/tests/client/pwa-metadata.test.ts
new file mode 100644
index 00000000..002060da
--- /dev/null
+++ b/tests/client/pwa-metadata.test.ts
@@ -0,0 +1,27 @@
+import { readFileSync } from 'fs'
+import { describe, expect, it } from 'vitest'
+
+describe('PWA metadata', () => {
+  it('links manifest and touch icon from the client shell', () => {
+    const html = readFileSync('packages/client/index.html', 'utf8')
+
+    expect(html).toContain('rel="manifest" href="/manifest.webmanifest"')
+    expect(html).toContain('rel="apple-touch-icon" href="/logo.png"')
+    expect(html).toContain('name="apple-mobile-web-app-title" content="Hermes Studio"')
+  })
+
+  it('ships a standalone web manifest with the Hermes icon', () => {
+    const manifest = JSON.parse(readFileSync('packages/client/public/manifest.webmanifest', 'utf8'))
+
+    expect(manifest.name).toBe('Hermes Studio')
+    expect(manifest.display).toBe('standalone')
+    expect(manifest.start_url).toBe('/#/hermes/chat')
+    expect(manifest.icons).toEqual(expect.arrayContaining([
+      expect.objectContaining({
+        src: '/logo.png',
+        type: 'image/png',
+        purpose: 'any maskable',
+      }),
+    ]))
+  })
+})
