From 67afc7bf158388a91cadd9399741c397fd3db1e0 Mon Sep 17 00:00:00 2001
From: yuta <hi@yutakobayashi.com>
Date: Thu, 8 Oct 2026 00:47:03 +0900
Subject: [PATCH] feat: make Personal Workspace installable as a PWA

---
 README.md                         |  24 +++++++
 e2e/integrations/pwa.spec.ts      | 103 ++++++++++++++++++++++++++++++
 playwright.config.ts              |   6 +-
 public/icons/apple-touch-icon.png | Bin 0 -> 5434 bytes
 public/icons/icon-192.png         | Bin 0 -> 4126 bytes
 public/icons/icon-512.png         | Bin 0 -> 1910 bytes
 public/icons/maskable-512.png     | Bin 0 -> 1910 bytes
 public/icons/workspace.svg        |   8 +++
 public/manifest.webmanifest       |  22 +++++++
 public/offline.html               |  56 ++++++++++++++++
 public/sw.js                      |  47 ++++++++++++++
 src/routes/__root.tsx             |  19 ++++--
 12 files changed, 280 insertions(+), 5 deletions(-)
 create mode 100644 e2e/integrations/pwa.spec.ts
 create mode 100644 public/icons/apple-touch-icon.png
 create mode 100644 public/icons/icon-192.png
 create mode 100644 public/icons/icon-512.png
 create mode 100644 public/icons/maskable-512.png
 create mode 100644 public/icons/workspace.svg
 create mode 100644 public/manifest.webmanifest
 create mode 100644 public/offline.html
 create mode 100644 public/sw.js

diff --git a/README.md b/README.md
index d551f91..9bbc976 100644
--- a/README.md
+++ b/README.md
@@ -96,6 +96,30 @@ code. See [owner login](docs/login.md) for configuration, sessions, and limits.
 
 `GET /health` returns `{"status":"ok"}` without authentication or database access.
 
+## Install as an app
+
+The production build supports installation as **Personal Workspace** through
+the browser's install menu (or Safari's **Add to Home Screen**). Open the app
+over HTTPS, such as its Tailscale Serve origin; localhost also works for testing.
+The installed app opens Home in a standalone window and uses the same owner
+login as the browser. Access to the private network is still required.
+
+A service worker displays a small offline page when a page cannot be reached.
+Reconnect and select **Try again** to reopen the same URL. Only this generic
+page is cached: personal data, authenticated pages, API responses, and mutations
+are never stored by the service worker. Offline reading/editing and background
+sync are not supported. Updates activate after existing app windows/tabs close,
+so an update does not reload an active draft. When changing `public/offline.html`,
+bump the cache version in `public/sw.js`.
+
+Service worker registration is disabled in development. Verify the production
+behavior with:
+
+```bash
+nix develop -c pnpm build
+nix develop -c env TWITTER_LITE_E2E_PRODUCTION=1 pnpm test:e2e e2e/integrations/pwa.spec.ts
+```
+
 ## Requirements and setup
 
 Use Nix, or Node.js `>=22.12.0` with pnpm `11.9.0`. The committed `.npmrc`
diff --git a/e2e/integrations/pwa.spec.ts b/e2e/integrations/pwa.spec.ts
new file mode 100644
index 0000000..f770290
--- /dev/null
+++ b/e2e/integrations/pwa.spec.ts
@@ -0,0 +1,103 @@
+import { chromium, expect, test } from "@playwright/test";
+
+test.skip(process.env.TWITTER_LITE_E2E_PRODUCTION !== "1", "PWA requires the production build.");
+
+test("publishes an installable manifest and correctly sized icons before login", async ({
+  page,
+  request,
+}) => {
+  await page.goto("/");
+  await expect(page.locator('link[rel="manifest"]')).toHaveAttribute(
+    "href",
+    "/manifest.webmanifest",
+  );
+  const response = await request.get("/manifest.webmanifest");
+  expect(response.ok()).toBe(true);
+  const manifest = await response.json();
+  expect(manifest).toMatchObject({
+    id: "/",
+    name: "Personal Workspace",
+    start_url: "/",
+    scope: "/",
+    display: "standalone",
+  });
+  expect(manifest.icons).toEqual(
+    expect.arrayContaining([
+      expect.objectContaining({ sizes: "192x192", purpose: "any" }),
+      expect.objectContaining({ sizes: "512x512", purpose: "any" }),
+      expect.objectContaining({ sizes: "512x512", purpose: "maskable" }),
+    ]),
+  );
+  for (const icon of manifest.icons) {
+    const dimensions = await page.evaluate(async (src: string) => {
+      const image = new Image();
+      image.src = src;
+      await image.decode();
+      return `${image.naturalWidth}x${image.naturalHeight}`;
+    }, icon.src);
+    expect(dimensions).toBe(icon.sizes);
+  }
+});
+
+test("passes Chromium installation checks in a regular browser profile", async ({
+  baseURL,
+}, testInfo) => {
+  // Playwright's default incognito contexts cannot install apps.
+  const context = await chromium.launchPersistentContext("", {
+    executablePath: process.env.PLAYWRIGHT_CHROMIUM_EXECUTABLE,
+    baseURL,
+    extraHTTPHeaders: { "Tailscale-User-Login": "owner@twitter-lite.invalid" },
+    viewport: testInfo.project.use.viewport,
+    isMobile: testInfo.project.use.isMobile,
+  });
+  try {
+    const page = await context.newPage();
+    await page.goto("/");
+    await page.evaluate(() => navigator.serviceWorker.ready.then(() => true));
+    const client = await context.newCDPSession(page);
+    expect((await client.send("Page.getAppManifest")).errors).toEqual([]);
+    await expect
+      .poll(async () => (await client.send("Page.getInstallabilityErrors")).installabilityErrors)
+      .toEqual([]);
+  } finally {
+    await context.close();
+  }
+});
+
+test("shows a private offline fallback and retries the original URL online", async ({
+  page,
+  context,
+  baseURL,
+}) => {
+  await page.goto("/");
+  await expect
+    .poll(() => page.evaluate(() => navigator.serviceWorker.controller?.scriptURL))
+    .toBe(new URL("/sw.js", baseURL).href);
+
+  await context.setOffline(true);
+  const destination = "/login?returnTo=%2Fjournal";
+  await page.goto(destination);
+  await expect(page).toHaveURL(new URL(destination, baseURL).href);
+  await expect(page.getByRole("heading", { name: "You’re offline" })).toBeVisible();
+  expect(
+    await page.evaluate(() =>
+      fetch("/api/auth").then(
+        () => false,
+        () => true,
+      ),
+    ),
+  ).toBe(true);
+
+  const cachedPaths = await page.evaluate(async () => {
+    const names = await caches.keys();
+    const requests = await Promise.all(names.map(async (name) => (await caches.open(name)).keys()));
+    return requests.flat().map((request) => new URL(request.url).pathname);
+  });
+  expect(cachedPaths).toEqual(["/offline.html"]);
+
+  await context.setOffline(false);
+  await page.getByRole("button", { name: "Try again" }).click();
+  await expect(page).toHaveURL(/\/(?:login|setup)(?:\?|$)/);
+  await expect(page.getByRole("heading", { name: "You’re offline" })).toHaveCount(0);
+  await expect(page.getByRole("button", { name: /Create account|Sign in/i })).toBeVisible();
+});
diff --git a/playwright.config.ts b/playwright.config.ts
index 97fa90d..ddef800 100644
--- a/playwright.config.ts
+++ b/playwright.config.ts
@@ -5,6 +5,10 @@ import { defineConfig, devices } from "@playwright/test";
 
 const appPort = 4173;
 const relayPort = 6911;
+const appCommand =
+  process.env.TWITTER_LITE_E2E_PRODUCTION === "1"
+    ? `HOST=127.0.0.1 PORT=${appPort} node .output/server/index.mjs`
+    : `pnpm exec vite dev --host 127.0.0.1 --port ${appPort} --strictPort`;
 const chromiumExecutable = process.env.PLAYWRIGHT_CHROMIUM_EXECUTABLE;
 const databasePath =
   process.env.TWITTER_LITE_E2E_DB_PATH ??
@@ -36,7 +40,7 @@ export default defineConfig({
       timeout: 120_000,
     },
     {
-      command: `WORKSPACE_SETUP_TOKEN=isolated-e2e-setup-token-not-for-production TWITTER_LITE_CODEX_PATH= TWITTER_LITE_REPORT_ROOT= TWITTER_LITE_CODEX_MODEL= TWITTER_LITE_MASTODON_ORIGINS= TWITTER_LITE_CREDENTIAL_KEY_FILE= TWITTER_LITE_DB_PATH=${databasePath} TWITTER_LITE_ORIGIN=http://127.0.0.1:${appPort} TWITTER_LITE_ALLOWED_LOGIN=owner@twitter-lite.invalid TWITTER_RELAY_BASE_URL=http://127.0.0.1:${relayPort} BIRD_PROFILE_NAME=e2e pnpm exec vite dev --host 127.0.0.1 --port ${appPort} --strictPort`,
+      command: `WORKSPACE_SETUP_TOKEN=isolated-e2e-setup-token-not-for-production TWITTER_LITE_CODEX_PATH= TWITTER_LITE_REPORT_ROOT= TWITTER_LITE_CODEX_MODEL= TWITTER_LITE_MASTODON_ORIGINS= TWITTER_LITE_CREDENTIAL_KEY_FILE= TWITTER_LITE_DB_PATH=${databasePath} TWITTER_LITE_ORIGIN=http://127.0.0.1:${appPort} TWITTER_LITE_ALLOWED_LOGIN=owner@twitter-lite.invalid TWITTER_RELAY_BASE_URL=http://127.0.0.1:${relayPort} BIRD_PROFILE_NAME=e2e ${appCommand}`,
       port: appPort,
       reuseExistingServer: false,
       timeout: 120_000,
diff --git a/public/icons/apple-touch-icon.png b/public/icons/apple-touch-icon.png
new file mode 100644
index 0000000000000000000000000000000000000000..9fe436a2611accd08bae5b85db95c31c9e655779
GIT binary patch
literal 5434
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
LtDnm{r-UW|)p*){

literal 0
HcmV?d00001

diff --git a/public/icons/icon-192.png b/public/icons/icon-192.png
new file mode 100644
index 0000000000000000000000000000000000000000..0e3c6e6e1d5794065a973dd5c3cdf34975335ee4
GIT binary patch
literal 4126
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

literal 0
HcmV?d00001

diff --git a/public/icons/icon-512.png b/public/icons/icon-512.png
new file mode 100644
index 0000000000000000000000000000000000000000..26fe3f3a87be0da8634fc2c81d10e6c6d60cd94a
GIT binary patch
literal 1910
zcmeAS@N?(olHy`uVBq!ia0y~yU}6Aa4rT@hhQrHLPB1VqC?tCX`7$t6sWC7#v@kII
zVqjosc)`F>YQVtoDuIE)Y6b&?c)^@qfi?^b466ftLR?kj^9(b}@~6&UzW4CCTX$c)
zefRDA_g}w$E!%rIZ^}G_^ir3y<`w&oeEjld`Mx7ArA@l2#k02T{{H>PjLkcBQi`wM
ze{}lBZL9nmzuL~nFJF6Cw_D}aT)y|<{Ox-a)^7Rm>GPsp2R?rOk~?MY(mjV>zJ34v
z&D*cvzJK}lZOQI~Ig{q-r<XbwH%#5Q<J9%r+Q~(aUcP?%`i*sdjaOB>c}~@_D>tTY
z*nZ~5oyEHk=1!jL6eaVYfq{Xuz$3Dlfq@|bj6Y;Moo8TRU@!6Xb!C6W#m=wETvcyv
zz`($uTH+c}l9E`GYL#4+npl#`U}RuqrfX=RYhWH?Xli9*U}b2jZD3$!V9;+d`!$M&
z-29Zxv`X9>{-r91GcYh{z-=hW%uOvWNz5%k*JEg9U<|QDFT*U2fq`|7r;B4q#jUq@
zUk6Q&6llBH;NalsBH(JXP)JbJX3_Wh)Wt$`R?d=Nbl>m&l6zb87VNIF7ZcEx>}8-1
zP&jqzQ}5KPTR+N2MaM?o-(mUNa`Wx>`FXi{fB#<Ho|ixU%*=y!e@fDyzdK-GvAbHe
zSnB=ZrEjYb`|qpYpXPVEcE^{5tw)dY%UwH@xt)LdHtD^m4<??S6ZX3x^L^mzZu@<~
z#>>yz`Mlk-`^V%(mcHK}URv9Bf4aTxnwgiA<d>O6$Nh=CIEU?bLFUSr&yC#8v!C(Y
zZ(sRzn|OVkN%{vnpSu~=AH-dY+1?+%;&r?Ez4%$lJ^aD?x8?rq$T;_)cE+qNwm()c
zvTXjIxa#ZC)z5hDwreuB2s>B|R${f)k0s}S?|)T$e`mPpfzx)3GT-;Tzq6VvVW~gE
z@4fG>zprA7crSdw^ZoC0dsi`-{bKpB>wE3<xKM`W?zZ>-zt{rdEWT~a6!E_H-p_Ec
z1K*<l{`SB3#qRwdZSI6E(eejw-@6{mP|En`ZTSBGyEj8PJ$&c0@BjbXe(!iJODkiK
zoLtDh|38o4+aAj?m9fXJc3t)V^7g&{yCuAsCFa^{{<28;boBcF*DHA+{5EGg&n0A0
z_3-)r*Q@vvOss0_iVAHu@0Xn?6JPW9+2{SQSMxXQRB9+-;!r1t_{ylGdp{y_?#=&V
z8@KJ+w6AdU_fT<<Qiknj+ta>&`+sZK-n+loaW6J&u(mEw|NqB+&D(ch_q}P-;7#})
zclPuD4fXrKXNo(gGVq7JzE^K!S8?O_HtvN64R0@f{~y=zU+Iz5E2bOOA;14U{`lB>
z@A};gub6JEto#4*hv)m(dJUTx@<eO@|Bv^t75uSw6NB07`}H<;*M9H$yk4teY18@o
zfA3GEH|-A=Jy6vDUA})lB&Hs?&1Z=F0*<r;>w9Jfhcf<H8d$tai($W6o?j^Ih39|&
zGEcoPG<cIB_S~_<^LF)qty#tu^2_43+5RZJIOpJRgRPgoJ@^gDd{wub=Zk<dpL8z&
zzg^(WXJwmJ`F`=`S(b;tKRoqz8hgC{tjh`V%eGy=b+`J{vNXT$+8vv2zk871{mkTM
z`^vq4!@k#*hk;6i7)zV{;`iU>vz~3a)vnFYA9d&VpX9T1%6=C-z5M*)_qy^3<K<87
zVl1nTJ{<pYa(Z^{URj&vAMO4W{m40RS!VB!Z|9?%pPfmNud@Ut$3MsGv#l-n{rL5^
n-!A|6Zp+QL*{M@9GKk%`KU30i*g55EFvvttS3j3^P6<r_IlBy6

literal 0
HcmV?d00001

diff --git a/public/icons/maskable-512.png b/public/icons/maskable-512.png
new file mode 100644
index 0000000000000000000000000000000000000000..26fe3f3a87be0da8634fc2c81d10e6c6d60cd94a
GIT binary patch
literal 1910
zcmeAS@N?(olHy`uVBq!ia0y~yU}6Aa4rT@hhQrHLPB1VqC?tCX`7$t6sWC7#v@kII
zVqjosc)`F>YQVtoDuIE)Y6b&?c)^@qfi?^b466ftLR?kj^9(b}@~6&UzW4CCTX$c)
zefRDA_g}w$E!%rIZ^}G_^ir3y<`w&oeEjld`Mx7ArA@l2#k02T{{H>PjLkcBQi`wM
ze{}lBZL9nmzuL~nFJF6Cw_D}aT)y|<{Ox-a)^7Rm>GPsp2R?rOk~?MY(mjV>zJ34v
z&D*cvzJK}lZOQI~Ig{q-r<XbwH%#5Q<J9%r+Q~(aUcP?%`i*sdjaOB>c}~@_D>tTY
z*nZ~5oyEHk=1!jL6eaVYfq{Xuz$3Dlfq@|bj6Y;Moo8TRU@!6Xb!C6W#m=wETvcyv
zz`($uTH+c}l9E`GYL#4+npl#`U}RuqrfX=RYhWH?Xli9*U}b2jZD3$!V9;+d`!$M&
z-29Zxv`X9>{-r91GcYh{z-=hW%uOvWNz5%k*JEg9U<|QDFT*U2fq`|7r;B4q#jUq@
zUk6Q&6llBH;NalsBH(JXP)JbJX3_Wh)Wt$`R?d=Nbl>m&l6zb87VNIF7ZcEx>}8-1
zP&jqzQ}5KPTR+N2MaM?o-(mUNa`Wx>`FXi{fB#<Ho|ixU%*=y!e@fDyzdK-GvAbHe
zSnB=ZrEjYb`|qpYpXPVEcE^{5tw)dY%UwH@xt)LdHtD^m4<??S6ZX3x^L^mzZu@<~
z#>>yz`Mlk-`^V%(mcHK}URv9Bf4aTxnwgiA<d>O6$Nh=CIEU?bLFUSr&yC#8v!C(Y
zZ(sRzn|OVkN%{vnpSu~=AH-dY+1?+%;&r?Ez4%$lJ^aD?x8?rq$T;_)cE+qNwm()c
zvTXjIxa#ZC)z5hDwreuB2s>B|R${f)k0s}S?|)T$e`mPpfzx)3GT-;Tzq6VvVW~gE
z@4fG>zprA7crSdw^ZoC0dsi`-{bKpB>wE3<xKM`W?zZ>-zt{rdEWT~a6!E_H-p_Ec
z1K*<l{`SB3#qRwdZSI6E(eejw-@6{mP|En`ZTSBGyEj8PJ$&c0@BjbXe(!iJODkiK
zoLtDh|38o4+aAj?m9fXJc3t)V^7g&{yCuAsCFa^{{<28;boBcF*DHA+{5EGg&n0A0
z_3-)r*Q@vvOss0_iVAHu@0Xn?6JPW9+2{SQSMxXQRB9+-;!r1t_{ylGdp{y_?#=&V
z8@KJ+w6AdU_fT<<Qiknj+ta>&`+sZK-n+loaW6J&u(mEw|NqB+&D(ch_q}P-;7#})
zclPuD4fXrKXNo(gGVq7JzE^K!S8?O_HtvN64R0@f{~y=zU+Iz5E2bOOA;14U{`lB>
z@A};gub6JEto#4*hv)m(dJUTx@<eO@|Bv^t75uSw6NB07`}H<;*M9H$yk4teY18@o
zfA3GEH|-A=Jy6vDUA})lB&Hs?&1Z=F0*<r;>w9Jfhcf<H8d$tai($W6o?j^Ih39|&
zGEcoPG<cIB_S~_<^LF)qty#tu^2_43+5RZJIOpJRgRPgoJ@^gDd{wub=Zk<dpL8z&
zzg^(WXJwmJ`F`=`S(b;tKRoqz8hgC{tjh`V%eGy=b+`J{vNXT$+8vv2zk871{mkTM
z`^vq4!@k#*hk;6i7)zV{;`iU>vz~3a)vnFYA9d&VpX9T1%6=C-z5M*)_qy^3<K<87
zVl1nTJ{<pYa(Z^{URj&vAMO4W{m40RS!VB!Z|9?%pPfmNud@Ut$3MsGv#l-n{rL5^
n-!A|6Zp+QL*{M@9GKk%`KU30i*g55EFvvttS3j3^P6<r_IlBy6

literal 0
HcmV?d00001

diff --git a/public/icons/workspace.svg b/public/icons/workspace.svg
new file mode 100644
index 0000000..d214341
--- /dev/null
+++ b/public/icons/workspace.svg
@@ -0,0 +1,8 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512">
+  <rect width="512" height="512" fill="#255f6e"/>
+  <g fill="#fafafa">
+    <rect x="144" y="144" width="80" height="224" rx="16"/>
+    <rect x="248" y="144" width="120" height="96" rx="16"/>
+    <rect x="248" y="264" width="120" height="104" rx="16"/>
+  </g>
+</svg>
diff --git a/public/manifest.webmanifest b/public/manifest.webmanifest
new file mode 100644
index 0000000..05477ec
--- /dev/null
+++ b/public/manifest.webmanifest
@@ -0,0 +1,22 @@
+{
+  "id": "/",
+  "name": "Personal Workspace",
+  "short_name": "Workspace",
+  "description": "Your day, messages, notes, reading, and research in one place.",
+  "lang": "en",
+  "start_url": "/",
+  "scope": "/",
+  "display": "standalone",
+  "background_color": "#171717",
+  "theme_color": "#171717",
+  "icons": [
+    { "src": "/icons/icon-192.png", "sizes": "192x192", "type": "image/png", "purpose": "any" },
+    { "src": "/icons/icon-512.png", "sizes": "512x512", "type": "image/png", "purpose": "any" },
+    {
+      "src": "/icons/maskable-512.png",
+      "sizes": "512x512",
+      "type": "image/png",
+      "purpose": "maskable"
+    }
+  ]
+}
diff --git a/public/offline.html b/public/offline.html
new file mode 100644
index 0000000..c06ce4f
--- /dev/null
+++ b/public/offline.html
@@ -0,0 +1,56 @@
+<!doctype html>
+<html lang="en">
+  <head>
+    <meta charset="utf-8" />
+    <meta name="viewport" content="width=device-width, initial-scale=1" />
+    <meta name="theme-color" content="#171717" />
+    <title>Offline · Personal Workspace</title>
+    <style>
+      :root {
+        color-scheme: dark;
+        font-family: system-ui, sans-serif;
+        background: #171717;
+        color: #fafafa;
+      }
+      body {
+        margin: 0;
+        min-height: 100svh;
+        display: grid;
+        place-items: center;
+      }
+      main {
+        max-width: 28rem;
+        padding: 2rem;
+      }
+      h1 {
+        font-size: 1.75rem;
+      }
+      p {
+        color: #b4b4b4;
+        line-height: 1.6;
+      }
+      button {
+        margin-top: 1rem;
+        border: 0;
+        border-radius: 0.625rem;
+        padding: 0.75rem 1.25rem;
+        background: #fafafa;
+        color: #171717;
+        font: inherit;
+        cursor: pointer;
+      }
+      button:focus-visible {
+        outline: 2px solid #fafafa;
+        outline-offset: 4px;
+      }
+    </style>
+  </head>
+  <body>
+    <main>
+      <p>Personal Workspace</p>
+      <h1>You’re offline</h1>
+      <p>Connect to the internet and try again to open your workspace.</p>
+      <button type="button" onclick="window.location.reload()">Try again</button>
+    </main>
+  </body>
+</html>
diff --git a/public/sw.js b/public/sw.js
new file mode 100644
index 0000000..70fb202
--- /dev/null
+++ b/public/sw.js
@@ -0,0 +1,47 @@
+// Only this generic page is cached. Authenticated HTML, API responses, and
+// mutations always use the network. Bump the version when offline.html changes.
+const CACHE = "workspace-offline-v1";
+const OFFLINE_URL = "/offline.html";
+
+self.addEventListener("install", (event) => {
+  event.waitUntil(
+    caches.open(CACHE).then((cache) => cache.add(new Request(OFFLINE_URL, { cache: "reload" }))),
+  );
+});
+
+self.addEventListener("activate", (event) => {
+  event.waitUntil(
+    (async () => {
+      const keys = await caches.keys();
+      await Promise.all(
+        keys
+          .filter((key) => key.startsWith("workspace-offline-") && key !== CACHE)
+          .map((key) => caches.delete(key)),
+      );
+      await self.clients.claim();
+    })(),
+  );
+});
+
+self.addEventListener("fetch", (event) => {
+  const { request } = event;
+  const url = new URL(request.url);
+  if (
+    request.method !== "GET" ||
+    request.mode !== "navigate" ||
+    url.origin !== self.location.origin ||
+    url.pathname.startsWith("/api/") ||
+    url.pathname.startsWith("/_serverFn/") ||
+    url.pathname.startsWith("/oauth/") ||
+    url.pathname === "/mcp" ||
+    url.pathname === "/health"
+  ) {
+    return;
+  }
+  event.respondWith(
+    fetch(request).catch(async () => {
+      const cache = await caches.open(CACHE);
+      return (await cache.match(OFFLINE_URL)) ?? Response.error();
+    }),
+  );
+});
diff --git a/src/routes/__root.tsx b/src/routes/__root.tsx
index 60807c8..48edf0a 100644
--- a/src/routes/__root.tsx
+++ b/src/routes/__root.tsx
@@ -1,4 +1,5 @@
 import type { QueryClient } from "@tanstack/react-query";
+import { useEffect } from "react";
 import {
   createRootRouteWithContext,
   HeadContent,
@@ -44,14 +45,15 @@ export const Route = createRootRouteWithContext<RouterContext>()({
         content: "width=device-width, initial-scale=1",
       },
       { name: "referrer", content: "no-referrer" },
+      { name: "theme-color", content: "#171717" },
+      { name: "apple-mobile-web-app-title", content: "Workspace" },
       { title: "Personal Workspace" },
     ],
     links: [
       { rel: "stylesheet", href: appCss },
-      {
-        rel: "icon",
-        href: "data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 16 16'%3E%3Ccircle cx='8' cy='8' r='7' fill='%23255f6e'/%3E%3C/svg%3E",
-      },
+      { rel: "manifest", href: "/manifest.webmanifest", crossOrigin: "use-credentials" },
+      { rel: "icon", href: "/icons/workspace.svg", type: "image/svg+xml" },
+      { rel: "apple-touch-icon", href: "/icons/apple-touch-icon.png" },
     ],
   }),
   shellComponent: RootDocument,
@@ -67,6 +69,15 @@ function RootContent() {
 }
 
 function RootDocument({ children }: { children: React.ReactNode }) {
+  useEffect(() => {
+    if (import.meta.env.PROD && "serviceWorker" in navigator) {
+      void navigator.serviceWorker.register("/sw.js", { updateViaCache: "none" }).catch((error) => {
+        // oxlint-disable-next-line no-console -- Keep registration failures diagnosable without interrupting the app.
+        console.error("Service worker registration failed", error);
+      });
+    }
+  }, []);
+
   return (
     <html lang="en" className="dark">
       <head>