Clone or download the repo
Put it in the same workspace or project context your AI tool can access — a local folder, a Claude project, or a RAG pipeline.
AI-Ready Knowledge Base
Accessibility knowledge,
structured for AI.
neura11y is a structured accessibility knowledge base built for AI context loading and RAG pipelines. 88 markdown files covering WCAG 2.2, WAI-ARIA, seven social platforms, document formats, legal compliance, component patterns, and more — all with YAML frontmatter for clean ingestion.
88
markdown files
87
WCAG 2.2 SCs covered
7
social platforms
8
component patterns
01
Process
Four steps to get started
The repo does the heavy lifting once you hand the right files to the model. Keep bundles focused — don't attach everything at once.
Attach the routing files first
Start every session with AI-USAGE-GUIDE.md and INDEX.md. These tell the AI what's in the repo and how to use it.
Add a focused task bundle
Pick files for your specific task from the bundles below. A tight context window beats a large one full of noise.
Review the AI output
Treat results as assisted draft work. Verify thresholds, SC numbers, and any platform-specific claims against official sources.
02
Use cases
What you can do with it
Load the relevant files for your task and let the model do the work — grounded in real standards, not general knowledge.
Build or audit a page
Generate accessible components, review HTML for WCAG 2.2 issues, and get ARIA patterns for modals, tabs, carousels, comboboxes, and more.
Create accessible documents
Get step-by-step guidance for Word, PowerPoint, Excel, and PDF. Covers heading structure, alt text, reading order, and plain language.
Write accessible social posts
Generate alt text, captions, and accessible copy for Twitter/X, Instagram, LinkedIn, YouTube, TikTok, Facebook, and Mastodon.
Navigate legal requirements
Understand WCAG conformance levels, Section 508, and regional law — US ADA, EU EAA, UK PSBAR, Canada ACA, and Australia DDA.
03
Coverage
What is in the repository
The repo spans standards, applied guidance, prompt templates, and supporting reference material across every major accessibility domain.
WCAG Standards
All 87 WCAG 2.2 SCs with levels, techniques, and common failures. WCAG 2.1, 3.0 overview, and conformance levels.
WAI-ARIA
Complete roles, states, and properties reference. APG keyboard patterns for 15+ components. Common ARIA mistakes guide.
Web Domain
HTML semantics, focus management, forms, images, SPA patterns, color/contrast, keyboard navigation, and 8 component patterns.
Social Media
Platform guides for all 7 major platforms. Alt text principles and examples, caption standards, audio description, hashtag and inclusive language guides.
Documents
Word, PowerPoint, Excel, and PDF accessibility guides. Plain language standards. Federal Plain Language Guidelines adapted for accessibility use.
Cognitive
COGA overview and design patterns. SC 3.3.8 authentication, SC 3.3.7 redundant entry, error patterns. Dyslexia and ADHD guidance.
Color & Visual
Complete WCAG contrast thresholds, common color pairs, tools. Typography accessibility. Color blindness types, design patterns, and testing.
Legal
US ADA / DOJ 2024 rule. EU European Accessibility Act (2019/882). UK PSBAR 2018 and Equality Act. Canada ACA and AODA.
04
Starter prompt
Paste this after attaching your files
Short and direct. The attached files do the heavy lifting.
I attached files from the neura11y accessibility repository.
Use only those files as source material.
If the files do not fully cover the request, say that clearly
rather than filling gaps from general knowledge.
Help me create or review accessible [page / component / document / social post].
Get the repository
Star on GitHub
Clone or download at github.com/AYJAYY/neura11y/releases. Contributions, corrections, and new platform guides are welcome.