feature/IO-3587-Commision-Cut - Improved local email

_reference/localEmailViewer/README.md

@@ -1,7 +1,33 @@
-This will connect to your dockers local stack session and render the email in HTML.
+This app connects to your Docker LocalStack SES endpoint and gives you a local inbox-style viewer
+for generated emails.
+
+```shell
+npm start
+```
+
+Or:
 
 ```shell
 node index.js
 ```
 
-http://localhost:3334
+Open: http://localhost:3334
+
+Features:
+
+- Manual refresh
+- Live refresh with adjustable polling interval
+- Search across subject, addresses, preview text, and attachment names
+- Expand/collapse all messages
+- Rendered HTML, plain-text, and raw MIME views
+- Copy raw MIME source
+- New-message highlighting plus fetch timing and parse-error stats
+
+Optional environment variables:
+
+```shell
+PORT=3334
+SES_VIEWER_ENDPOINT=http://localhost:4566/_aws/ses
+SES_VIEWER_REFRESH_MS=10000
+SES_VIEWER_FETCH_TIMEOUT_MS=5000
+```