fix(a11y): improve screen reader support and keyboard navigation in docs

[berry-13]

Summary

Fixes 6 reported accessibility issues and 6 additional issues found via a WCAG 2.1 audit. All fixes are applied via a pnpm patch on fumadocs-ui@14.7.7 plus one project-level fix.

Closes #513
Closes #514
Closes #515
Closes #516
Closes #517
Closes #518

Reported Issues

Issue	Problem	Fix
#513	Navigation toggle button (⋯) has no accessible name	Added aria-label="LibreChat website navigation"
#514	Search button doesn't warn screen readers it opens a modal	Added aria-haspopup="dialog" and aria-label to both search toggles
#515	Close search button visible text "Esc" doesn't match aria-label="Close Search" (WCAG 2.5.3)	Changed to aria-label="Close Search (Esc)"
#516	Search suggestions/results not announced by screen readers	Added role="status" live region announcing result count and navigation instructions
#517	Search suggestions are <button> but navigate to a new URL — semantically they're links	Changed to <a> with href, role="option", and role="listbox" on container
#518	Docs pages missing landmark regions	Added <nav> landmarks for sidebar, breadcrumbs, TOC, and pagination

Additional Fixes (WCAG Audit)

Problem	WCAG	Fix
Theme toggle button has no accessible name	4.1.2 (A)	Added aria-label="Toggle theme"
Sidebar <aside> has no accessible name	4.1.2 (A)	Added aria-label="Docs sidebar"
"Collapse Sidebar" label doesn't update when collapsed	4.1.2 (A)	Dynamic label: "Expand Sidebar" / "Collapse Sidebar"
Heading anchor link icon only visible on hover, not keyboard focus	2.4.7 (AA)	Added peer-focus-visible:opacity-100 and focus ring
Breadcrumbs use <div> instead of <ol>/<li>, separator SVGs exposed to AT	1.3.1 (A)	Changed to <ol>/<li>, added aria-hidden="true" on chevron separators
Feedback <textarea> has no programmatic label	4.1.2 (A)	Added aria-label="Additional feedback"

Implementation

All fumadocs-ui fixes are in patches/fumadocs-ui@14.7.7.patch, applied automatically on pnpm install. The feedback textarea fix is a one-line change in components/Feedback.tsx.

Testing

• Build passes ✅
• All 12 fixes verified in the browser against the live dev server
• Accessibility tree inspected on /docs and /docs/configuration/librechat_yaml/object_structure/anthropic_vertex

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Actions	Updated (UTC)
librechat-ai	Ready	Preview, Comment	Mar 21, 2026 2:30pm

[github-actions]

📦 Next.js Bundle Analysis for librechat.ai

This analysis was generated by the Next.js Bundle Analysis action. 🤖

This PR introduced no changes to the JavaScript bundle! 🙌

[berry-13]

@amberhinds Thank you for the detailed accessibility reports, they were very helpful.

I've addressed all 6 issues in this PR, plus a few additional a11y improvements. Would you mind verifying the fixes work as expected with your setup?

[Copilot]

Pull request overview

This PR applies a pnpm patch to fumadocs-ui@14.7.7 plus a small project-level change to address a set of WCAG 2.1 A/AA accessibility issues in the docs UI (search dialog, navigation landmarks, headings, breadcrumbs/pagination, sidebar controls, and feedback form).

Changes:

• Adds/adjusts ARIA attributes and landmark semantics across the docs UI via a fumadocs-ui patch.
• Improves docs search accessibility (modal semantics, live-region announcements, and suggestion item semantics).
• Adds an accessible name to the feedback <textarea> at the project level.

Reviewed changes

Copilot reviewed 3 out of 4 changed files in this pull request and generated 2 comments.

File	Description
pnpm-lock.yaml	Registers the patched fumadocs-ui@14.7.7 dependency and updates the resolved version with a patch_hash.
patches/fumadocs-ui@14.7.7.patch	Implements the bulk of accessibility fixes in patched fumadocs-ui dist files (search, headings, toggles, sidebar, TOC, breadcrumbs, pagination).
package.json	Declares pnpm.patchedDependencies entry for fumadocs-ui@14.7.7.
components/Feedback.tsx	Adds aria-label="Additional feedback" to the feedback textarea.

Files not reviewed (1)

• pnpm-lock.yaml: Language not supported

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

[github-actions]

📦 Next.js Bundle Analysis for librechat.ai

This analysis was generated by the Next.js Bundle Analysis action. 🤖

This PR introduced no changes to the JavaScript bundle! 🙌