From 3bef577702dcea71b790ebf58229a4d3bf5226e3 Mon Sep 17 00:00:00 2001
From: Shadowbroker <43977454+BigBodyCobain@users.noreply.github.com>
Date: Tue, 18 Aug 2026 16:09:14 -0600
Subject: [PATCH] docs(liveuamap): expose optional provider configuration

---
 .env.example | 14 ++++++++++++--
 1 file changed, 12 insertions(+), 2 deletions(-)

diff --git a/.env.example b/.env.example
index e925239..341ff54 100644
--- a/.env.example
+++ b/.env.example
@@ -77,10 +77,20 @@ ADMIN_KEY=
 # NUFORC_MAPBOX_TOKEN=
 
 # Optional startup-risk controls.
-# On Windows, external curl fallback is off by default. LiveUAMap uses UI consent
-# when you enable Global Incidents (or set SHADOWBROKER_ENABLE_LIVEUAMAP_SCRAPER=true).
+# On Windows, external curl fallback is off by default. Global Incidents always
+# has the GDELT baseline; the LiveUAMap browser provider is optional enrichment.
+# Windows asks once when you enable Global Incidents. Declining keeps GDELT on.
+# Linux/macOS/Docker preserve the existing browser-enrichment default unless
+# SHADOWBROKER_ENABLE_LIVEUAMAP_SCRAPER is explicitly false.
 # SHADOWBROKER_ENABLE_WINDOWS_CURL_FALLBACK=false
 # SHADOWBROKER_ENABLE_LIVEUAMAP_SCRAPER=false
+# Optional paid/contracted LiveUAMap API provider. Shadowbroker does not require
+# this. Configure the final HTTPS JSON/GeoJSON endpoint supplied to you.
+# LIVEUAMAP_API_URL=
+# LIVEUAMAP_API_KEY=
+# LIVEUAMAP_API_AUTH_HEADER=Authorization
+# LIVEUAMAP_API_AUTH_SCHEME=Bearer
+# LIVEUAMAP_API_TIMEOUT_S=30
 # AIS starts by default when AIS_API_KEY is set. Set to 0/false to force-disable.
 # SHADOWBROKER_ENABLE_AIS_STREAM_PROXY=true
 # Minimum visible satellite catalog before forcing a CelesTrak refresh.