Astro Integration
Astro Build ID
Identify exactly which build is deployed using a single static file — deterministic, cache-safe, and explicit.
Usage snapshot
96
Downloads in the last 30 days
Why this plugin exists
With static sites and CDNs, it is often unclear whether a deployment actually updated or which build is currently live.
astro-build-id solves this by writing a single immutable identifier file during astro build.
The output is static, public-safe, and works behind any CDN without runtime logic or environment inference.
What it delivers
Design principles
- Build-time only, zero runtime logic
- Single immutable source of truth
- Deterministic and cache-safe output
- Explicit configuration over guessing
- Never blocks a deployment
What this plugin does
- Writes a single static build identifier file
- Supports ISO, Unix, and short deterministic formats
- Allows custom filenames
- Supports explicit CI-provided values
- Works behind any CDN or static host
- Zero runtime JavaScript
Installation
npm install astro-build-id
The plugin runs during astro build and writes a static build identifier file to the final 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