diff --git a/layouts/index.html b/layouts/index.html
index ca3f99c..39e79ec 100644
--- a/layouts/index.html
+++ b/layouts/index.html
@@ -54,6 +54,7 @@
     display: inline-block; padding: 10px 18px; margin: 4px; border-radius: 8px; text-decoration: none;
     font-weight: 600; border: 1px solid var(--border);
   }
+  .btn .icon{display:inline-block;vertical-align:-0.15em;margin-right:.45em}
   .btn.primary { background: var(--accent); color: var(--accent-fg); border-color: var(--accent); }
   .btn.ghost { color: var(--fg); background: transparent; }
   .lead { color: var(--fg); max-width: 820px; margin: 8px auto 0; text-align: center; }
@@ -107,8 +108,8 @@ <h1>go-webengine</h1>
       <span class="pill">measured vs headless Chrome</span>
     </div>
     <div class="cta">
-      <a class="btn primary" href="https://go-webengine.github.io/docs/">Documentation</a>
-      <a class="btn ghost" href="https://github.com/go-webengine/engine">GitHub</a>
+      <a class="btn primary" href="https://go-webengine.github.io/docs/">{{ partial "icons/book.html" . }}Documentation</a>
+      <a class="btn ghost" href="https://github.com/go-webengine/engine">{{ partial "icons/mark-github.html" . }}GitHub</a>
     </div>
   </header>
 
diff --git a/layouts/partials/icons/OCTICONS-LICENSE b/layouts/partials/icons/OCTICONS-LICENSE
new file mode 100644
index 0000000..aa1fa80
--- /dev/null
+++ b/layouts/partials/icons/OCTICONS-LICENSE
@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 GitHub Inc.
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
diff --git a/layouts/partials/icons/book.html b/layouts/partials/icons/book.html
new file mode 100644
index 0000000..cf1e882
--- /dev/null
+++ b/layouts/partials/icons/book.html
@@ -0,0 +1,5 @@
+{{- /* Octicons "book" (16 px), primer/octicons @primer/octicons-react@19.40.0, copied verbatim, MIT,
+     (c) GitHub Inc.: the licence is OCTICONS-LICENSE beside this file.
+     currentColor follows the button in light and dark; aria-hidden, since
+     the button's text already says where it leads. */ -}}
+<svg class="icon" xmlns="http://www.w3.org/2000/svg" width="16" height="16" viewBox="0 0 16 16" fill="currentColor" aria-hidden="true" focusable="false"><path d="M0 1.75A.75.75 0 0 1 .75 1h4.253c1.227 0 2.317.59 3 1.501A3.743 3.743 0 0 1 11.006 1h4.245a.75.75 0 0 1 .75.75v10.5a.75.75 0 0 1-.75.75h-4.507a2.25 2.25 0 0 0-1.591.659l-.622.621a.75.75 0 0 1-1.06 0l-.622-.621A2.25 2.25 0 0 0 5.258 13H.75a.75.75 0 0 1-.75-.75Zm7.251 10.324.004-5.073-.002-2.253A2.25 2.25 0 0 0 5.003 2.5H1.5v9h3.757a3.75 3.75 0 0 1 1.994.574ZM8.755 4.75l-.004 7.322a3.752 3.752 0 0 1 1.992-.572H14.5v-9h-3.495a2.25 2.25 0 0 0-2.25 2.25Z"/></svg>
\ No newline at end of file
diff --git a/layouts/partials/icons/mark-github.html b/layouts/partials/icons/mark-github.html
new file mode 100644
index 0000000..17fc355
--- /dev/null
+++ b/layouts/partials/icons/mark-github.html
@@ -0,0 +1,5 @@
+{{- /* Octicons "mark-github" (16 px), primer/octicons @primer/octicons-react@19.40.0, copied verbatim, MIT,
+     (c) GitHub Inc.: the licence is OCTICONS-LICENSE beside this file.
+     currentColor follows the button in light and dark; aria-hidden, since
+     the button's text already says where it leads. */ -}}
+<svg class="icon" xmlns="http://www.w3.org/2000/svg" width="16" height="16" viewBox="0 0 16 16" fill="currentColor" aria-hidden="true" focusable="false"><path d="M6.766 11.328c-2.063-.25-3.516-1.734-3.516-3.656 0-.781.281-1.625.75-2.188-.203-.515-.172-1.609.063-2.062.625-.078 1.468.25 1.968.703.594-.187 1.219-.281 1.985-.281.765 0 1.39.094 1.953.265.484-.437 1.344-.765 1.969-.687.218.422.25 1.515.046 2.047.5.593.766 1.39.766 2.203 0 1.922-1.453 3.375-3.547 3.64.531.344.89 1.094.89 1.954v1.625c0 .468.391.734.86.547C13.781 14.359 16 11.53 16 8.03 16 3.61 12.406 0 7.984 0 3.563 0 0 3.61 0 8.031a7.88 7.88 0 0 0 5.172 7.422c.422.156.828-.125.828-.547v-1.25c-.219.094-.5.156-.75.156-1.031 0-1.64-.562-2.078-1.609-.172-.422-.36-.672-.719-.719-.187-.015-.25-.093-.25-.187 0-.188.313-.328.625-.328.453 0 .844.281 1.25.86.313.452.64.655 1.031.655s.641-.14 1-.5c.266-.265.47-.5.657-.656"/></svg>
\ No newline at end of file