A tool to help sighted developers understand how screen reader users experience web pages.
- Screen Reader Simulation - Uses GuidePup Virtual Screen Reader to simulate what screen readers announce
- WCAG Violation Detection - Integrates axe-core for comprehensive accessibility testing
- AI Enhancement - Optional Gemini AI integration for contextual fix suggestions
- Streaming Output - Results appear in real-time as the page is analyzed
# No install needed - just serve the files
npx serve .
# Open http://localhost:3000- Load Content - Select a sample page or paste HTML
- View Announcements - See what screen readers would say for each element
- Review Issues - Axe-core finds WCAG violations with severity levels
- Get AI Suggestions - Optionally connect Gemini for smart fix recommendations
| File | Purpose |
|---|---|
index.html |
Main UI with tabs and samples |
styles.css |
Dark theme styling |
app.js |
Application logic and UI coordination |
sr-visualizer.js |
Virtual Screen Reader integration |
axe-analyzer.js |
Axe-core WCAG testing |
issue-detector.js |
Custom accessibility issue detection |
ai-analyzer.js |
Gemini AI integration |
To enable AI-powered suggestions:
- Get a free API key at aistudio.google.com/apikey
- Click "🤖 AI Enhance" in the issues panel
- Enter your API key
The AI analyzes screenshots and suggests contextual fixes like:
- Appropriate alt text for images
- Meaningful labels for icon buttons
- Semantic HTML improvements
- Virtual Screen Reader - Client-side screen reader simulation (no real SR needed)
- Axe-core - Industry-standard WCAG testing engine
- Gemini Vision API - Multimodal AI for visual context analysis
- html2canvas - Screenshot capture for AI analysis
The app uses ES modules loaded from CDNs - no build step required:
// Virtual Screen Reader from unpkg
import('https://unpkg.com/@guidepup/virtual-screen-reader/lib/esm/index.browser.js')
// Axe-core from jsDelivr
import('https://cdn.jsdelivr.net/npm/axe-core@4.8.4/+esm')
// html2canvas for screenshots
import('https://cdn.jsdelivr.net/npm/html2canvas@1.4.1/+esm')MIT
