From 787e50de46e2d31736000446a7ed4dee81a0d328 Mon Sep 17 00:00:00 2001
From: santhreal <64453045+santhreal@users.noreply.github.com>
Date: Sun, 2 Aug 2026 23:54:16 -0700
Subject: [PATCH] docs: replace plain title with theme-aware ASCII wordmark

Swap the Albatross H1 for the banner wordmark as a transparent SVG so it
renders without a code-block background and follows light/dark page theme.
---
 README.md                               |  4 +++-
 docs/assets/demo/README.md              |  5 +++++
 docs/assets/demo/albatross-wordmark.svg | 21 +++++++++++++++++++++
 3 files changed, 29 insertions(+), 1 deletion(-)
 create mode 100644 docs/assets/demo/README.md
 create mode 100644 docs/assets/demo/albatross-wordmark.svg

diff --git a/README.md b/README.md
index ed861eb..49cacf0 100644
--- a/README.md
+++ b/README.md
@@ -1,4 +1,6 @@
-<h1 align="center">Albatross</h1>
+<p align="center">
+  <img alt="Albatross" src="docs/assets/demo/albatross-wordmark.svg" width="720">
+</p>
 
 <p align="center">
   <strong>A small, terminal-first coding harness. Bring your own model, your own key, or your own MCP server.</strong>
diff --git a/docs/assets/demo/README.md b/docs/assets/demo/README.md
new file mode 100644
index 0000000..ec71cb8
--- /dev/null
+++ b/docs/assets/demo/README.md
@@ -0,0 +1,5 @@
+# README media
+
+| File | What |
+|------|------|
+| `albatross-wordmark.svg` | Transparent ASCII wordmark (follows light/dark page theme) |
diff --git a/docs/assets/demo/albatross-wordmark.svg b/docs/assets/demo/albatross-wordmark.svg
new file mode 100644
index 0000000..418f9a6
--- /dev/null
+++ b/docs/assets/demo/albatross-wordmark.svg
@@ -0,0 +1,21 @@
+<svg xmlns="http://www.w3.org/2000/svg" width="616" height="122" viewBox="0 0 616 122" role="img" aria-label="Albatross">
+  <title>Albatross</title>
+  <style>
+    text {
+      fill: #1f2328;
+      font-family: ui-monospace, SFMono-Regular, Menlo, Monaco, Consolas, "Liberation Mono", monospace;
+      font-size: 13px;
+      font-weight: 700;
+      white-space: pre;
+    }
+    @media (prefers-color-scheme: dark) {
+      text { fill: #e6edf3; }
+    }
+  </style>
+  <text x="8" y="23">   █████╗ ██╗     ██████╗  █████╗ ████████╗██████╗  ██████╗ ███████╗███████╗</text>
+  <text x="8" y="40">  ██╔══██╗██║     ██╔══██╗██╔══██╗╚══██╔══╝██╔══██╗██╔═══██╗██╔════╝██╔════╝</text>
+  <text x="8" y="57">  ███████║██║     ██████╔╝███████║   ██║   ██████╔╝██║   ██║███████╗███████╗</text>
+  <text x="8" y="74">  ██╔══██║██║     ██╔══██╗██╔══██║   ██║   ██╔══██╗██║   ██║╚════██║╚════██║</text>
+  <text x="8" y="91">  ██║  ██║███████╗██████╔╝██║  ██║   ██║   ██║  ██║╚██████╔╝███████║███████║</text>
+  <text x="8" y="108">  ╚═╝  ╚═╝╚══════╝╚═════╝ ╚═╝  ╚═╝   ╚═╝   ╚═╝  ╚═╝ ╚═════╝ ╚══════╝╚══════╝</text>
+</svg>