diff --git a/.env.example b/.env.example
new file mode 100644
index 0000000..3019e82
--- /dev/null
+++ b/.env.example
@@ -0,0 +1,14 @@
+# Shipper (generator machine) config — copy to ship.env, edit, then:
+#   set -a; . ./ship.env; set +a; go run ./cmd/shipper
+# Streamer/VPS config lives in vps/.env.vps.example.
+
+LIBRARY_DIR=/path/to/ai-radio/library
+SHIP_STAGING_DIR=./ship_out
+SHIP_REMOTE_TARGET=root@YOUR_VPS:/opt/airstudio/web/ai-radio/
+SHIP_SSH_KEY=~/.ssh/id_ed25519_vps
+SHIP_POLL_INTERVAL_S=60
+
+PLAYLIST_SIZE=40
+NEWNESS_BIAS=3
+MP3_BITRATE=128k
+STATION_NAME=AI Radio