Astro Integration
Astro Build Timestamp
Expose the exact time your Astro site was built using a single static file — nothing more, nothing less.
Last Updated: 01 April 2026
Usage Snapshot
155
Downloads in Last 30 Days
v1.0.1
Latest npm Version
Source: npm registry
Why This Plugin Exists
Knowing when a site was last built is a common operational need, especially for diagnostics, caching, and deployment verification.
Astro Build Timestamp solves this by writing a single static timestamp file during astro build.
The output is deterministic per build, public-safe, and works behind any CDN without runtime logic or metadata coupling.
Design Principles
- Build-time only — no runtime logic or scripts
- Single responsibility, minimal surface area
- Static, cache-safe output
- No environment or CI metadata coupling
- Never blocks a deployment
What This Plugin Delivers
- Writes a single static build timestamp file
- Supports ISO, Unix, and short timestamp formats
- Allows custom output filenames
- Works with any Astro adapter or CDN
- Produces deterministic output per build
Installation
npm install astro-build-timestamp
The plugin runs automatically during astro build and writes a static timestamp file to the final output directory.
FAQs
What does the Astro Build Timestamp plugin do?
Astro Build Timestamp writes a single static file containing the exact time the site was built during astro build.
Where is the timestamp written?
By default, the file is written to /build-timestamp.txt in the final build output.
Implementation FAQs
Why does Astro Build Timestamp exist?
It answers one operational question: when was this site built? Without runtime logic, metadata coupling, or environment guessing.
Does Astro Build Timestamp run at runtime?
No. The plugin runs exclusively at build time and produces static output.
What does the output file contain?
A single timestamp value representing the build time, written in a configurable format.
What timestamp formats are supported?
ISO 8601 (default), Unix timestamp, and a short deterministic identifier.
Can I change the output filename?
Yes. The output filename can be customised via the plugin configuration.
Is Astro Build Timestamp compatible with CDNs?
Yes. The output is static and cache-safe, making it compatible with any CDN.
Project Links
Source code, package distribution, releases, and documentation.
Need Implementation Details?
Read the FAQs for usage patterns, integration caveats, and rollout guidance.