ACCESSIBILITY_REPORT.md

Accessibility Report

Project: StayWell

Short Accessibility Checklist

• Keyboard-only navigation works across primary routes
• Skip link is present and focusable
• Focus indicators are visible
• Form controls have labels and validation messaging
• Landmark regions and heading hierarchy are present
• Color contrast checks pass in automated audits

Tools Used

• Lighthouse (CLI): automated accessibility scoring
• axe (@axe-core/cli): WCAG 2 A/AA rule violations across routes
• WAVE: included in process checklist; local CLI automation was not available in this environment for localhost

Issues Found

Baseline (Before)

• axe reported aria-prohibited-attr on / (3 occurrences)
• Lighthouse accessibility score on /: 97
• Lighthouse accessibility score on /property/grandview-plaza: 100

Current (After)

• axe reported 0 violations across 8 routes
• Lighthouse accessibility score on /: 100
• Lighthouse accessibility score on /property/grandview-plaza: 100

What Was Fixed

• Added role="img" to star-rating groups using aria-label so labels are valid for AT:
  • src/pages/Index.tsx
  • src/components/PropertyCard.tsx
  • src/pages/PropertyDetail.tsx
• Removed animation blur/opacity transitions that could create transient contrast failures during automated checks:
  • src/index.css

Audit Artifacts

• axe before: docs/accessibility/reports/axe-before.txt
• axe after: docs/accessibility/reports/axe-after.txt
• Lighthouse before home: docs/accessibility/reports/lighthouse-before-home.report.html
• Lighthouse after home: docs/accessibility/reports/lighthouse-after-home.report.html
• Lighthouse before property: docs/accessibility/reports/lighthouse-before-property.report.html
• Lighthouse after property: docs/accessibility/reports/lighthouse-after-property.report.html

Notes

• Automated tooling does not cover all accessibility issues; manual assistive-technology testing remains required.