Astro Integration
Astro Status
A static-first status endpoint for Astro — honest about what static sites can and cannot claim.
Usage snapshot
294
Downloads in the last 30 days
Why this plugin exists
Static sites cannot truthfully report runtime health, yet many status endpoints pretend they can.
Astro Status exposes a build-time status instead — answering one honest question: did this site build successfully, and when?
The result is a deterministic, cache-safe status file designed for monitoring systems and tooling.
What it delivers
Design principles
- Static-first honesty
- Deterministic output
- No runtime claims
- Machine-readable by default
- Zero user input
What this plugin does
- Generates a static /status.json file at build time
- Includes build timestamp
- Detects Astro output mode automatically
- Cache-safe and CDN-friendly
- No runtime JavaScript
- No environment variable access
- No request handling
Installation
npm install astro-status
The plugin runs during astro build and writes a static status file to the output directory.
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