From 9e43332aad169e6f3a3eef81afb6d2580010dd3d Mon Sep 17 00:00:00 2001
From: doxa-maps-88655c70
 <88627970+doxa-maps-88655c70@users.noreply.github.com>
Date: Fri, 25 Sep 2026 05:09:09 +0000
Subject: [PATCH] EMBED.md: lead with the picture and an at-a-glance table

The embed guide opened with prose and a code block. It now leads with the
existing screenshot of the gallery embedded by script on a partner page,
then a two-column table (script vs iframe): what to paste, sizing,
language, deep link, keyless maps, and what the server must send. Every
row is behaviour measured this session. Then it names the seven
production maps in their sections.
---
 plugin-designs/doxa-maps-spa/EMBED.md | 17 +++++++++++++++++
 1 file changed, 17 insertions(+)

diff --git a/plugin-designs/doxa-maps-spa/EMBED.md b/plugin-designs/doxa-maps-spa/EMBED.md
index 1f8a5d677..600d7c5d7 100644
--- a/plugin-designs/doxa-maps-spa/EMBED.md
+++ b/plugin-designs/doxa-maps-spa/EMBED.md
@@ -1,10 +1,27 @@
 # Embedding the Research Gallery
 
+![The Research Gallery embedded by script on a partner page: the tab rail on the left, Big Picture open](../../documentation/readme-images/deploy3-js-embed-dxlife.png)
+
 `<doxa-maps-spa>` (labeled **Research Gallery**) is the capability-5 app shell: one element whose
 tab rail nests every production map. It is built to drop onto somebody else's page. Below,
 `TREE` means the URL of the built `doxa-maps/` folder wherever it is served, for example
 `https://YOUR-HOST/doxa-maps`.
 
+## At a glance
+
+| | **Script embed** | **iframe embed** |
+|---|---|---|
+| **Paste** | two lines: `<script>` + `<doxa-maps-spa>` | one `<iframe>` |
+| **Sizing** | a block in your layout, `85vh` by default | whatever size you give the frame |
+| **Language** | follows your page (`<html lang>`), or `language="…"` | `?lang=…` on the `src` |
+| **Open on a map** | `tab="upg-100"` | `?tab=upg-100` |
+| **Keyless maps** | `provider="maplibre"` | `?provider=maplibre` |
+| **Your server must send** | CORS on the whole tree | CORS + `frame-ancestors` on the leaf page |
+
+**Seven production maps** sit in the rail: Big Picture, Simple Research and Regions (Dashboards);
+UPG-100 List and Prayer Progress (Prayer Mobilization); Cities with Internet and Gospel Resources
+(Gospel Research). An Experimental folder collects everything else in the tree.
+
 ## Script embed (recommended)
 
 ```html