From 9efc123619d44a6339a9dcaef148480bdf1f5e28 Mon Sep 17 00:00:00 2001
From: Will Lehnertz <6597817+packetThrower@users.noreply.github.com>
Date: Fri, 29 May 2026 10:11:07 -0700
Subject: [PATCH] =?UTF-8?q?docs(nav):=20add=20"=E2=86=90=20packetThrower"?=
 =?UTF-8?q?=20back-link=20pill=20to=20the=20docs=20header?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Etch341's docs site puts a back-pill to the parent landing page on
the right side of the header — useful affordance for visitors who
landed deep on the Baudrun docs from a search result and want to
discover the rest of packetThrower. Adds the same pill to our
SocialIcons override, sitting to the left of the existing "Docs"
quick-access pill.

Implementation notes:

  * Renamed the shared style class `.bd-docs-link` → `.bd-nav-pill`
    since both pills now share the same look (and any future pill
    here would too). Single class for the visual style means the
    Docs / packetThrower / hypothetical-third pill stay visually
    consistent without manually keeping three rules in sync.
  * Back-link uses an absolute `https://packetthrower.github.io/`
    URL on purpose. Astro's configured `base` is `/Baudrun/`, so a
    relative `/` would resolve to this site's own root rather than
    the parent. Comment in the file explains.
  * Arrow is wrapped in `<span aria-hidden="true">` so screen
    readers don't try to pronounce a left-arrow character — they
    read the pill as "packetThrower" alone.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
---
 docs-next/src/components/SocialIcons.astro | 28 +++++++++++++++-------
 1 file changed, 20 insertions(+), 8 deletions(-)

diff --git a/docs-next/src/components/SocialIcons.astro b/docs-next/src/components/SocialIcons.astro
index 262c528..5aad24f 100644
--- a/docs-next/src/components/SocialIcons.astro
+++ b/docs-next/src/components/SocialIcons.astro
@@ -1,20 +1,32 @@
 ---
-// Override of Starlight's SocialIcons component. Renders a "Docs"
-// quick-access pill on the left, then defers to Starlight's default
-// rendering (the GitHub icon, etc.) for the rest. Wraps rather than
-// re-implements so future Starlight versions that change the social-
-// icon pipeline still work — we only own the `.bd-docs-link` extra.
+// Override of Starlight's SocialIcons component. Renders two
+// quick-access pills on the left — a "← packetThrower" back-link
+// to the parent landing page, then a "Docs" pill to /install/ —
+// then defers to Starlight's default rendering (the GitHub icon,
+// etc.) for the rest. Wraps rather than re-implements so future
+// Starlight versions that change the social-icon pipeline still
+// work — we only own the `.bd-nav-pill` extras.
+//
+// The back-link is an absolute URL on purpose: Astro's configured
+// `base` is `/Baudrun/`, so a relative `/` would resolve to
+// `/Baudrun/` (this site's own root). The absolute form skips the
+// base prefix and reaches the actual parent at
+// https://packetthrower.github.io/.
 import Default from '@astrojs/starlight/components/SocialIcons.astro';
 ---
 
-<a class="bd-docs-link sl-flex" href="/Baudrun/install/">
+<a class="bd-nav-pill sl-flex" href="https://packetthrower.github.io/">
+	<span aria-hidden="true">←</span> packetThrower
+</a>
+
+<a class="bd-nav-pill sl-flex" href="/Baudrun/install/">
 	Docs
 </a>
 
 <Default {...Astro.props}><slot /></Default>
 
 <style>
-	.bd-docs-link {
+	.bd-nav-pill {
 		align-items: center;
 		gap: 0.4em;
 		padding: 0.35em 0.85em;
@@ -28,7 +40,7 @@ import Default from '@astrojs/starlight/components/SocialIcons.astro';
 			color 140ms ease,
 			box-shadow 140ms ease;
 	}
-	.bd-docs-link:hover {
+	.bd-nav-pill:hover {
 		color: var(--sl-color-text-accent);
 		box-shadow: inset 0 0 0 1px var(--sl-color-text-accent);
 	}