Skip to content

Conversation

@wilfriedladenhauf
Copy link

πŸ› οΈ Accessibility Improvements: Resolving the "Keyboard Toll"

πŸ“‹ Overview
This PR addresses a significant accessibility (a11y) issue in the Testimonials section. Previously, keyboard and screen-reader users were forced to tab through 50+ individual testimonial links before reaching the "Quick Start" section.

πŸš€ Key Changes

  1. Implemented inert on Testimonial Track
    Added the inert attribute to the .testimonials-track.

Benefit: This completely removes the scrolling marquee from the focus order. Keyboard users now skip the "toll" and move directly to installation instructions.

  1. Enhanced "View all" Context
    Updated the /shoutouts link to include a visually hidden descriptive label.

  2. Added A11y Utility Classes
    Introduced a standard .sr-only class to the stylesheet.

  3. System-Level Motion Support
    Added a prefers-reduced-motion media query.

Benefit: Respects users with vestibular/motion sensitivities by instantly disabling starfield, nebula, and marquee animations based on their OS settings.

  1. Improved Focus States
    Implemented custom :focus-visible logic using the project's --cyan-bright variable.

more contrast / higher visibiliy on focus style:

image
  • 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

@vercel
Copy link

vercel bot commented Jan 28, 2026

Someone is attempting to deploy a commit to the Amantus Machina Team on Vercel.

A member of the Team first needs to authorize it.

@thewilloftheshadow
Copy link
Member

Thank you!

@thewilloftheshadow thewilloftheshadow self-assigned this Jan 28, 2026
Wilfried Ladenhauf and others added 3 commits January 27, 2026 22:16
- 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
@thewilloftheshadow thewilloftheshadow force-pushed the a11y/fix-testimonial-keyboard-trap-a11y-utility-classes branch from 0f91095 to 11d2d8f Compare January 28, 2026 04:18
@thewilloftheshadow thewilloftheshadow merged commit ccf4a08 into moltbot:main Jan 28, 2026
3 checks passed
@thewilloftheshadow
Copy link
Member

Landed via temp rebase onto main.

  • Related tests: not run (no test suite in this repo)
  • Land commit: 11d2d8f
  • Merge commit: ccf4a08

Thanks @wilfriedladenhauf!

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants