phase 0 complete

.env.example

@@ -0,0 +1,50 @@
+# Copy to .env and fill in. Required vars have no default and the server
+# fails fast at startup if they're missing.
+
+# --- Required ---
+
+# pgx connection string, e.g. postgres://user:pass@localhost:5432/solopm
+DATABASE_URL=
+
+# External URL the app is served at. Used in emails, OAuth callbacks, and
+# webhook payloads.
+BASE_URL=http://localhost:8080
+
+# Session cookie signing/encryption key. Must be at least 32 bytes.
+SESSION_SECRET=
+
+# --- Server ---
+
+HTTP_PORT=8080
+LOG_LEVEL=info
+
+# --- Attachments ---
+
+UPLOAD_DIR=./uploads
+MAX_UPLOAD_MB=25
+
+# --- Search (optional; search endpoints return 503 while unset) ---
+
+MEILI_URL=
+MEILI_KEY=
+
+# --- Email (optional; disabled while SMTP_HOST is unset) ---
+
+SMTP_HOST=
+SMTP_PORT=
+SMTP_USER=
+SMTP_PASS=
+SMTP_FROM=
+
+# --- OAuth (optional; the corresponding login button is hidden while unset) ---
+
+GITHUB_CLIENT_ID=
+GITHUB_CLIENT_SECRET=
+
+GITEA_URL=
+GITEA_CLIENT_ID=
+GITEA_CLIENT_SECRET=
+
+# --- Retention ---
+
+CULL_AFTER_DAYS=30