From 859377634c2496f72d79a64995dbd24bf78b69a8 Mon Sep 17 00:00:00 2001
From: Wilfried Ladenhauf <wilfried@labordatenbank.at>
Date: Wed, 28 Jan 2026 05:01:53 +0100
Subject: [PATCH 1/3] a11y: resolve testimonial keyboard trap and implement
 skip logic

- Added `.sr-only` utility for screen-reader-only context
- Implemented `inert` on `.testimonials-track` to prevent redundant keyboard tabbing
- Enhanced "View all" link with descriptive hidden text for better navigation context
- Added `focus-visible` styles to provide clear visual indicators for keyboard users
- Added `prefers-reduced-motion` media query to respect system-level motion preferences
---
 src/pages/index.astro | 44 ++++++++++++++++++++++++++++++++++++++++---
 1 file changed, 41 insertions(+), 3 deletions(-)

diff --git a/src/pages/index.astro b/src/pages/index.astro
index 37a9bcb..c2e9725 100644
--- a/src/pages/index.astro
+++ b/src/pages/index.astro
@@ -96,12 +96,14 @@ const duration2 = (row2.length / 2 * pixelsPerItem) / pixelsPerSecond;
         <h2 class="section-title">
           <span class="claw-accent">⟩</span> What People Say
         </h2>
-        <a href="/shoutouts" class="section-link">View all →</a>
+        <a href="/shoutouts" class="section-link">View all <span class="sr-only">community shoutouts</span>
+          <span aria-hidden="true">→</span>
+        </a>
       </div>
-      <div class="testimonials-track">
+      <div class="testimonials-track" inert>
         <div class="testimonials-row row-1" style={`--duration: ${duration1}s`}>
           {row1.map((t) => (
-            <a href={t.url} target="_blank" rel="noopener" class="testimonial-card">
+            <a href={t.url} target="_blank" rel="noopener" class="testimonial-card" tabindex="-1">
               <img
                 src={`https://unavatar.io/x/${t.author}`}
                 alt={t.author}
@@ -1765,6 +1767,10 @@ const duration2 = (row2.length / 2 * pixelsPerItem) / pixelsPerSecond;
     );
   }
 
+  .testimonials-track:focus-within .testimonials-row {
+    animation-play-state: paused;
+  }
+
   .testimonials-row {
     display: flex;
     gap: 16px;
@@ -1958,4 +1964,36 @@ const duration2 = (row2.length / 2 * pixelsPerItem) / pixelsPerSecond;
       font-size: 0.9rem;
     }
   }
+
+  /* Accessibility Utilities */
+
+  /* Hides content visually but keeps it available for screen readers */
+  .sr-only {
+    position: absolute;
+    width: 1px;
+    height: 1px;
+    padding: 0;
+    margin: -1px;
+    overflow: hidden;
+    clip: rect(0, 0, 0, 0);
+    white-space: nowrap;
+    border-width: 0;
+  }
+
+  /* Global Focus State: Replaces the default browser ring with your theme colors */
+  :focus-visible {
+    outline: 3px solid var(--cyan-bright);
+    outline-offset: 4px;
+    border-radius: 4px;
+  }
+
+  /* Respect user's system settings for reduced motion */
+  @media (prefers-reduced-motion: reduce) {
+    *, ::before, ::after {
+      animation-duration: 0.01ms !important;
+      animation-iteration-count: 1 !important;
+      transition-duration: 0.01ms !important;
+      scroll-behavior: auto !important;
+    }
+  }
 </style>

From dfe423227066b7ac5fafbbf6a7214ebde203f95c Mon Sep 17 00:00:00 2001
From: Shadow <hi@shadowing.dev>
Date: Tue, 27 Jan 2026 22:16:11 -0600
Subject: [PATCH 2/3] fix: keep testimonials clickable

---
 src/pages/index.astro | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/pages/index.astro b/src/pages/index.astro
index c2e9725..dc8c353 100644
--- a/src/pages/index.astro
+++ b/src/pages/index.astro
@@ -100,7 +100,7 @@ const duration2 = (row2.length / 2 * pixelsPerItem) / pixelsPerSecond;
           <span aria-hidden="true">→</span>
         </a>
       </div>
-      <div class="testimonials-track" inert>
+      <div class="testimonials-track">
         <div class="testimonials-row row-1" style={`--duration: ${duration1}s`}>
           {row1.map((t) => (
             <a href={t.url} target="_blank" rel="noopener" class="testimonial-card" tabindex="-1">

From 11d2d8ffad48092a9f030442806299cffde276a9 Mon Sep 17 00:00:00 2001
From: Shadow <hi@shadowing.dev>
Date: Tue, 27 Jan 2026 22:17:24 -0600
Subject: [PATCH 3/3] fix: keep testimonials clickable (#18) (thanks
 @wilfriedladenhauf)

---
 CHANGELOG.md | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index 5c3c833..17a1fea 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -1,5 +1,9 @@
 # Changelog
 
+## 2026-01-27
+
+- Home page: keep testimonial links clickable while skipping keyboard focus (#18, thanks @wilfriedladenhauf).
+
 ## 2026-01-16
 
 - `install.sh`: warn when the user’s original shell `PATH` likely won’t find the installed `clawdbot` binary (common Node/npm global bin issues); link to docs.