react
Featured
react
React is a JavaScript library for building user interfaces with declarative, component-based, and cross-platform design.
WebAudit
WebAudit is an automated QA crawler that navigates web applications, detects JavaScript errors, broken links, accessibility issues, and performance problems, captures screenshots with highlighted elements, and suggests fixes using both fixed rules and optional AI analysis (Claude, GPT, or Gemini).
Stars
9
7-day growth
No data
Forks
0
Open issues
0
License
No data
Last updated
2026-06-26
AI repository intelligence
FR-AI / ANALYSISWhy it is worth attention
It combines automated crawling with AI-powered fix suggestions, offers a visual dashboard and programmatic API, and supports multiple AI providers without requiring any key for basic rule-based operation.
Who it is for
- Web developers and QA engineers
- Freelancers auditing client websites
- CI/CD pipeline maintainers
- Accessibility and performance auditors
Use cases
- Automated QA of a web application before release
- Continuous monitoring of production sites for regressions
- Quick accessibility and broken link checks during development
- Generating interactive HTML reports with screenshots for stakeholder review
Strengths
- Supports three major AI providers (Anthropic, OpenAI, Google) without a required key for basic use
- Captures exact screenshots with element highlighting for each detected issue
- Provides both fixed rule suggestions (free) and AI suggestions (contextual, with screenshot)
- Offers CLI, visual web UI, programmatic API, and configuration file for flexible usage
Considerations
- Only crawls <a href> links; does not fill forms or simulate user flows like login or checkout
- Accessibility checks are basic and not a substitute for full WCAG conformance tools like axe-core
- Cannot crawl sites that require authentication
README quick start
WebAudit
Crawler automático de QA. Navega sozinho por uma aplicação web, detecta erros e problemas, captura screenshot exata de cada um, e sugere como corrigir — combinando regras fixas com análise de IA (Anthropic, OpenAI ou Gemini, à sua escolha).
O que ele detecta
| Categoria | O que verifica |
|---|---|
| Erros JavaScript | Exceções não tratadas no console (pageerror) |
| Console | console.error / console.warn |
| Rede | Requisições com status 4xx/5xx ou que falham (requestfailed) |
| Imagens quebradas | `` que retornam erro HTTP |
| Links quebrados | Todos os `` da página são checados via HEAD/GET |
| Acessibilidade | Imagem sem alt, input sem label, botão vazio, hierarquia de heading incorreta, página sem h1 |
| Performance | Tempo de carregamento (Navigation Timing API), imagens grandes sem loading="lazy" |
Cada problema vira um screenshot com o elemento destacado em vermelho, e recebe:
- uma sugestão de regra fixa (sempre disponível, sem custo)
- uma sugestão da IA (provedor configurado: Claude, GPT ou Gemini), analisando a descrição técnica e o screenshot, priorizada pelos itens mais críticos
Instalação
npm install
npx playwright install chromium # baixa o navegador usado pelo crawler
Configurando a IA (opcional, nenhum provedor é obrigatório)
A ferramenta suporta três provedores de IA, e você só precisa configurar a chave de um deles:
| Provedor | Variável de ambiente | Cobre |
|---|---|---|
| Anthropic | ANTHROPIC_API_KEY | Claude |
| OpenAI | OPENAI_API_KEY | GPT-4o e o que as pessoas costumam chamar de "ChatGPT" (mesma API/chave) |
GEMINI_API_KEY (ou GOOGLE_API_KEY) | Gemini, incluindo chaves geradas pelo Google AI Studio — é a mesma API por trás (generativelanguage.googleapis.com), o AI Studio é só a interface web onde a chave é criada |
A chave nunca deve ficar dentro de um arquivo .js ou ser commitada no código. Use uma das duas formas abaixo:
Opção A — arquivo .env na raiz do projeto (recomendado):
cp .env.example .env
Edite o .env e descomente apenas a linha do provedor que você vai usar:
GEMINI_API_KEY=sua-chave-aqui
O .env é lido automaticamente ao rodar webaudit e já está no .gitignore — não é commitado por engano.
**Opção B — variável de ambiente no terminal (sem c
Related repositories
Similar projects matched by category, topics, and programming language.
tandpfun
Featured
wardrobe
A GPT‑image powered app that extracts individual garment cutouts from photos, organizes them into a digital wardrobe, and generates modeled outfit previews.
mshumer
Featured
Claude-of-Duty
A browser-based first-person shooter built entirely with procedural generation and orchestrated AI agents, featuring 55k lines of Three.js/WebGL2 code and no art assets.