From 9f9882cdda76e9da89bb727e51034c5bd70b6be9 Mon Sep 17 00:00:00 2001
From: Timothy Kim <timothykim@fastmail.fm>
Date: Fri, 20 Mar 2026 15:22:58 -0400
Subject: [PATCH] add testing section to readme

---
 README.md | 16 ++++++++++++++++
 1 file changed, 16 insertions(+)

diff --git a/README.md b/README.md
index 3380026..3112f0f 100644
--- a/README.md
+++ b/README.md
@@ -43,6 +43,7 @@ docker/
     Dockerfile
     garage.toml
     .env.keys
+tests/                 # pytest integration tests (run post-deploy)
 .gitea/workflows/      # Per-app deploy workflows + provision.yml
 ```
 
@@ -160,6 +161,21 @@ docker exec garage /garage layout apply --version 1
 If only hantim is reprovisioned, argento retains the layout and hantim
 reconnects automatically.
 
+## Testing
+
+Tests live in `tests/` and run with pytest:
+
+```bash
+pip install pytest
+pytest tests/ -v
+```
+
+Tests auto-discover sites from `docker/nginx/conf.d/*.conf` — no list to
+maintain when adding new sites.
+
+The `deploy-nginx.yml` workflow runs tests automatically after each nginx
+deploy. If tests fail, Gitea sends an email notification.
+
 ## Secrets
 
 ### Bitwarden Secrets Manager