a11y-fixes

Solid

Resolve axe-core accessibility violations reported by Vitest (test/a11y.ts), Playwright (.playwright/a11y.ts), or the code-review-audit agent's a11y bucket. Use when fixing violations like color-contrast, label, label-title-only, image-alt, button-name, link-name, region, landmark-one-main, heading-order, aria-allowed-attr, aria-required-attr, aria-required-children, aria-required-parent, aria-valid-attr-value, focus-trap, tabindex, html-has-lang, document-title, duplicate-id, listitem, definition-list. Trigger on any axe rule id appearing in test output.

Web & Frontend 10 stars 1 forks Updated today MIT

Install

View on GitHub

Quality Score: 82/100

Stars 20%
35
Recency 20%
100
Frontmatter 20%
70
Documentation 15%
100
Issue Health 10%
80
License 10%
100
Description 5%
100

Skill Content

# Accessibility Fix Patterns How to resolve specific axe-core violations in this project. Violations come from `test/a11y.ts` (Vitest), `.playwright/a11y.ts` (Playwright), or the `code-review-audit` agent's a11y bucket. General a11y guidance lives in `.claude/rules/accessibility.md`. ## color-contrast WCAG AA requires 4.5:1 for normal text, 3:1 for large text. Use the project's semantic Tailwind tokens (see `.claude/rules/tailwind.md`) instead of arbitrary palette colors — they pair light/dark modes correctly. ```tsx // BAD — fails contrast in dark mode, raw colors <p className="text-gray-400 bg-white">Status</p> // GOOD — semantic tokens, contrast-safe in both modes <p className="text-body bg-body">Status</p> ``` ## label Form inputs need an associated `<label>`. Use GAIA's `Field` wrapper from `~/components/Form/Field` rather than a bare `<label>` — it wires `htmlFor`, error text, and description automatically. See the `form-components.md` audit extension. ```tsx // BAD — bare input with no label association <input type="text" name="email" /> // GOOD — Field wraps a project input with the right wiring <Field type="input" name="email" label={t('email')}> <InputText name="email" /> </Field> ``` ## label-title-only `title` attributes are not labels — screen readers and mobile devices ignore them. Use `aria-label` or a real `<label>`. ```tsx // BAD — title is not an accessible name <input type="text" title="Search" /> // GOOD — aria-label provides the accessible...

Details

Author
gaia-react
Repository
gaia-react/gaia
Created
1 years ago
Last Updated
today
Language
JavaScript
License
MIT

Integrates with

Related Skills

Web & Frontend Featured

code-to-prd

Reverse-engineer any codebase into a complete Product Requirements Document (PRD). Analyzes routes, components, state management, API integrations, and user interactions to produce business-readable documentation detailed enough for engineers or AI agents to fully reconstruct every page and endpoint. Works with frontend frameworks (React, Vue, Angular, Svelte, Next.js, Nuxt), backend frameworks (NestJS, Django, Express, FastAPI), and fullstack applications. Trigger when users mention: generate PRD, reverse-engineer requirements, code to documentation, extract product specs from code, document page logic, analyze page fields and interactions, create a functional inventory, write requirements from an existing codebase, document API endpoints, or analyze backend routes.

16,173 Updated today
alirezarezvani
Web & Frontend Featured

lifecyclemigrate-from-nextjs

Step-by-step migration from Next.js App Router to TanStack Start: route definition conversion, API mapping, server function conversion from Server Actions, middleware conversion, data fetching pattern changes.

14,498 Updated today
TanStack
Web & Frontend Featured

ckmbanner-design

Design banners for social media, ads, website heroes, creative assets, and print. Multiple art direction options with AI-generated visuals. Actions: design, create, generate banner. Platforms: Facebook, Twitter/X, LinkedIn, YouTube, Instagram, Google Display, website hero, print. Styles: minimalist, gradient, bold typography, photo-based, illustrated, geometric, retro, glassmorphism, 3D, neon, duotone, editorial, collage. Uses ui-ux-pro-max, frontend-design, ai-artist, ai-multimodal skills.

62,072 Updated 1 months ago
nextlevelbuilder