From 3e6ce809d0de96edc27e48dd01e4d088428cbfaf Mon Sep 17 00:00:00 2001
From: bvandeusen <bryan.vandeusen@fabledsword.com>
Date: Sun, 19 Apr 2026 01:12:35 +0000
Subject: [PATCH] M1/#291: document SMARTMUSIC_* env vars + test DSN

---
 .env.example | 12 ++++++++++++
 1 file changed, 12 insertions(+)
 create mode 100644 .env.example

diff --git a/.env.example b/.env.example
new file mode 100644
index 00000000..9745b25c
--- /dev/null
+++ b/.env.example
@@ -0,0 +1,12 @@
+# Minstrel environment variable overrides.
+# Copy to .env for docker compose, or export before `go run ./cmd/minstrel`.
+# Values shown are sensible defaults for the local docker-compose postgres.
+
+SMARTMUSIC_SERVER_ADDRESS=:4533
+SMARTMUSIC_DATABASE_URL=postgres://minstrel:minstrel@localhost:5432/minstrel?sslmode=disable
+SMARTMUSIC_LOG_LEVEL=info
+SMARTMUSIC_LOG_FORMAT=text
+
+# Set this when running `go test ./...` without -short to exercise the
+# migration test against a running postgres.
+# MINSTREL_TEST_DATABASE_URL=postgres://minstrel:minstrel@localhost:5432/minstrel?sslmode=disable