diff --git a/apps/docs-site/404.html b/apps/docs-site/404.html
index 4641eea..1822215 100644
--- a/apps/docs-site/404.html
+++ b/apps/docs-site/404.html
@@ -7,8 +7,8 @@
   <meta name="description" content="That page is not here. The Crosscode docs index, the install quickstart and the CLI reference are all one link away from this page." />
   <meta name="robots" content="noindex" />
   <link rel="canonical" href="https://www.getcrosscode.dev/404.html" />
-  <link rel="icon" href="/brand/favicon.svg" type="image/svg+xml" />
-  <link rel="alternate icon" href="/favicon.ico" sizes="16x16 32x32 48x48" />
+  <link rel="icon" href="/favicon.ico" sizes="48x48" />
+  <link rel="icon" href="/brand/favicon.svg" type="image/svg+xml" sizes="any" />
   <link rel="icon" type="image/png" sizes="192x192" href="/brand/favicon-192.png" />
   <link rel="apple-touch-icon" href="/brand/apple-touch-icon.png" />
   <meta property="og:site_name" content="Crosscode" />
diff --git a/apps/docs-site/auth/cli.html b/apps/docs-site/auth/cli.html
index a235d55..7a1e9bf 100644
--- a/apps/docs-site/auth/cli.html
+++ b/apps/docs-site/auth/cli.html
@@ -7,8 +7,8 @@
   <meta name="robots" content="noindex" />
   <meta name="description" content="Authorize the crosscode CLI on this machine. Signing in here hands the waiting terminal a session it stores locally, mode 0600." />
   <link rel="canonical" href="https://www.getcrosscode.dev/auth/cli.html" />
-  <link rel="icon" href="/brand/favicon.svg" type="image/svg+xml" />
-  <link rel="alternate icon" href="/favicon.ico" sizes="16x16 32x32 48x48" />
+  <link rel="icon" href="/favicon.ico" sizes="48x48" />
+  <link rel="icon" href="/brand/favicon.svg" type="image/svg+xml" sizes="any" />
   <link rel="icon" type="image/png" sizes="192x192" href="/brand/favicon-192.png" />
   <link rel="apple-touch-icon" href="/brand/apple-touch-icon.png" />
   <meta property="og:site_name" content="Crosscode" />
diff --git a/apps/docs-site/auth/reset.html b/apps/docs-site/auth/reset.html
index ed710d7..80f94ac 100644
--- a/apps/docs-site/auth/reset.html
+++ b/apps/docs-site/auth/reset.html
@@ -7,8 +7,8 @@
   <meta name="robots" content="noindex" />
   <meta name="description" content="Set a new password for your Crosscode account using the one-time reset link sent to your email address." />
   <link rel="canonical" href="https://www.getcrosscode.dev/auth/reset.html" />
-  <link rel="icon" href="/brand/favicon.svg" type="image/svg+xml" />
-  <link rel="alternate icon" href="/favicon.ico" sizes="16x16 32x32 48x48" />
+  <link rel="icon" href="/favicon.ico" sizes="48x48" />
+  <link rel="icon" href="/brand/favicon.svg" type="image/svg+xml" sizes="any" />
   <link rel="icon" type="image/png" sizes="192x192" href="/brand/favicon-192.png" />
   <link rel="apple-touch-icon" href="/brand/apple-touch-icon.png" />
   <meta property="og:site_name" content="Crosscode" />
diff --git a/apps/docs-site/auth/signin.html b/apps/docs-site/auth/signin.html
index d3393bc..cf4dbc4 100644
--- a/apps/docs-site/auth/signin.html
+++ b/apps/docs-site/auth/signin.html
@@ -7,8 +7,8 @@
   <meta name="robots" content="noindex" />
   <meta name="description" content="Sign in to your Crosscode account to manage projects and invite teammates into a checkout that stays in sync with yours." />
   <link rel="canonical" href="https://www.getcrosscode.dev/auth/signin.html" />
-  <link rel="icon" href="/brand/favicon.svg" type="image/svg+xml" />
-  <link rel="alternate icon" href="/favicon.ico" sizes="16x16 32x32 48x48" />
+  <link rel="icon" href="/favicon.ico" sizes="48x48" />
+  <link rel="icon" href="/brand/favicon.svg" type="image/svg+xml" sizes="any" />
   <link rel="icon" type="image/png" sizes="192x192" href="/brand/favicon-192.png" />
   <link rel="apple-touch-icon" href="/brand/apple-touch-icon.png" />
   <meta property="og:site_name" content="Crosscode" />
diff --git a/apps/docs-site/auth/signup.html b/apps/docs-site/auth/signup.html
index d2b6b4d..0f76f13 100644
--- a/apps/docs-site/auth/signup.html
+++ b/apps/docs-site/auth/signup.html
@@ -7,8 +7,8 @@
   <meta name="robots" content="noindex" />
   <meta name="description" content="Create a Crosscode account to sync uncommitted edits between your own checkouts and your teammates', without pushing a branch first." />
   <link rel="canonical" href="https://www.getcrosscode.dev/auth/signup.html" />
-  <link rel="icon" href="/brand/favicon.svg" type="image/svg+xml" />
-  <link rel="alternate icon" href="/favicon.ico" sizes="16x16 32x32 48x48" />
+  <link rel="icon" href="/favicon.ico" sizes="48x48" />
+  <link rel="icon" href="/brand/favicon.svg" type="image/svg+xml" sizes="any" />
   <link rel="icon" type="image/png" sizes="192x192" href="/brand/favicon-192.png" />
   <link rel="apple-touch-icon" href="/brand/apple-touch-icon.png" />
   <meta property="og:site_name" content="Crosscode" />
diff --git a/apps/docs-site/device.html b/apps/docs-site/device.html
index b6dfcd9..cc2056c 100644
--- a/apps/docs-site/device.html
+++ b/apps/docs-site/device.html
@@ -7,8 +7,8 @@
   <meta name="robots" content="noindex" />
   <meta name="description" content="Finish signing in the crosscode CLI on this machine. Enter the device code your terminal printed and the session is bound to that terminal." />
   <link rel="canonical" href="https://www.getcrosscode.dev/device" />
-  <link rel="icon" href="/brand/favicon.svg" type="image/svg+xml" />
-  <link rel="alternate icon" href="/favicon.ico" sizes="16x16 32x32 48x48" />
+  <link rel="icon" href="/favicon.ico" sizes="48x48" />
+  <link rel="icon" href="/brand/favicon.svg" type="image/svg+xml" sizes="any" />
   <link rel="icon" type="image/png" sizes="192x192" href="/brand/favicon-192.png" />
   <link rel="apple-touch-icon" href="/brand/apple-touch-icon.png" />
   <meta property="og:site_name" content="Crosscode" />
diff --git a/apps/docs-site/docs/cli.html b/apps/docs-site/docs/cli.html
index e4d32ba..9515f0b 100644
--- a/apps/docs-site/docs/cli.html
+++ b/apps/docs-site/docs/cli.html
@@ -6,8 +6,8 @@
   <title>Command reference · Crosscode CLI (MCP server)</title>
   <meta name="description" content="All five crosscode commands in full. The Crosscode CLI holds no sync state; it talks to the local daemon over an authenticated loopback HTTP API, and so does the MCP server." />
   <link rel="canonical" href="https://www.getcrosscode.dev/docs/cli.html" />
-  <link rel="icon" href="/brand/favicon.svg" type="image/svg+xml" />
-  <link rel="alternate icon" href="/favicon.ico" sizes="16x16 32x32 48x48" />
+  <link rel="icon" href="/favicon.ico" sizes="48x48" />
+  <link rel="icon" href="/brand/favicon.svg" type="image/svg+xml" sizes="any" />
   <link rel="icon" type="image/png" sizes="192x192" href="/brand/favicon-192.png" />
   <link rel="apple-touch-icon" href="/brand/apple-touch-icon.png" />
   <meta property="og:site_name" content="Crosscode" />
diff --git a/apps/docs-site/docs/index.html b/apps/docs-site/docs/index.html
index 3ec8e5d..8bafb91 100644
--- a/apps/docs-site/docs/index.html
+++ b/apps/docs-site/docs/index.html
@@ -6,8 +6,8 @@
   <title>Docs · Crosscode CLI (MCP server)</title>
   <meta name="description" content="Crosscode CLI keeps several checkouts of one repository in sync in real time, and exposes that sync to your coding agent over MCP. Start here for the architecture, the safety model, install steps and the CLI reference." />
   <link rel="canonical" href="https://www.getcrosscode.dev/docs/index.html" />
-  <link rel="icon" href="/brand/favicon.svg" type="image/svg+xml" />
-  <link rel="alternate icon" href="/favicon.ico" sizes="16x16 32x32 48x48" />
+  <link rel="icon" href="/favicon.ico" sizes="48x48" />
+  <link rel="icon" href="/brand/favicon.svg" type="image/svg+xml" sizes="any" />
   <link rel="icon" type="image/png" sizes="192x192" href="/brand/favicon-192.png" />
   <link rel="apple-touch-icon" href="/brand/apple-touch-icon.png" />
   <meta property="og:site_name" content="Crosscode" />
diff --git a/apps/docs-site/docs/install.html b/apps/docs-site/docs/install.html
index 2c5ae17..0dcdf03 100644
--- a/apps/docs-site/docs/install.html
+++ b/apps/docs-site/docs/install.html
@@ -6,8 +6,8 @@
   <title>Install &amp; quickstart · Crosscode CLI (MCP server)</title>
   <meta name="description" content="One command sets up a checkout end to end: install the Crosscode CLI, sign the terminal in, start the daemon and point your coding agent at the local MCP server." />
   <link rel="canonical" href="https://www.getcrosscode.dev/docs/install.html" />
-  <link rel="icon" href="/brand/favicon.svg" type="image/svg+xml" />
-  <link rel="alternate icon" href="/favicon.ico" sizes="16x16 32x32 48x48" />
+  <link rel="icon" href="/favicon.ico" sizes="48x48" />
+  <link rel="icon" href="/brand/favicon.svg" type="image/svg+xml" sizes="any" />
   <link rel="icon" type="image/png" sizes="192x192" href="/brand/favicon-192.png" />
   <link rel="apple-touch-icon" href="/brand/apple-touch-icon.png" />
   <meta property="og:site_name" content="Crosscode" />
diff --git a/apps/docs-site/docs/limitations.html b/apps/docs-site/docs/limitations.html
index 2775357..f646ad2 100644
--- a/apps/docs-site/docs/limitations.html
+++ b/apps/docs-site/docs/limitations.html
@@ -6,8 +6,8 @@
   <title>Current limitations · Crosscode CLI (MCP server)</title>
   <meta name="description" content="What the Crosscode CLI and its MCP server deliberately leave out, and where their edges are. A plain account of scope." />
   <link rel="canonical" href="https://www.getcrosscode.dev/docs/limitations.html" />
-  <link rel="icon" href="/brand/favicon.svg" type="image/svg+xml" />
-  <link rel="alternate icon" href="/favicon.ico" sizes="16x16 32x32 48x48" />
+  <link rel="icon" href="/favicon.ico" sizes="48x48" />
+  <link rel="icon" href="/brand/favicon.svg" type="image/svg+xml" sizes="any" />
   <link rel="icon" type="image/png" sizes="192x192" href="/brand/favicon-192.png" />
   <link rel="apple-touch-icon" href="/brand/apple-touch-icon.png" />
   <meta property="og:site_name" content="Crosscode" />
diff --git a/apps/docs-site/index.html b/apps/docs-site/index.html
index b912850..16f4d89 100644
--- a/apps/docs-site/index.html
+++ b/apps/docs-site/index.html
@@ -6,8 +6,8 @@
   <title>Crosscode CLI — an MCP server for real-time codebase sync between coding agents</title>
   <meta name="description" content="Crosscode CLI runs an MCP server next to each checkout. Everyone works in their own checkout with their own coding agent, and each settled edit reaches whoever is on the same branch within seconds. The only interruption is a same-line conflict, and that goes to your own agent." />
   <link rel="canonical" href="https://www.getcrosscode.dev/" />
-  <link rel="icon" href="/brand/favicon.svg" type="image/svg+xml" />
-  <link rel="alternate icon" href="/favicon.ico" sizes="16x16 32x32 48x48" />
+  <link rel="icon" href="/favicon.ico" sizes="48x48" />
+  <link rel="icon" href="/brand/favicon.svg" type="image/svg+xml" sizes="any" />
   <link rel="icon" type="image/png" sizes="192x192" href="/brand/favicon-192.png" />
   <link rel="apple-touch-icon" href="/brand/apple-touch-icon.png" />
   <meta property="og:type" content="website" />
diff --git a/apps/docs-site/join.html b/apps/docs-site/join.html
index c3b1569..ac1f8c5 100644
--- a/apps/docs-site/join.html
+++ b/apps/docs-site/join.html
@@ -7,8 +7,8 @@
   <meta name="robots" content="noindex" />
   <meta name="description" content="Open a Crosscode invite link to join a teammate's project: sign in, confirm the repository, and clone it into a checkout the daemon keeps in sync." />
   <link rel="canonical" href="https://www.getcrosscode.dev/join.html" />
-  <link rel="icon" href="/brand/favicon.svg" type="image/svg+xml" />
-  <link rel="alternate icon" href="/favicon.ico" sizes="16x16 32x32 48x48" />
+  <link rel="icon" href="/favicon.ico" sizes="48x48" />
+  <link rel="icon" href="/brand/favicon.svg" type="image/svg+xml" sizes="any" />
   <link rel="icon" type="image/png" sizes="192x192" href="/brand/favicon-192.png" />
   <link rel="apple-touch-icon" href="/brand/apple-touch-icon.png" />
   <meta property="og:site_name" content="Crosscode" />
diff --git a/apps/docs-site/scripts/generate-docs.mjs b/apps/docs-site/scripts/generate-docs.mjs
index 8d30a68..0e8ce7b 100644
--- a/apps/docs-site/scripts/generate-docs.mjs
+++ b/apps/docs-site/scripts/generate-docs.mjs
@@ -328,8 +328,8 @@ function renderPage({ title, activeKey, description, canonicalPath, bodyHtml, md
   <title>${fullTitle}</title>
   <meta name="description" content="${escapeAttr(description)}" />
   <link rel="canonical" href="${canonical}" />
-  <link rel="icon" href="/brand/favicon.svg" type="image/svg+xml" />
-  <link rel="alternate icon" href="/favicon.ico" sizes="16x16 32x32 48x48" />
+  <link rel="icon" href="/favicon.ico" sizes="48x48" />
+  <link rel="icon" href="/brand/favicon.svg" type="image/svg+xml" sizes="any" />
   <link rel="icon" type="image/png" sizes="192x192" href="/brand/favicon-192.png" />
   <link rel="apple-touch-icon" href="/brand/apple-touch-icon.png" />
   <meta property="og:type" content="article" />