diff --git a/README.md b/README.md
index 8b4d32a2..5f152cca 100644
--- a/README.md
+++ b/README.md
@@ -1,9 +1,22 @@
-# KTX
+<h1 align="center">
+  <img src="assets/ktx-readme-header.png" alt="KTX" width="472" />
+</h1>
 
-KTX is a workspace-first context layer for database agents. It stores warehouse
-memory in a project directory, generates and validates semantic-layer YAML,
-indexes knowledge, scans database schemas, and exposes the result through a CLI
-and MCP server.
+<p align="center">
+  <strong>Workspace-first context layer for database agents</strong>
+</p>
+
+<p align="center">
+  <a href="https://www.npmjs.com/package/@kaelio/ktx"><img src="https://img.shields.io/npm/v/@kaelio/ktx?style=flat-square&color=f97316" alt="npm version" /></a>
+  <a href="https://github.com/Kaelio/ktx/blob/main/LICENSE"><img src="https://img.shields.io/badge/license-Apache%202.0-blue?style=flat-square" alt="License" /></a>
+  <a href="https://github.com/Kaelio/ktx"><img src="https://img.shields.io/github/stars/Kaelio/ktx?style=flat-square" alt="GitHub stars" /></a>
+</p>
+
+---
+
+KTX stores warehouse memory in a project directory, generates and validates
+semantic-layer YAML, indexes knowledge, scans database schemas, and exposes the
+result through a CLI and MCP server.
 
 KTX projects are plain files: YAML, Markdown, SQLite state, and generated
 artifacts. You can inspect them, commit them, and serve them to any MCP client.
diff --git a/assets/ktx-readme-header.png b/assets/ktx-readme-header.png
new file mode 100644
index 00000000..11cfb4e4
Binary files /dev/null and b/assets/ktx-readme-header.png differ
diff --git a/docs-site/components/logo.tsx b/docs-site/components/logo.tsx
index e47cc394..db67a689 100644
--- a/docs-site/components/logo.tsx
+++ b/docs-site/components/logo.tsx
@@ -2,42 +2,12 @@ export function Logo() {
   return (
     <div className="flex items-center gap-2 group">
       <div className="relative flex items-center justify-center transition-transform duration-300 ease-out group-hover:rotate-[-4deg]">
-        <svg
-          width="22"
-          height="22"
-          viewBox="0 0 24 24"
-          fill="none"
-          xmlns="http://www.w3.org/2000/svg"
+        <img
+          src="/brand/ktx-mascot.png"
+          alt=""
           aria-hidden="true"
-        >
-          <defs>
-            <linearGradient id="ktx-grad-a" x1="0" y1="0" x2="24" y2="24" gradientUnits="userSpaceOnUse">
-              <stop offset="0%" stopColor="var(--color-fd-primary)" />
-              <stop offset="100%" stopColor="var(--color-fd-primary)" stopOpacity="0.55" />
-            </linearGradient>
-            <linearGradient id="ktx-grad-b" x1="0" y1="0" x2="24" y2="24" gradientUnits="userSpaceOnUse">
-              <stop offset="0%" stopColor="var(--color-fd-primary)" stopOpacity="0.85" />
-              <stop offset="100%" stopColor="var(--color-fd-primary)" stopOpacity="0.4" />
-            </linearGradient>
-          </defs>
-          {/* Bottom layer */}
-          <path
-            d="M3 17 L12 21.5 L21 17 L12 12.5 Z"
-            fill="url(#ktx-grad-a)"
-            opacity="0.4"
-          />
-          {/* Middle layer */}
-          <path
-            d="M3 12 L12 16.5 L21 12 L12 7.5 Z"
-            fill="url(#ktx-grad-b)"
-            opacity="0.7"
-          />
-          {/* Top layer */}
-          <path
-            d="M3 7 L12 11.5 L21 7 L12 2.5 Z"
-            fill="var(--color-fd-primary)"
-          />
-        </svg>
+          className="h-8 w-8 object-contain"
+        />
       </div>
       <span
         className="text-[15px] font-semibold text-fd-foreground tracking-tight"
diff --git a/docs-site/public/brand/ktx-mascot.png b/docs-site/public/brand/ktx-mascot.png
new file mode 100644
index 00000000..9440f1a3
Binary files /dev/null and b/docs-site/public/brand/ktx-mascot.png differ