-
-
Notifications
You must be signed in to change notification settings - Fork 1.5k
Description
Accessibility Scan Results for trpc.io
Score: 0/100 (Grade F) — 73 issues found
I ran an automated WCAG accessibility scan on trpc.io and found significant accessibility barriers, primarily around link accessibility and color contrast.
Issues Found
1. 42 links without accessible text (Critical — WCAG 2.4.4 Level A)
This is the most impactful finding. 42 links on the homepage have no discernible text for screen reader users. These are likely icon-only links, image links without alt text, or empty anchor elements.
Screen reader users hear "link" with no indication of where it goes — making the site effectively unnavigable.
Fix: Add accessible text to each link. The approach depends on the link content:
<!-- Icon-only link — add aria-label -->
<a href="/docs" aria-label="Documentation"><svg>...</svg></a>
<!-- Image link — add alt to the image -->
<a href="/"><img src="logo.png" alt="tRPC homepage"></a>
<!-- Link wrapping other content — add aria-label -->
<a href="/example" aria-label="View example project">
<div class="card">...</div>
</a>A quick way to find them: search for <a elements where the computed accessible name is empty. Browser DevTools > Accessibility tab can help identify these.
2. 31 elements with potential low-contrast inline styles (Moderate — WCAG 1.4.3 Level AA)
Text elements may not meet the minimum 4.5:1 contrast ratio for normal text (or 3:1 for large text). This affects users with low vision or color deficiencies.
Fix: Check contrast ratios using Chrome DevTools (inspect element > color picker shows contrast ratio) or use a tool like the WebAIM Contrast Checker. Ensure:
- Normal text: ≥ 4.5:1 ratio
- Large text (18px+ bold or 24px+): ≥ 3:1 ratio
Why This Matters
42 inaccessible links is a substantial barrier. Screen reader users cannot navigate the site meaningfully. Since many of these are likely using the same pattern (e.g., card links or icon links), a single component fix could resolve many of them at once.
Scanned with AccessScore — free WCAG/ADA accessibility checker. Full report available at https://accessscore.autonomous-claude.com/?url=https://trpc.io