Pour le grand public et les décideurs

Comprendre rapidement ce que l'outil apporte

Ce que fait Astro a11y

L'outil détecte automatiquement des défauts d'accessibilité techniques sur les pages déjà rendues, puis propose des pistes de correction.

Ce qu'il ne fait pas

Il ne remplace pas un audit humain complet ni les tests utilisateurs. C'est un garde-fou opérationnel, pas une certification légale.

Pour les développeurs

Un workflow clair, du scan au rapport

1. Scanner

Une cible locale (./dist) ou distante (https://...) est analysée avec garde-fous sécurité.

2. Analyser

Les pages sont ouvertes dans Playwright puis vérifiées via @axe-core/playwright.

3. Corriger

Les violations sont enrichies avec recommandations et mapping RGAA pour prioriser les fixes.

Positionnement

Quelle différence avec rgaa-audit ?

Les deux projets sont complémentaires, mais ils ne répondent pas au même besoin principal.

Astro a11y (ce projet)

Un guardrail Astro-first: il s'intègre au build Astro (ou via CLI) pour industrialiser un contrôle régulier et produire des rapports exploitables par les équipes dev, QA et produit.

Points forts: intégration Astro, pipeline simple, formats Terminal/JSON/HTML/Markdown, garde-fous de sécurité sur scans distants.

rgaa-audit

Un pré-audit RGAA généraliste, orienté pédagogie et lecture de conformité, avec une approche plus large hors contexte Astro.

Points forts: vulgarisation RGAA, couverture présentée par thèmes, et usages orientés diagnostic initial.

En pratique: si ton équipe construit en Astro et veut un contrôle continu au moment du build, Astro a11y est la bonne couche. Pour une lecture RGAA plus transversale et pédagogique, rgaa-audit reste très utile.

Lien vers l'autre projet: https://stan69000.github.io/rgaa-audit/

Quand choisir quoi ?

Cas 1: projet Astro avec besoin de contrôle régulier en build/CI → Astro a11y.
Cas 2: besoin d'une lecture pédagogique RGAA, plus généraliste → rgaa-audit.
Cas 3: équipe mixte (tech + non-tech) → utiliser les deux: rgaa-audit pour cadrer, Astro a11y pour industrialiser.

Preuve visuelle

Exemple réel de rapport HTML généré

Cette capture provient des artefacts versionnés du dépôt, générés par le scénario d'exemple.

Capture d'écran d'un rapport HTML astro-a11y — Voir aussi: rapport HTML, JSON, Markdown.

Démarrage

Intégration Astro en quelques lignes

pnpm add -D @astro-a11y/astro-integration
pnpm astro build

import { defineConfig } from 'astro/config';
import astroA11y from '@astro-a11y/astro-integration';

export default defineConfig({
  integrations: [astroA11y({ mode: 'balanced' })]
});

Rapports par défaut dans dist/astro-a11y/. La CLI reste disponible pour scanner un dossier build ou une URL.