Skip to content

Accessibility: 42 links without accessible text on trpc.io (WCAG scan) #7264

@ryuno2525

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

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions