Skip to main content
RIDLY - React Native E-commerce Mobile App SDK
Services
BlogGitHub
Back to Documentation

On this page

OverviewKey FeaturesArchitectureAdmin PanelAccessibility WidgetAccessibility ProfilesAudit EngineWCAG CoverageAnalyticsAPI ReferenceSupported LanguagesDeploymentSecurity
Back to Documentation
Stablev1.1.0

Ridly Accessibility Pro

EAA 2025 & WCAG 2.1 AA Compliant Self-hosted Accessibility SDK

Overview

Ridly Accessibility Pro is a comprehensive, enterprise-grade accessibility solution designed to help organizations achieve and maintain WCAG 2.1 AA compliance and meet the European Accessibility Act (EAA) 2025 deadline. The platform provides a self-hosted accessibility widget, automated auditing tools, AI-powered fix suggestions, and detailed analytics - all without sending your data to third-party services.

EAA 2025 Compliance

Deadline: June 28, 2025
Requirement: WCAG 2.1 AA Compliance
Coverage: All 27 EU member states
RIDLY

Free SDK. Custom development. Ready solutions for e-commerce.

SDK

  • GitHub
  • Documentation
  • Features

Resources

  • Blog
  • Services
  • Accessibility
  • Contact
  • Support

Connect

  • LinkedIn
© 2026 RIDLY. All rights reserved.·Lviv, Ukraine
AboutOfferRefundPrivacyTermsLicenseCookies
Penalties: Fines up to €100,000+ per violation

Key Features

40+ accessibility widget features for end-users
80+ automated WCAG 2.1 AA compliance checks
AI-powered fix suggestions (OpenAI & Anthropic)
Real-time widget analytics with conversion funnel
Scheduled audits (daily/weekly/monthly)
PDF audit report generation
CI/CD integration with API keys
Webhooks for event notifications
33 supported languages including RTL
White-label customization options
Self-hosted solution (full data control)

System Architecture

Ridly Accessibility Pro uses a monorepo architecture powered by Turborepo for efficient builds and caching.

@ridly/adminapps/admin

Next.js 15 Admin Dashboard with site management, auditing, analytics

@ridly/widgetapps/widget

Self-contained accessibility widget (Vite, UMD bundle)

@ridly/auditpackages/audit

CLI tool for WCAG audits (Puppeteer, axe-core)

Tech Stack

•Next.js 15— Admin dashboard with App Router
•React 19— Server Components support
•MongoDB— Document database
•Vite 6— Widget build tool
•Puppeteer— Browser automation for audits
•axe-core— Accessibility testing engine
•Tailwind CSS— Admin styling
•TypeScript— Type-safe development

Admin Panel

Sites Management

/dashboard/sites

Add and manage websites with widget configuration, scheduled audits, white-label branding

Accessibility Audit

/dashboard/audit

Run on-demand audits with 80+ WCAG checks, scoring, PDF export

Issues Tracking

/dashboard/issues

Kanban board for managing accessibility issues with AI suggestions

Analytics

/dashboard/analytics

Widget usage analytics with funnel tracking and geographic data

AI Assistant

/dashboard/ai

AI-powered chat for accessibility guidance (OpenAI, Claude)

Accessibility Statement

/dashboard/statement

Generate WCAG/EAA compliant accessibility statements

Accessibility Widget

The widget provides 40+ accessibility features in a single UMD bundle with inlined CSS. No external dependencies required.

Installation

<script
  src="https://ridly.io/widget/eaa-widget.min.js"
  data-license="YOUR_LICENSE_KEY"
  data-position="bottom-right"
  data-theme="auto"
  data-color="#3B82F6"
  data-language="en">
</script>

Get your LICENSE_KEY from the admin panel after registration.

Vision Adjustments

  • Font Size (80-200%)
  • Line Height
  • Letter Spacing
  • Word Spacing
  • Text Alignment
  • Dyslexic Font

Color Adjustments

  • High Contrast
  • Low Contrast
  • Saturation Control
  • Color Blind Modes
  • Invert Colors
  • Dark Mode

Navigation Aids

  • Highlight Links
  • Highlight Focus
  • Big Cursor (48x48)
  • Reading Guide
  • Keyboard Navigation

Content Adjustments

  • Hide Images
  • Stop Animations
  • Mute Sounds
  • Reading Mask
  • Text Magnifier

Cognitive Support

  • ADHD Mode
  • Dyslexia Mode
  • Highlight Headings
  • Simplified Interface

Accessibility Tools

  • Text-to-Speech
  • Virtual Keyboard
  • Page Structure
  • Dictionary
  • Smart Fixes

Accessibility Profiles

Pre-configured profiles that apply multiple settings at once for common use cases:

Seizure Safe

Stops animations and reduces saturation for photosensitive epilepsy

Vision Impaired

Larger text, high contrast, highlighted links for low vision

ADHD Friendly

Reduced distractions and stopped animations

Cognitive Disability

Readable fonts and increased spacing

Keyboard Navigation

Enhanced focus indicators for keyboard users

Blind Users

Optimized for screen reader compatibility

Older Adults

Larger text and cursor for seniors

Accessibility Audit Engine

The audit engine performs comprehensive WCAG 2.1 AA accessibility checks using axe-core with custom validations.

Scoring System

Score = max(0, 100 - sum(penalties))

Error-10 points

Critical accessibility barriers

Warning-3 points

Moderate issues requiring attention

Notice-1 point

Minor improvements recommended

CLI Tool

ridly-audit <url> [options]
--pages, -pMaximum pages to audit (default: 10)
--output, -oOutput file path
--format, -fOutput format: json, html, console
--timeoutPage load timeout in ms (default: 30000)

WCAG 2.1 AA Coverage

Perceivable

  • 1.1.1 Non-text Content (Alt text)
  • 1.2.1-5 Audio/Video Alternatives
  • 1.3.1-5 Info Structure & Orientation
  • 1.4.1-13 Color, Contrast, Text Spacing

Operable

  • 2.1.1-2 Keyboard Accessibility
  • 2.2.1-2 Timing Adjustable
  • 2.3.1 No Flashing Content
  • 2.4.1-7 Navigation & Focus
  • 2.5.1-3 Pointer & Touch

Understandable

  • 3.1.1-2 Language of Page/Parts
  • 3.2.1-3 Predictable Behavior
  • 3.3.1-4 Error Handling

Robust

  • 4.1.1-3 Valid HTML, ARIA, Status Messages

Widget Analytics

Track how users interact with the accessibility widget:

Overview

Total sessions, widget opens, feature toggles

Devices

Desktop/tablet/mobile, browsers, screen sizes

Geography

Top countries, cities, regional distribution

Funnel

Session → Widget viewed → Opened → Feature enabled → Used

Time

Hourly heatmap, peak usage, weekly patterns

API Reference

Authentication Methods

CookieCookie: ridly-auth-token=<jwt>Admin dashboard sessions
API Keyx-api-key: rk_<key>CI/CD integration
BearerAuthorization: Bearer <token>Programmatic access

Endpoints

MethodPathDescription
GET/POST/api/sitesSite management
GET/POST/api/auditAudit operations
GET/PATCH/api/issuesIssue tracking
POST/GET/api/analyticsWidget analytics
POST/api/ci/auditCI/CD audit endpoint
GET/api/widget/:siteIdWidget JavaScript

Webhook Events

  • audit.completed - Audit finished successfully
  • audit.scheduled - Scheduled audit triggered
  • score.changed - Site score changed
  • issues.found - New issues detected
  • report.generated - Monthly report ready

Supported Languages

The widget supports 33 languages including RTL (Arabic, Hebrew):

European (24)

EnglishUkrainianGermanFrenchSpanishItalianDutchPolishPortugueseCzechHungarianRomanianBulgarianGreekSwedishDanishFinnishNorwegianLithuanianLatvianEstonianSlovakSlovenianCroatian

Global (9)

TurkishArabic (RTL)Hebrew (RTL)JapaneseChineseKoreanVietnameseThaiHindi

Deployment

1git clone <repo-url>Clone repository
2yarn installInstall dependencies
3cp .env.example .envConfigure environment
4docker compose up -d mongodbStart MongoDB
5yarn user:create admin@example.com passwordCreate admin user
6yarn devStart development server

Environment Variables

MONGODB_URIrequiredMongoDB connection string
JWT_SECRETrequiredJWT signing secret (min 32 chars)
ANTHROPIC_API_KEYAnthropic API key for Claude AI
OPENAI_API_KEYOpenAI API key for GPT

Security

JWT Authentication

HS256 algorithm with 7-day expiry

Secure Cookies

HttpOnly, Secure, SameSite=Lax

Password Hashing

bcrypt with cost factor 12

Rate Limiting

5 login attempts per 15 minutes

API Key Security

Keys hashed before storage

Webhook Signatures

HMAC-SHA256 payload signing

Get Started

Request DemoContact Us