From 6c36a493c759cec8f84ee2d73c0963ecd3eaf35b Mon Sep 17 00:00:00 2001
From: Inaki Fernandez <inafev@gmail.com>
Date: Thu, 25 Jun 2026 18:25:11 +0200
Subject: [PATCH] feat(v2): add Awesome Lists hero card on index + Portal Guide
 nav entry
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

- New "Awesome Lists" hero-badge card on the V2 index, right after "Get
  Started", linking to /other-awesome-lists/.
- Custom gold-star + list-motif cover (docs/images/awesome-lists-cover.svg),
  matching the Awesome Lists page hero theme.
- New .hero-badge-card--gold modifier.
- Also list "Awesome Lists" under the Portal Guide top-bar menu (after Topic
  Map) for discoverability, in addition to the flagship "⭐ Awesome Lists" tab.
- Card added to the index template (survives regeneration) and to the current
  rendered v2-docs/index.md for immediate deploy.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
---
 docs/images/awesome-lists-cover.svg | 42 +++++++++++++++++++++++++++++
 docs/static/v2_elite.css            | 11 ++++++++
 src/v2_optimizer.py                 |  7 +++++
 v2-docs/index.md                    |  7 +++++
 v2-mkdocs.yml                       |  1 +
 5 files changed, 68 insertions(+)
 create mode 100644 docs/images/awesome-lists-cover.svg

diff --git a/docs/images/awesome-lists-cover.svg b/docs/images/awesome-lists-cover.svg
new file mode 100644
index 00000000..33c47ba2
--- /dev/null
+++ b/docs/images/awesome-lists-cover.svg
@@ -0,0 +1,42 @@
+<svg width="200" height="200" viewBox="0 0 200 200" fill="none" xmlns="http://www.w3.org/2000/svg" role="img" aria-label="Awesome Lists">
+  <defs>
+    <linearGradient id="albg" x1="0" y1="0" x2="200" y2="200" gradientUnits="userSpaceOnUse">
+      <stop offset="0" stop-color="#7c3aed"/>
+      <stop offset="0.55" stop-color="#5b21b6"/>
+      <stop offset="1" stop-color="#1e1b4b"/>
+    </linearGradient>
+    <linearGradient id="algold" x1="60" y1="36" x2="140" y2="120" gradientUnits="userSpaceOnUse">
+      <stop offset="0" stop-color="#fde68a"/>
+      <stop offset="0.5" stop-color="#fbbf24"/>
+      <stop offset="1" stop-color="#f59e0b"/>
+    </linearGradient>
+    <filter id="alglow" x="-40%" y="-40%" width="180%" height="180%">
+      <feGaussianBlur stdDeviation="4" result="b"/>
+      <feMerge><feMergeNode in="b"/><feMergeNode in="SourceGraphic"/></feMerge>
+    </filter>
+  </defs>
+
+  <!-- Backdrop -->
+  <rect x="6" y="6" width="188" height="188" rx="34" fill="url(#albg)"/>
+  <rect x="6.5" y="6.5" width="187" height="187" rx="33.5" fill="none" stroke="#a78bfa" stroke-opacity="0.45" stroke-width="1.5"/>
+
+  <!-- Curated list rows with star bullets -->
+  <g transform="translate(40,104)">
+    <path d="M4 4 l4.7 2.6 -0.9 -5.3 3.8 -3.7 -5.3 -0.8 -2.1 -4.8 -2.1 4.8 -5.3 0.8 3.8 3.7 -0.9 5.3z" fill="#fcd34d"/>
+    <rect x="22" y="-1" width="92" height="9" rx="4.5" fill="#ede9fe" fill-opacity="0.92"/>
+  </g>
+  <g transform="translate(40,130)">
+    <path d="M4 4 l4.7 2.6 -0.9 -5.3 3.8 -3.7 -5.3 -0.8 -2.1 -4.8 -2.1 4.8 -5.3 0.8 3.8 3.7 -0.9 5.3z" fill="#fcd34d"/>
+    <rect x="22" y="-1" width="78" height="9" rx="4.5" fill="#ddd6fe" fill-opacity="0.82"/>
+  </g>
+  <g transform="translate(40,156)">
+    <path d="M4 4 l4.7 2.6 -0.9 -5.3 3.8 -3.7 -5.3 -0.8 -2.1 -4.8 -2.1 4.8 -5.3 0.8 3.8 3.7 -0.9 5.3z" fill="#fcd34d"/>
+    <rect x="22" y="-1" width="64" height="9" rx="4.5" fill="#c4b5fd" fill-opacity="0.7"/>
+  </g>
+
+  <!-- Hero star -->
+  <g filter="url(#alglow)" transform="translate(100,64)">
+    <path d="M0 -42 L12.3 -13 L43 -11 L19.5 9 L26.5 39 L0 22.5 L-26.5 39 L-19.5 9 L-43 -11 L-12.3 -13 Z"
+          fill="url(#algold)" stroke="#fffbeb" stroke-width="2" stroke-linejoin="round"/>
+  </g>
+</svg>
diff --git a/docs/static/v2_elite.css b/docs/static/v2_elite.css
index 956d71a4..83713b83 100644
--- a/docs/static/v2_elite.css
+++ b/docs/static/v2_elite.css
@@ -426,6 +426,17 @@ a {
   border-color: #f59e0b !important;
 }
 
+/* Gold: the flagship Awesome Lists card (matches the ⭐ Awesome Lists hero). */
+.hero-badge-card--gold {
+  border-color: rgba(251, 191, 36, 0.25);
+  background: rgba(251, 191, 36, 0.025);
+}
+.hero-badge-card--gold:hover {
+  background: rgba(251, 191, 36, 0.07) !important;
+  box-shadow: 0 8px 24px rgba(251, 191, 36, 0.22);
+  border-color: #fbbf24 !important;
+}
+
 .hero-badge-icon {
   /* Match the 100px logo <img> box on the other hero cards so the
      emoji-based Intelligence Digest card is the same height. */
diff --git a/src/v2_optimizer.py b/src/v2_optimizer.py
index 9eca0c8b..10df38e2 100644
--- a/src/v2_optimizer.py
+++ b/src/v2_optimizer.py
@@ -1362,6 +1362,13 @@ class V2VisionEngine:
             "      <div class=\"hero-badge-subtitle\">Introduction Guide</div>\n"
             "    </div>\n"
             "  </a>\n"
+            "  <a href=\"./other-awesome-lists/\" style=\"text-decoration: none; color: inherit; display: block;\">\n"
+            "    <div class=\"hero-badge-card hero-badge-card--gold\">\n"
+            "      <img src=\"/images/awesome-lists-cover.svg\" alt=\"Awesome Lists\"/>\n"
+            "      <div class=\"hero-badge-title\">Awesome Lists</div>\n"
+            "      <div class=\"hero-badge-subtitle\">Curated awesome-* directory</div>\n"
+            "    </div>\n"
+            "  </a>\n"
             "</div>\n\n"
             "!!! abstract \"The High-Density Vision\"\n"
             "    The V2 Edition is a curated, high-density version of the Nubenetes archive. Using **Agentic AI Orchestration**, "
diff --git a/v2-docs/index.md b/v2-docs/index.md
index 19556b7f..63b752c3 100644
--- a/v2-docs/index.md
+++ b/v2-docs/index.md
@@ -69,6 +69,13 @@
       <div class="hero-badge-subtitle">Introduction Guide</div>
     </div>
   </a>
+  <a href="./other-awesome-lists/" style="text-decoration: none; color: inherit; display: block;">
+    <div class="hero-badge-card hero-badge-card--gold">
+      <img src="/images/awesome-lists-cover.svg" alt="Awesome Lists"/>
+      <div class="hero-badge-title">Awesome Lists</div>
+      <div class="hero-badge-subtitle">Curated awesome-* directory</div>
+    </div>
+  </a>
 </div>
 
 !!! abstract "The High-Density Vision"
diff --git a/v2-mkdocs.yml b/v2-mkdocs.yml
index dddba8aa..893d1c5a 100644
--- a/v2-mkdocs.yml
+++ b/v2-mkdocs.yml
@@ -165,6 +165,7 @@ nav:
   - "⭐ Awesome Lists": other-awesome-lists.md
   - "Portal Guide":
     - "Topic Map": topic-map.md
+    - "Awesome Lists": other-awesome-lists.md
     - "Methodology": methodology.md
     - "Technical Tags": tags.md
     - "About": about.md