Astro Integration
Astro Head Check
Build-time validation of essential HTML <head> metadata for Astro — no runtime code, no dashboards, no tracking.
Usage snapshot
322
Downloads in the last 30 days
Why this plugin exists
Missing or malformed <head> metadata is one of the most common causes of silent SEO and indexing issues.
Astro Head Check scans generated HTML files at build time and validates essential metadata before deployment.
It provides deterministic feedback without mutating output or introducing runtime dependencies.
What it delivers
Design principles
- Build-time only validation
- Zero runtime overhead
- Deterministic output
- No HTML mutation
- Explicit failure on misconfiguration
What this plugin does
- Validates <title> presence
- Validates meta description tags
- Validates canonical link tags
- Optional robots meta validation
- Configurable checks per project
- Warning-only or hard-fail modes
- Automatically skips 404 pages
- Skips redirect shim pages
Installation
npm install astro-head-check
After installation, add the integration to your astro.config.mjs to enable build-time validation.
Project links
Source code, releases, documentation, and contribution guidelines.
Want the deep dive?
Read the FAQs for implementation details, design rationale, and integration guidance.
View plugin FAQs