diff --git a/README.md b/README.md
index 5382335..1b913ad 100644
--- a/README.md
+++ b/README.md
@@ -1,5 +1,7 @@
 <div align="center">
 
+<img src="docs/img/context-guru.png" alt="context-guru" width="160" />
+
 # context-guru
 
 **Provider-agnostic context engineering for LLM agents.**
diff --git a/docs/img/context-guru.png b/docs/img/context-guru.png
new file mode 100644
index 0000000..efa8210
Binary files /dev/null and b/docs/img/context-guru.png differ
diff --git a/docs/stylesheets/extra.css b/docs/stylesheets/extra.css
index 3dd4bfc..66260a8 100644
--- a/docs/stylesheets/extra.css
+++ b/docs/stylesheets/extra.css
@@ -32,6 +32,15 @@
   max-width: 52rem;
   margin: 0 auto;
 }
+.cg-hero__logo {
+  width: 120px;
+  height: 120px;
+  object-fit: contain;
+  margin-bottom: 1.5rem;
+  display: block;
+  margin-left: auto;
+  margin-right: auto;
+}
 .cg-hero__eyebrow {
   display: inline-block;
   font-size: 0.72rem;
@@ -86,6 +95,25 @@
   border: 1px solid var(--md-default-fg-color--lighter);
   color: var(--md-default-fg-color) !important;
 }
+.cg-star-wrap {
+  display: flex;
+  justify-content: center;
+  margin-bottom: 1.75rem;
+}
+.cg-btn--star {
+  background: #f0ad4e;
+  color: #1a1a1a !important;
+  font-size: 1.25rem;
+  font-weight: 800;
+  padding: 0.85rem 2.2rem;
+  border-radius: 10px;
+  box-shadow: 0 6px 22px rgba(240, 173, 78, 0.4);
+  letter-spacing: 0.01em;
+}
+.cg-btn--star:hover {
+  background: #e09938;
+  box-shadow: 0 8px 28px rgba(240, 173, 78, 0.55);
+}
 
 /* ---- Guarantee pills ---- */
 .cg-guarantees {
@@ -125,6 +153,11 @@
   margin: -0.5rem auto 2rem;
   max-width: 44rem;
 }
+.cg-section__sub--large {
+  font-size: 1.25rem;
+  font-weight: 600;
+  color: var(--md-default-fg-color);
+}
 
 /* ---- Feature cards ---- */
 .cg-cards {
diff --git a/mkdocs.yml b/mkdocs.yml
index 49405b2..f900f53 100644
--- a/mkdocs.yml
+++ b/mkdocs.yml
@@ -13,9 +13,10 @@ theme:
   name: material
   custom_dir: overrides
   language: en
+  logo: img/context-guru.png
+  favicon: img/context-guru.png
   icon:
     repo: fontawesome/brands/github
-    logo: material/scissors-cutting
   palette:
     - media: "(prefers-color-scheme)"
       toggle:
diff --git a/overrides/home.html b/overrides/home.html
index 6cff203..b386039 100644
--- a/overrides/home.html
+++ b/overrides/home.html
@@ -8,6 +8,7 @@
 
   <section class="cg-hero">
     <div class="cg-hero__inner">
+      <img src="{{ 'img/context-guru.png' | url }}" alt="context-guru logo" class="cg-hero__logo" />
       <span class="cg-hero__eyebrow">Context engineering for LLM agents</span>
       <h1>Shrink agent context.<br>Don&rsquo;t touch the agent.</h1>
       <p class="cg-hero__lede">
@@ -19,6 +20,11 @@ <h1>Shrink agent context.<br>Don&rsquo;t touch the agent.</h1>
         <a class="cg-btn cg-btn--primary" href="{{ 'get-started/quickstart-proxy/' | url }}">Start building &rarr;</a>
         <a class="cg-btn cg-btn--ghost" href="https://github.com/rossoctl/context-guru">View on GitHub</a>
       </div>
+      <div class="cg-star-wrap">
+        <a class="cg-btn cg-btn--star" href="https://github.com/rossoctl/context-guru" target="_blank" rel="noopener">
+          &#9733; Star on GitHub
+        </a>
+      </div>
       <div class="cg-guarantees">
         <span class="cg-pill">Fail open, always</span>
         <span class="cg-pill">Never worse</span>
@@ -29,9 +35,9 @@ <h1>Shrink agent context.<br>Don&rsquo;t touch the agent.</h1>
 
   <section class="cg-section">
     <h2>Run it in one line</h2>
-    <p class="cg-section__sub">Point any agent at the proxy &mdash; one port serves both dialects.</p>
+    <p class="cg-section__sub cg-section__sub--large">Point any agent at the proxy &mdash; one port serves both dialects.</p>
     <div class="highlight" style="max-width:42rem;margin:0 auto;border-radius:10px;">
-<pre style="border-radius:10px;"><code>context-guru-proxy --preset general            <span style="opacity:.6"># recommended; or --config cg.yaml</span>
+<pre style="border-radius:10px;font-size:1rem;line-height:1.65;"><code>context-guru-proxy --preset general            <span style="opacity:.6"># recommended; or --config cg.yaml</span>
 
 ANTHROPIC_BASE_URL=http://localhost:4000/anthropic
 OPENAI_BASE_URL=http://localhost:4000/openai/v1</code></pre>