How samsingh77/accessibility-auditor works
This is a browser-based document accessibility auditor: users upload documents, the app parses them into a shared structure, evaluates WCAG criteria with deterministic and AI-assisted checks, and presents findings for review, repair, and reporting. The tree indicates support for PDF, PowerPoint, Word, spreadsheets, and images; sampled parser details are available only for PDF and PowerPoint, so their internal extraction links are shown without extrapolating parser behavior. Other major views and document-format support are retained based on the source tree.
Main entry points: App.tsx App state and routing · accessibilityEngine.ts WCAG assessment · parsers Format parsers · DocumentUploader.tsx Document upload
Components 25
Auditing workspace
- App state and routing
src/App.tsx - Document upload
src/components/DocumentUploader.tsx - Dashboard
src/components/DashboardView.tsx - Visual inspection
src/components/LiveVisualView.tsx - Findings list
src/components/IssuesListView.tsx - Reports view
src/components/ReportsView.tsx - Audit settings
src/components/SettingsView.tsx - Manual review
src/components/ManualReviewCenter.tsx
Document ingestion
- Format parsers
src/services/parsers - PDF parser
src/services/parsers/PDFParser.ts - PowerPoint parser
src/services/parsers/PPTXParser.ts - Other format parsers
src/services/parsers
Accessibility analysis
- Document model
src/types/accessibility.ts - WCAG assessment
src/services/accessibilityEngine.ts - WCAG rules
src/services/wcagRulesDatabase.ts - Contrast checks
src/services/contrastEngine.ts - AI provider selection
src/services/ai/aiProviderFactory.ts - AI provider interface
src/services/ai/AIProvider.ts - Gemini analysis
src/services/ai/GeminiAIProvider.ts - PDF conversion
src/services/pdfConverter.ts
Review and outputs
- Fix and rescan
src/services/remediationEngine.ts - Annotated PDF
src/services/annotatedPdfGenerator.ts - PDF report
src/services/pdfReportGenerator.ts
Other components
- Auditor
- Google GenAI
Connections 34
- Auditor → App state and routing: uses
- App state and routing → Document upload: shows
- App state and routing → Dashboard: shows
- App state and routing → Visual inspection: shows
- App state and routing → Findings list: shows
- App state and routing → Reports view: shows
- App state and routing → Audit settings: shows
- App state and routing → Manual review: shows
- Document upload → Format parsers: parses file
- Format parsers → PDF parser
- Format parsers → PowerPoint parser
- Format parsers → Other format parsers
- PDF parser → Document model: builds
- PowerPoint parser → Document model: builds
- Other format parsers → Document model: builds
- Document upload → App state and routing: returns structure
- App state and routing → WCAG assessment: evaluates structure
- WCAG assessment → WCAG rules: loads criteria
- WCAG assessment → Contrast checks: checks contrast
- WCAG assessment → AI provider selection: requests AI checks
- AI provider selection → AI provider interface: creates provider
- AI provider interface → Gemini analysis: implemented by
- Gemini analysis → Google GenAI: requests generation
- WCAG assessment → PDF conversion: creates PDF preview
- WCAG assessment → App state and routing: returns assessment
- App state and routing → Visual inspection: passes assessment
- App state and routing → Findings list: passes assessment
- App state and routing → Manual review: passes assessment
- Manual review → App state and routing: submits decisions
- App state and routing → Fix and rescan: applies fixes
- Fix and rescan → WCAG assessment: rescans document
- App state and routing → Annotated PDF: exports annotations
- App state and routing → PDF report: generates report
- App state and routing → Reports view: passes assessment