Astro Integration
Astro Humans
Generate a clean, human-readable humans.txt file for Astro sites at build time — because the internet is for humans.
Usage snapshot
Why this plugin exists
humans.txt is a courtesy file that documents the people and tools behind a website. It is not a legal document, ownership claim, or enforcement mechanism.
Astro Humans generates a deterministic humans.txt file at build time using a minimal, user-owned configuration file.
The plugin is intentionally non-opinionated, adds no runtime logic, and fails silently when configuration is missing or disabled.
What it delivers
Design principles
- Build-time only — zero runtime middleware or scripts
- Fail-silent behaviour — no output if config is missing or disabled
- Non-opinionated and human-first
- Deterministic output on every build
- No tracking, telemetry, or ownership claims
What this plugin does
- Generates a human-readable humans.txt file
- Supports automatic migration from legacy config locations
- Deterministic output with safe normalisation
- Optional /.well-known output
- No schema enforcement beyond basic safety
Installation
npm install astro-humans
On first run, the plugin ensures config-files/humans.config.json exists and migrates legacy root configs automatically.
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