Accellens — AI Accessibility Compliance Platform

🚧 Work in Progress (WIP) 🚧

AI-powered accessibility compliance platform for comprehensive auditing of web and mobile interfaces. Combines automated code analysis, assistive technology emulation, and AI interpretation for WCAG 2.2, EN 301 549, and ADA Section 508 compliance.

Version: 0.1.3-alpha Date: November 10, 2025 Developer: Tridention

---

Description

Accellens is a cloud-based AI platform for comprehensive auditing of web and mobile interfaces for compliance with accessibility standards (WCAG 2.2, EN 301 549, ADA Section 508). The platform combines automated code analysis, real-world user scenario modeling, screen reader emulation, and AI interpretation of visual and cognitive perception.

Key Features

• 🔍 Automated auditing of web and mobile applications (WCAG 2.2, EN 301 549, ADA)
• 🎭 Assistive technology emulation (NVDA, JAWS, VoiceOver, TalkBack, keyboard navigation)
• 🤖 AI interpretation of violations with explanations and automatic fixes
• 📊 Accessibility Accuracy Score (AAS) — comparative accessibility metric
• 🔗 CI/CD integrations (GitHub Actions, GitLab CI, Jenkins)
• 📱 Mobile support (iOS/Android via Appium/XCUITest/Espresso)

---

Quick Start

Requirements

• Node.js 24.13.0 LTS
• Python 3.13+
• Docker 24.10+ and Docker Compose 2.27+
• PostgreSQL 16.6+, Redis 8.2+

Local Installation

# Clone the repository
git clone <repository-url>
cd accellens

# Set up environment
cp .env.example .env
# Edit .env file with your configuration

# Start infrastructure
docker compose up -d

# Apply database migrations
./scripts/migrate.sh upgrade head

# Start services (see docs/development/developer-guide.md for details)
# Backend services are started via docker-compose or individually

# Start frontend development server
cd apps/frontend
npm run dev

# Start Storybook for component development
npm run storybook

Using CLI

# Installation
npm install -g @accellens/cli

# Authentication
accellens login --api-url https://api.accellens.dev --token <TOKEN>

# Run web scan
accellens scan https://example.com --project mysite --format json

# View results
accellens runs list --project mysite

For more details: docs/api/cli-reference.md

Component Development with Storybook

Accellens uses Storybook for developing and testing UI components in isolation.

# Start Storybook development server
cd apps/frontend
npm run storybook

# Build Storybook for production
npm run storybook:build

Storybook will be available at http://localhost:6006 and includes:

• Interactive component previews
• Accessibility testing with a11y addon
• Component documentation
• Visual testing and regression detection

Example: API Usage

# Create a project (organization_id is required in URI path)
curl -X POST https://api.accellens.dev/api/v1/organizations/{organization_id}/projects \
  -H "Authorization: Bearer <TOKEN>" \
  -H "Content-Type: application/json" \
  -d '{"name": "My Website", "slug": "my-website"}'

# Start a scan (organization_id and project_id are required in URI path)
curl -X POST https://api.accellens.dev/api/v1/organizations/{organization_id}/projects/{project_id}/scans \
  -H "Authorization: Bearer <TOKEN>" \
  -H "Content-Type: application/json" \
  -d '{"type": "web", "triggerSource": "api", "targetUrl": "https://example.com"}'

Note: All API endpoints that work with organization data require organization_id in the URI path (not in the request body) for security and data isolation. See docs/api/api-reference.md for details.

For more details: docs/api/api-reference.md

---

Documentation

Full documentation navigation is available in docs/INDEX.md. All sections are listed there (PRD, architecture, development, testing, deployment, integrations, RFC, etc.) along with role-based routes.

For project structure and technical details, see docs/development/developer-guide.md.

Important:

• Documentation is always updated together with code (PRD, Roadmap, Developer Guide, Testing, Deployment).
• Change history is in CHANGELOG.md.

Roadmap

Current development focuses on MVP (0–3 months). For detailed roadmap, see docs/product/roadmap.md.

---

Contacts

Developer: Tridention

---

Links

• Documentation
• API Reference
• CLI Reference
• Roadmap
• Changelog
• Contributing