What is humans.txt?
humans.txt is a courtesy file that documents the people and tools behind a website. It is not a legal or technical enforcement mechanism.
Astro & Humans
Astro Humans Plugin FAQs
Clear answers explaining how Astro Humans generates humans.txt files and why it remains intentionally non-opinionated.
Questions covered
Answers
Does Astro Humans run at runtime?
No. Astro Humans runs exclusively at build time and adds no runtime middleware, scripts, or client-side logic.
Where is the configuration file stored?
On first run, the plugin ensures config-files/humans.config.json exists. Legacy root configs are migrated automatically.
Does Astro Humans migrate older configurations?
Yes. If a legacy humans.config.json exists in the project root, it is moved once to config-files/ without overwriting existing files.
What happens if the configuration is missing or invalid?
The plugin fails silently. No humans.txt file is generated and the build continues normally.
Is there a required schema?
No. All sections are optional and omitted if empty. There is no enforcement beyond basic safety.
What sections can humans.txt include?
TEAM, SITE, TECHNOLOGY, and NOTES sections are supported. All are optional.
Does humans.txt assert ownership or legal rights?
No. humans.txt is not a legal document and does not assert ownership or rights.
Does Astro Humans collect analytics or telemetry?
No. Astro Humans performs no analytics, tracking, telemetry, or outbound requests.
Is Astro Humans deterministic?
Yes. Given the same configuration, Astro Humans always produces identical output.
Is Astro Humans open source?
Yes. Astro Humans is fully open source and released under the MIT license.
Want to try it yourself? Astro Humans plugin or humans.txt example or Astro Legal plugin
Ready to add a humans.txt to your Astro site?