Overview
What astro-post-audit checks, where it stops, and how this documentation is organised.
astro-post-audit is an Astro integration that audits the finished dist/ output after every
astro build. It reads the generated HTML, sitemap, robots.txt and assets and reports SEO
signals, broken internal links and lightweight WCAG heuristics. The checks run in a native Rust
binary, offline and without a browser.
What it covers
- SEO: canonical tags and clusters, robots meta, URL normalisation, sitemap and robots.txt consistency, hreflang, Open Graph and Twitter cards, JSON-LD.
- Links: broken internal links, fragments, orphan pages, redirect chains, and opt-in external link checks.
- Accessibility: image alt text, link and button names, form labels, landmarks, duplicate ids, ARIA roles, heading hierarchy. The rules come from the shared a11y-core crates.
- Opt-in modules: HTML5 conformance, AI visibility, UX heuristics, content style, source analysis, CSS architecture, C2PA provenance, GDPR transfers.
Where it stops
Everything is static analysis of the built files. There are no computed styles, so contrast
(WCAG 1.4.3) is out of scope: the JSON report lists those rules as capability_missing
instead of counting them as passed. Use Lighthouse, axe-core or pa11y for contrast.
The tool is configured only through astro.config.mjs. The Rust binary is an internal detail
of the integration, not a standalone CLI.
How the docs are organised
- Getting started: install the integration and run a first audit.
- Guides: presets, rolling the audit out on an existing site, report files and CI.
- Reference: the options of
postAudit(), the check modules and the parts the package is built from.
The product page with a short tour lives at astro-post-audit.casoon.de.