diff --git a/.changeset/studio-favicon.md b/.changeset/studio-favicon.md
new file mode 100644
index 00000000..ecc3cd5a
--- /dev/null
+++ b/.changeset/studio-favicon.md
@@ -0,0 +1,4 @@
+---
+"@cloudhal/cli": patch
+---
+Studio has a favicon: the Cloudhal mark.
diff --git a/apps/docs/astro.config.ts b/apps/docs/astro.config.ts
index 6b7dad7b..b99be268 100644
--- a/apps/docs/astro.config.ts
+++ b/apps/docs/astro.config.ts
@@ -11,12 +11,15 @@ export default defineConfig({
   integrations: [
     starlight({
       title: "Cloudhal",
+      logo: { src: "./src/assets/mark.svg", alt: "" },
       description: "Open-source, agent-native site platform.",
       social: [
         { icon: "github", label: "GitHub", href: "https://github.com/cloudhal-dev/cloudhal" },
       ],
       customCss: ["./src/styles/custom.css"],
       head: [
+        { tag: "link", attrs: { rel: "icon", href: "/favicon.ico", sizes: "32x32" } },
+        { tag: "link", attrs: { rel: "apple-touch-icon", href: "/apple-touch-icon.png" } },
         {
           tag: "link",
           attrs: { rel: "alternate", type: "text/markdown", href: "/llms.txt", title: "llms.txt" },
diff --git a/apps/docs/public/apple-touch-icon.png b/apps/docs/public/apple-touch-icon.png
new file mode 100644
index 00000000..89270d76
Binary files /dev/null and b/apps/docs/public/apple-touch-icon.png differ
diff --git a/apps/docs/public/favicon.ico b/apps/docs/public/favicon.ico
new file mode 100644
index 00000000..8eabf086
Binary files /dev/null and b/apps/docs/public/favicon.ico differ
diff --git a/apps/docs/public/favicon.svg b/apps/docs/public/favicon.svg
index a000f8eb..01c29163 100644
--- a/apps/docs/public/favicon.svg
+++ b/apps/docs/public/favicon.svg
@@ -1 +1 @@
-<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 32 32"><title>Cloudhal</title><rect width="32" height="32" rx="7" fill="#b4441f"/><circle cx="16" cy="16" r="7.5" fill="none" stroke="#fff" stroke-width="3"/><circle cx="16" cy="16" r="2.5" fill="#fff"/></svg>
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 64 64"><title>Cloudhal</title><rect width="64" height="64" rx="14" fill="#b4441f"/><circle cx="32" cy="32" r="21.3" fill="#5a200c"/><circle cx="32" cy="32" r="16.5" fill="none" stroke="#f6c3ad" stroke-width="1.6"/><circle cx="32" cy="32" r="10.7" fill="#ee8a64"/><circle cx="32" cy="32" r="4.8" fill="#fff4ec"/></svg>
diff --git a/apps/docs/src/assets/mark.svg b/apps/docs/src/assets/mark.svg
new file mode 100644
index 00000000..01c29163
--- /dev/null
+++ b/apps/docs/src/assets/mark.svg
@@ -0,0 +1 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 64 64"><title>Cloudhal</title><rect width="64" height="64" rx="14" fill="#b4441f"/><circle cx="32" cy="32" r="21.3" fill="#5a200c"/><circle cx="32" cy="32" r="16.5" fill="none" stroke="#f6c3ad" stroke-width="1.6"/><circle cx="32" cy="32" r="10.7" fill="#ee8a64"/><circle cx="32" cy="32" r="4.8" fill="#fff4ec"/></svg>
diff --git a/apps/studio/index.html b/apps/studio/index.html
index 3231fe26..296a3344 100644
--- a/apps/studio/index.html
+++ b/apps/studio/index.html
@@ -4,6 +4,9 @@
     <meta charset="utf-8" />
     <meta name="viewport" content="width=device-width, initial-scale=1" />
     <title>Cloudhal Studio</title>
+    <link rel="icon" href="/favicon.svg" type="image/svg+xml" />
+    <link rel="icon" href="/favicon.ico" sizes="32x32" />
+    <link rel="apple-touch-icon" href="/apple-touch-icon.png" />
     <script>
       // Apply the stored colour scheme (light, dark, or the OS's) before first paint; Kumo switches
       // themes on data-mode (DESIGN.md §4). Keep the key in sync with src/lib/theme.ts.
diff --git a/apps/studio/public/apple-touch-icon.png b/apps/studio/public/apple-touch-icon.png
new file mode 100644
index 00000000..89270d76
Binary files /dev/null and b/apps/studio/public/apple-touch-icon.png differ
diff --git a/apps/studio/public/favicon.ico b/apps/studio/public/favicon.ico
new file mode 100644
index 00000000..8eabf086
Binary files /dev/null and b/apps/studio/public/favicon.ico differ
diff --git a/apps/studio/public/favicon.svg b/apps/studio/public/favicon.svg
new file mode 100644
index 00000000..01c29163
--- /dev/null
+++ b/apps/studio/public/favicon.svg
@@ -0,0 +1 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 64 64"><title>Cloudhal</title><rect width="64" height="64" rx="14" fill="#b4441f"/><circle cx="32" cy="32" r="21.3" fill="#5a200c"/><circle cx="32" cy="32" r="16.5" fill="none" stroke="#f6c3ad" stroke-width="1.6"/><circle cx="32" cy="32" r="10.7" fill="#ee8a64"/><circle cx="32" cy="32" r="4.8" fill="#fff4ec"/></svg>
diff --git a/brand/README.md b/brand/README.md
new file mode 100644
index 00000000..5d044c8c
--- /dev/null
+++ b/brand/README.md
@@ -0,0 +1,31 @@
+# Cloudhal brand
+
+The mark is the **Lens**: a calm, always-on eye in Cloudhal orange. It stands for an agent that watches, previews and waits for a person before anything goes live.
+
+| File | Use |
+|---|---|
+| `mark.svg` | The mark in colour. Favicons, avatars, app icons |
+| `mark-mono.svg` | One colour (`currentColor`), for single-colour print, stamps and embossing |
+| `wordmark-light.svg`, `wordmark-dark.svg` | Mark and name, for light and dark backgrounds |
+| `favicon.ico` (16, 32, 48), `apple-touch-icon.png` (180), `mark-512.png` | Raster sizes |
+| `social-preview.html` → `social-preview.png` | The 1280×640 card for GitHub and link previews |
+
+## Colours
+
+| Name | Hex | Role |
+|---|---|---|
+| Cloudhal orange | `#b4441f` | The tile; accent on light backgrounds |
+| Ember | `#5a200c` | The lens body |
+| Glow | `#ee8a64` | The core; accent on dark backgrounds |
+| Halo | `#f6c3ad` | The ring |
+| Spark | `#fff4ec` | The pupil |
+| Ink | `#1c1c1a` / `#141413` | Text and dark backgrounds |
+
+## Rules
+
+- Keep the mark square with its rounded corners (radius 14/64). Don't recolour the lens, add a frame, bevel or reflection, or turn it red.
+- Clear space around the mark: at least a quarter of its width.
+- Smallest size: 16 px.
+- The name is written **Cloudhal**, one word, capital C only.
+
+Rendering the PNGs: open the SVG or HTML in headless Chrome at the target size (see the commit that added this folder).
diff --git a/brand/apple-touch-icon.png b/brand/apple-touch-icon.png
new file mode 100644
index 00000000..89270d76
Binary files /dev/null and b/brand/apple-touch-icon.png differ
diff --git a/brand/favicon.ico b/brand/favicon.ico
new file mode 100644
index 00000000..8eabf086
Binary files /dev/null and b/brand/favicon.ico differ
diff --git a/brand/mark-512.png b/brand/mark-512.png
new file mode 100644
index 00000000..a39edc95
Binary files /dev/null and b/brand/mark-512.png differ
diff --git a/brand/mark-mono.svg b/brand/mark-mono.svg
new file mode 100644
index 00000000..e05f7f4e
--- /dev/null
+++ b/brand/mark-mono.svg
@@ -0,0 +1 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 64 64"><title>Cloudhal</title><path fill="currentColor" fill-rule="evenodd" d="M14 0h36a14 14 0 0 1 14 14v36a14 14 0 0 1-14 14H14A14 14 0 0 1 0 50V14A14 14 0 0 1 14 0Zm18 15.5a16.5 16.5 0 1 0 0 33 16.5 16.5 0 0 0 0-33Zm0 1.6a14.9 14.9 0 1 1 0 29.8 14.9 14.9 0 0 1 0-29.8Zm0 10.1a4.8 4.8 0 1 0 0 9.6 4.8 4.8 0 0 0 0-9.6Z"/></svg>
diff --git a/brand/mark.svg b/brand/mark.svg
new file mode 100644
index 00000000..01c29163
--- /dev/null
+++ b/brand/mark.svg
@@ -0,0 +1 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 64 64"><title>Cloudhal</title><rect width="64" height="64" rx="14" fill="#b4441f"/><circle cx="32" cy="32" r="21.3" fill="#5a200c"/><circle cx="32" cy="32" r="16.5" fill="none" stroke="#f6c3ad" stroke-width="1.6"/><circle cx="32" cy="32" r="10.7" fill="#ee8a64"/><circle cx="32" cy="32" r="4.8" fill="#fff4ec"/></svg>
diff --git a/brand/social-preview.html b/brand/social-preview.html
new file mode 100644
index 00000000..8e964b05
--- /dev/null
+++ b/brand/social-preview.html
@@ -0,0 +1,19 @@
+<!doctype html><html lang="en"><head><meta charset="utf-8"><style>
+*{margin:0;box-sizing:border-box}
+body{width:1280px;height:640px;background:#141413;color:#ececea;font-family:-apple-system,"Helvetica Neue",Inter,sans-serif;display:flex;flex-direction:column;justify-content:space-between;padding:84px 96px;position:relative;overflow:hidden}
+.glow{position:absolute;right:-180px;top:-200px;width:720px;height:720px;border-radius:50%;background:radial-gradient(circle,rgba(208,100,62,.38),rgba(208,100,62,0) 65%)}
+.brand{display:flex;align-items:center;gap:22px;position:relative}
+.mark{width:72px;height:72px;border-radius:16px;background:#b4441f;display:flex;align-items:center;justify-content:center}
+.ring{width:38px;height:38px;border-radius:50%;border:6px solid #fff;display:flex;align-items:center;justify-content:center}
+.dot{width:12px;height:12px;border-radius:50%;background:#fff}
+.name{font-size:52px;font-weight:600;letter-spacing:-.5px}
+h1{font-size:64px;line-height:1.1;font-weight:600;max-width:980px;position:relative}
+h1 em{font-style:normal;color:#ee8a64}
+.foot{display:flex;justify-content:space-between;align-items:flex-end;font-size:26px;color:#a3a39d;position:relative}
+.pills{display:flex;gap:12px}
+.pill{border:1.5px solid #3a3a37;border-radius:999px;padding:8px 18px;font-size:22px;color:#d6d6d2}
+</style></head><body><div class="glow"></div>
+<div class="brand"><img src="mark.svg" width="72" height="72" alt=""><div class="name">Cloudhal</div></div>
+<h1>Sites your agents can build,<br><em>safely.</em></h1>
+<div class="foot"><div class="pills"><span class="pill">MCP + policy engine</span><span class="pill">Snapshots &amp; rollback</span><span class="pill">Cloudflare or self-hosted</span></div><div>cloudhal.dev</div></div>
+</body></html>
diff --git a/brand/social-preview.png b/brand/social-preview.png
new file mode 100644
index 00000000..e9456fa9
Binary files /dev/null and b/brand/social-preview.png differ
diff --git a/brand/wordmark-dark.svg b/brand/wordmark-dark.svg
new file mode 100644
index 00000000..1c37869a
--- /dev/null
+++ b/brand/wordmark-dark.svg
@@ -0,0 +1 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 280 64"><title>Cloudhal</title><rect width="64" height="64" rx="14" fill="#b4441f"/><circle cx="32" cy="32" r="21.3" fill="#5a200c"/><circle cx="32" cy="32" r="16.5" fill="none" stroke="#f6c3ad" stroke-width="1.6"/><circle cx="32" cy="32" r="10.7" fill="#ee8a64"/><circle cx="32" cy="32" r="4.8" fill="#fff4ec"/><text x="82" y="45" fill="#ececea" font-family="Inter, -apple-system, 'Helvetica Neue', Arial, sans-serif" font-size="38" font-weight="600" letter-spacing="-0.5">Cloudhal</text></svg>
diff --git a/brand/wordmark-light.svg b/brand/wordmark-light.svg
new file mode 100644
index 00000000..7c471523
--- /dev/null
+++ b/brand/wordmark-light.svg
@@ -0,0 +1 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 280 64"><title>Cloudhal</title><rect width="64" height="64" rx="14" fill="#b4441f"/><circle cx="32" cy="32" r="21.3" fill="#5a200c"/><circle cx="32" cy="32" r="16.5" fill="none" stroke="#f6c3ad" stroke-width="1.6"/><circle cx="32" cy="32" r="10.7" fill="#ee8a64"/><circle cx="32" cy="32" r="4.8" fill="#fff4ec"/><text x="82" y="45" fill="#1c1c1a" font-family="Inter, -apple-system, 'Helvetica Neue', Arial, sans-serif" font-size="38" font-weight="600" letter-spacing="-0.5">Cloudhal</text></svg>