From de3d8dda223b8d5cb4482ac565be7e3c57f0d644 Mon Sep 17 00:00:00 2001
From: doxa-maps-88655c70
 <88627970+doxa-maps-88655c70@users.noreply.github.com>
Date: Fri, 25 Sep 2026 03:09:07 +0000
Subject: [PATCH] README: show the iframe and JS-embed snippets, shaped like
 manifest.json ships them

Host as a placeholder and the SRI hash elided (it changes every build), with a
pointer to manifest.json for the exact copy, so the README cannot go stale.
---
 README.md | 19 ++++++++++++++++---
 1 file changed, 16 insertions(+), 3 deletions(-)

diff --git a/README.md b/README.md
index bb6ecdf1e..597ca8c40 100644
--- a/README.md
+++ b/README.md
@@ -100,7 +100,12 @@ One folder, one `.vue`, one element. `plugin-designs/all-people-groups/`
 
 ### 1. iframe — the prayer map on any site ✅ production
 
-One `<iframe>` tag, no build step. Copy the `embed.iframe` snippet from `manifest.json`.
+One `<iframe>` tag, no build step. Each plugin's exact snippet is `embed.iframe` in `manifest.json`:
+
+```html
+<iframe src="https://YOUR_HOST/doxa-maps/doxa-simple-map/doxa-simple-map/prayer/index.html?utm_source=YOUR_SOURCE"
+        width="100%" height="600" style="border:none;border-radius:12px;" allowfullscreen></iframe>
+```
 
 ![Method 1 — the prayer map embedded in a host page's iframe](documentation/readme-images/deploy1-iframe.png)
 
@@ -114,8 +119,16 @@ print options that wrap to fit. `bun run check:mobile` · `bun run phone` (needs
 ### 3. JavaScript embed — the Research Gallery on dx-life ✅ production
 
 The whole capability-5 app on the dx-life research page, from one `<script src>` and one element —
-replacing the separate research map, list and regions dashboards the page used to carry. Copy the
-`embed.script` snippet (SRI-pinned) from `manifest.json`.
+replacing the separate research map, list and regions dashboards the page used to carry. The exact
+snippet is `embed.script` in `manifest.json`; copy its `integrity` hash from there, as it changes with
+every build:
+
+```html
+<script>window.MAP_APP_API_URL="https://pray.doxa.life";</script>
+<script src="https://YOUR_HOST/doxa-maps/doxa-maps-spa/doxa-maps-spa.js"
+        integrity="sha384-…" crossorigin="anonymous"></script>
+<doxa-maps-spa profile-config='{"profile":"doxa-maps-spa","tk":"YOUR_MAPBOX_TOKEN","utmSource":"YOUR_SOURCE","assetsBase":"https://YOUR_HOST/doxa-maps/assets"}'></doxa-maps-spa>
+```
 
 ![Method 3 — the Research Gallery JS-embedded on the dx-life research page](documentation/readme-images/deploy3-js-embed-dxlife.png)