diff --git a/apps/docs/app/layout.tsx b/apps/docs/app/layout.tsx
index 1127f35ed..4c8b4d061 100644
--- a/apps/docs/app/layout.tsx
+++ b/apps/docs/app/layout.tsx
@@ -66,6 +66,19 @@ export const viewport: Viewport = {
     maximumScale: 1,
     viewportFit: 'cover',
   }),
+  // diffshub body uses --diffshub-sidebar-bg (#f7f7f7 / #101010) rather than
+  // the plain neutral background shared by diffs and trees, so it gets its
+  // own theme-color pair for the browser chrome address bar.
+  themeColor:
+    process.env.NEXT_PUBLIC_SITE === 'diffshub'
+      ? [
+          { media: '(prefers-color-scheme: light)', color: '#f7f7f7' },
+          { media: '(prefers-color-scheme: dark)', color: '#101010' },
+        ]
+      : [
+          { media: '(prefers-color-scheme: light)', color: '#ffffff' },
+          { media: '(prefers-color-scheme: dark)', color: '#252525' },
+        ],
 };
 
 // When running in a worktree, prefix the title with a stable emoji + slug so
@@ -123,22 +136,22 @@ const description = SITE_PRODUCT.description;
 const SITE_ICONS_BY_SITE: Record<ProductId, Metadata['icons']> = {
   diffs: {
     icon: [
-      { url: '/favicon.svg', type: 'image/svg+xml' },
-      { url: '/favicon.png', type: 'image/png' },
+      { url: '/diffs-brand/icon.svg', type: 'image/svg+xml' },
+      { url: '/diffs-brand/icon.ico', sizes: '32x32' },
     ],
     apple: '/diffs-brand/apple-icon.png',
   },
   trees: {
     icon: [
       { url: '/trees-brand/icon.svg', type: 'image/svg+xml' },
-      { url: '/trees-brand/icon.ico', sizes: 'any' },
+      { url: '/trees-brand/icon.ico', sizes: '32x32' },
     ],
     apple: '/trees-brand/apple-icon.png',
   },
   diffshub: {
     icon: [
       { url: '/diffshub-brand/icon.svg', type: 'image/svg+xml' },
-      { url: '/diffshub-brand/icon.ico', sizes: 'any' },
+      { url: '/diffshub-brand/icon.ico', sizes: '32x32' },
     ],
     apple: '/diffshub-brand/apple-icon.png',
   },
diff --git a/apps/docs/app/manifest.ts b/apps/docs/app/manifest.ts
new file mode 100644
index 000000000..0a0bc7c5f
--- /dev/null
+++ b/apps/docs/app/manifest.ts
@@ -0,0 +1,65 @@
+import type { MetadataRoute } from 'next';
+
+import { type ProductId, PRODUCTS } from '@/lib/product-config';
+
+const SITE = (process.env.NEXT_PUBLIC_SITE ?? 'diffs') as ProductId;
+
+// All apple-icon.png assets are 640×640, satisfying Chrome's ≥192px install
+// prompt and ≥512px splash-screen requirements.
+const APPLE_ICON_SIZE = '640x640';
+
+// diffshub is a full standalone app (viewport-fit cover); diffs and trees are
+// documentation sites that benefit from keeping browser navigation visible.
+const DISPLAY_BY_SITE: Record<ProductId, MetadataRoute.Manifest['display']> = {
+  diffs: 'minimal-ui',
+  trees: 'minimal-ui',
+  diffshub: 'standalone',
+};
+
+// diffshub body uses --diffshub-sidebar-bg (#f7f7f7) rather than plain white.
+// The manifest only accepts a single theme_color, so we use the light value;
+// dark-mode tinting is handled via themeColor in the viewport export.
+const THEME_COLOR_BY_SITE: Record<ProductId, string> = {
+  diffs: '#ffffff',
+  trees: '#ffffff',
+  diffshub: '#f7f7f7',
+};
+
+export default function manifest(): MetadataRoute.Manifest {
+  const product = PRODUCTS[SITE];
+
+  return {
+    name: `${product.name}, from Pierre`,
+    short_name: product.name,
+    description: product.description,
+    id: '/',
+    start_url: '/',
+    display: DISPLAY_BY_SITE[SITE],
+    orientation: 'any',
+    lang: 'en',
+    dir: 'ltr',
+    background_color: '#ffffff',
+    theme_color: THEME_COLOR_BY_SITE[SITE],
+    categories: ['developer', 'productivity'],
+    icons: [
+      {
+        src: `/${SITE}-brand/icon.svg`,
+        type: 'image/svg+xml',
+        sizes: 'any',
+        purpose: 'any',
+      },
+      {
+        src: `/${SITE}-brand/apple-icon.png`,
+        type: 'image/png',
+        sizes: APPLE_ICON_SIZE,
+        purpose: 'any',
+      },
+      {
+        src: `/${SITE}-brand/apple-icon.png`,
+        type: 'image/png',
+        sizes: APPLE_ICON_SIZE,
+        purpose: 'maskable',
+      },
+    ],
+  };
+}
diff --git a/apps/docs/public/diffs-brand/icon.ico b/apps/docs/public/diffs-brand/icon.ico
new file mode 100644
index 000000000..89be077df
Binary files /dev/null and b/apps/docs/public/diffs-brand/icon.ico differ
diff --git a/apps/docs/public/diffs-brand/icon.svg b/apps/docs/public/diffs-brand/icon.svg
new file mode 100644
index 000000000..73e6c9900
--- /dev/null
+++ b/apps/docs/public/diffs-brand/icon.svg
@@ -0,0 +1 @@
+<svg fill="none" height="32" viewBox="0 0 32 32" width="32" xmlns="http://www.w3.org/2000/svg"><style>.bg{fill:#000}.fg{fill:#fff}@media(prefers-color-scheme:dark){.bg{fill:#fff}.fg{fill:#000}}</style><path class="bg" d="m16 0c-13.176 0-16 2.824-16 16s2.824 16 16 16 16-2.824 16-16-2.824-16-16-16z"/><g class="fg"><path d="m17.5001 8.59222c0-.82842-.6716-1.5-1.5-1.5-.8285 0-1.5.67158-1.5 1.5v3.90778h-4.0001c-.82843 0-1.5.6716-1.5 1.5s.67157 1.5 1.5 1.5h4.0001v3h3v-3h3.9999c.8284 0 1.5-.6716 1.5-1.5s-.6716-1.5-1.5-1.5h-3.9999z"/><path d="m10.5 20c-.82843 0-1.5.6716-1.5 1.5s.67157 1.5 1.5 1.5h11c.8284 0 1.5-.6716 1.5-1.5s-.6716-1.5-1.5-1.5z"/></g></svg>
diff --git a/apps/docs/public/diffshub-brand/apple-icon.png b/apps/docs/public/diffshub-brand/apple-icon.png
index d0753be1f..425b620f6 100644
Binary files a/apps/docs/public/diffshub-brand/apple-icon.png and b/apps/docs/public/diffshub-brand/apple-icon.png differ
diff --git a/apps/docs/public/diffshub-brand/icon.svg b/apps/docs/public/diffshub-brand/icon.svg
index 2caea4dc8..cebd2961b 100644
--- a/apps/docs/public/diffshub-brand/icon.svg
+++ b/apps/docs/public/diffshub-brand/icon.svg
@@ -1,7 +1,8 @@
 <svg width="32" height="32" viewBox="0 0 32 32" fill="none" xmlns="http://www.w3.org/2000/svg">
-<path d="M16 0C2.824 0 0 2.824 0 16C0 29.176 2.824 32 16 32C29.176 32 32 29.176 32 16C32 2.824 29.176 0 16 0Z" fill="black"/>
-<path d="M21 16.625C21.6213 16.625 22.125 17.1287 22.125 17.75V19.875H24.25C24.8713 19.875 25.375 20.3787 25.375 21C25.375 21.6213 24.8713 22.125 24.25 22.125H22.125V24.25C22.125 24.8713 21.6213 25.375 21 25.375C20.3787 25.375 19.875 24.8713 19.875 24.25V22.125H17.75C17.1287 22.125 16.625 21.6213 16.625 21C16.625 20.3787 17.1287 19.875 17.75 19.875H19.875V17.75C19.875 17.1287 20.3787 16.625 21 16.625Z" fill="white"/>
-<path d="M13.25 19.875C13.8713 19.875 14.375 20.3787 14.375 21C14.375 21.6213 13.8713 22.125 13.25 22.125H8.75C8.12868 22.125 7.625 21.6213 7.625 21C7.625 20.3787 8.12868 19.875 8.75 19.875H13.25Z" fill="white"/>
-<path d="M11 6.625C11.6213 6.625 12.125 7.12868 12.125 7.75V9.875H14.25C14.8713 9.875 15.375 10.3787 15.375 11C15.375 11.6213 14.8713 12.125 14.25 12.125H12.125V14.25C12.125 14.8713 11.6213 15.375 11 15.375C10.3787 15.375 9.875 14.8713 9.875 14.25V12.125H7.75C7.12868 12.125 6.625 11.6213 6.625 11C6.625 10.3787 7.12868 9.875 7.75 9.875H9.875V7.75C9.875 7.12868 10.3787 6.625 11 6.625Z" fill="white"/>
-<path d="M23.25 9.875C23.8713 9.875 24.375 10.3787 24.375 11C24.375 11.6213 23.8713 12.125 23.25 12.125H18.75C18.1287 12.125 17.625 11.6213 17.625 11C17.625 10.3787 18.1287 9.875 18.75 9.875H23.25Z" fill="white"/>
+<style>.bg{fill:#000}.fg{fill:#fff}@media(prefers-color-scheme:dark){.bg{fill:#fff}.fg{fill:#000}}</style>
+<path class="bg" d="M16 0C2.824 0 0 2.824 0 16C0 29.176 2.824 32 16 32C29.176 32 32 29.176 32 16C32 2.824 29.176 0 16 0Z"/>
+<path class="fg" d="M21 16.625C21.6213 16.625 22.125 17.1287 22.125 17.75V19.875H24.25C24.8713 19.875 25.375 20.3787 25.375 21C25.375 21.6213 24.8713 22.125 24.25 22.125H22.125V24.25C22.125 24.8713 21.6213 25.375 21 25.375C20.3787 25.375 19.875 24.8713 19.875 24.25V22.125H17.75C17.1287 22.125 16.625 21.6213 16.625 21C16.625 20.3787 17.1287 19.875 17.75 19.875H19.875V17.75C19.875 17.1287 20.3787 16.625 21 16.625Z"/>
+<path class="fg" d="M13.25 19.875C13.8713 19.875 14.375 20.3787 14.375 21C14.375 21.6213 13.8713 22.125 13.25 22.125H8.75C8.12868 22.125 7.625 21.6213 7.625 21C7.625 20.3787 8.12868 19.875 8.75 19.875H13.25Z"/>
+<path class="fg" d="M11 6.625C11.6213 6.625 12.125 7.12868 12.125 7.75V9.875H14.25C14.8713 9.875 15.375 10.3787 15.375 11C15.375 11.6213 14.8713 12.125 14.25 12.125H12.125V14.25C12.125 14.8713 11.6213 15.375 11 15.375C10.3787 15.375 9.875 14.8713 9.875 14.25V12.125H7.75C7.12868 12.125 6.625 11.6213 6.625 11C6.625 10.3787 7.12868 9.875 7.75 9.875H9.875V7.75C9.875 7.12868 10.3787 6.625 11 6.625Z"/>
+<path class="fg" d="M23.25 9.875C23.8713 9.875 24.375 10.3787 24.375 11C24.375 11.6213 23.8713 12.125 23.25 12.125H18.75C18.1287 12.125 17.625 11.6213 17.625 11C17.625 10.3787 18.1287 9.875 18.75 9.875H23.25Z"/>
 </svg>
diff --git a/apps/docs/public/favicon.png b/apps/docs/public/favicon.png
deleted file mode 100644
index 57acd9404..000000000
Binary files a/apps/docs/public/favicon.png and /dev/null differ
diff --git a/apps/docs/public/favicon.svg b/apps/docs/public/favicon.svg
deleted file mode 100644
index 258009674..000000000
--- a/apps/docs/public/favicon.svg
+++ /dev/null
@@ -1 +0,0 @@
-<svg fill="none" height="32" viewBox="0 0 32 32" width="32" xmlns="http://www.w3.org/2000/svg"><path d="m16 0c-13.176 0-16 2.824-16 16s2.824 16 16 16 16-2.824 16-16-2.824-16-16-16z" fill="#000"/><g fill="#fff"><path d="m17.5001 8.59222c0-.82842-.6716-1.5-1.5-1.5-.8285 0-1.5.67158-1.5 1.5v3.90778h-4.0001c-.82843 0-1.5.6716-1.5 1.5s.67157 1.5 1.5 1.5h4.0001v3h3v-3h3.9999c.8284 0 1.5-.6716 1.5-1.5s-.6716-1.5-1.5-1.5h-3.9999z"/><path d="m10.5 20c-.82843 0-1.5.6716-1.5 1.5s.67157 1.5 1.5 1.5h11c.8284 0 1.5-.6716 1.5-1.5s-.6716-1.5-1.5-1.5z"/></g></svg>
\ No newline at end of file
diff --git a/apps/docs/public/trees-brand/icon.svg b/apps/docs/public/trees-brand/icon.svg
index 5c91e09af..7eb124526 100644
--- a/apps/docs/public/trees-brand/icon.svg
+++ b/apps/docs/public/trees-brand/icon.svg
@@ -1,4 +1,5 @@
 <svg width="32" height="32" viewBox="0 0 32 32" fill="none" xmlns="http://www.w3.org/2000/svg">
-<path d="M16 0C2.824 0 0 2.824 0 16C0 29.176 2.824 32 16 32C29.176 32 32 29.176 32 16C32 2.824 29.176 0 16 0Z" fill="black"/>
-<path d="M16 7C16.5851 7 17.1171 7.33994 17.3624 7.87109L23.3624 20.8711C23.5767 21.3355 23.5394 21.8777 23.2637 22.3086C22.988 22.7395 22.5116 23 22 23H10C9.48853 23 9.01207 22.7395 8.73637 22.3086C8.46068 21.8777 8.42338 21.3355 8.63774 20.8711L14.6377 7.87109L14.6875 7.77441C14.9501 7.29922 15.4515 7 16 7ZM12.3448 20H19.6553L16 12.0801L12.3448 20Z" fill="white"/>
+<style>.bg{fill:#000}.fg{fill:#fff}@media(prefers-color-scheme:dark){.bg{fill:#fff}.fg{fill:#000}}</style>
+<path class="bg" d="M16 0C2.824 0 0 2.824 0 16C0 29.176 2.824 32 16 32C29.176 32 32 29.176 32 16C32 2.824 29.176 0 16 0Z"/>
+<path class="fg" d="M16 7C16.5851 7 17.1171 7.33994 17.3624 7.87109L23.3624 20.8711C23.5767 21.3355 23.5394 21.8777 23.2637 22.3086C22.988 22.7395 22.5116 23 22 23H10C9.48853 23 9.01207 22.7395 8.73637 22.3086C8.46068 21.8777 8.42338 21.3355 8.63774 20.8711L14.6377 7.87109L14.6875 7.77441C14.9501 7.29922 15.4515 7 16 7ZM12.3448 20H19.6553L16 12.0801L12.3448 20Z"/>
 </svg>