AuditDeck
v0.1.1: passive and deterministic

Passive product review deck generator

Generate a product review deck from any public website.

AuditDeck crawls same-origin public routes, captures desktop and mobile evidence, records technical and accessibility findings, then packages everything into JSON, presentation PDFs, technical appendix artifacts, and an AI-friendly review packet.

npm run audit -- \
  --site https://example.com \
  --depth 3 \
  --rate-limit-ms 1000 \
  --max-pages 300 \
  --density standard \
  --output ./output

Generated Artifacts

screenshots/
findings.json
journeys.json
journeys.md
report.html
report.pdf
report-appendix.html
report-appendix.pdf
ai-review.md

What v1 Audits

Discovery

Seeds from the root URL, robots.txt sitemap entries, default sitemap.xml, same-origin internal links up to the configured depth, and safe www/non-www companion sitemap discovery.

Evidence

Captures desktop and mobile screenshots, titles, h1s, meta descriptions, visible links and buttons, console errors, and failed requests.

Accessibility

Runs axe against rendered URL states and adds deterministic rule-based findings, severity labels, and recommended fixes.

Deck controls

Keeps findings JSON complete while presentation reports can hide info-only and legal routes, then tune spacing with compact, standard, or detailed density.

Review navigation

Adds a cover thumbnail, table of contents, clickable screenshots, live route links, and captured page copy beside each reviewed image.

Passive journeys

Builds route graphs, CTA inventories, conversion endpoint guesses, and funnel risks without clicking buttons or submitting forms.

Safety Boundaries

Passive by default

  • Does not click buttons
  • Does not submit forms
  • Does not trigger mutating actions

Polite crawling

  • Respects robots.txt by default
  • Honors crawl-delay where present
  • Stays on the same origin

Scoped v1

  • No auth flows
  • No AI API dependency
  • No Lighthouse or visual diffing