diff --git a/src/assets/manual/omnipro-ii-wordmark.png b/src/assets/manual/omnipro-ii-wordmark.png
new file mode 100644
index 0000000..d042f3c
Binary files /dev/null and b/src/assets/manual/omnipro-ii-wordmark.png differ
diff --git a/src/assets/screenshots/01-overview.png b/src/assets/screenshots/01-overview.png
new file mode 100644
index 0000000..f6694f9
Binary files /dev/null and b/src/assets/screenshots/01-overview.png differ
diff --git a/src/assets/screenshots/02-integrations-list.png b/src/assets/screenshots/02-integrations-list.png
new file mode 100644
index 0000000..8c26a9e
Binary files /dev/null and b/src/assets/screenshots/02-integrations-list.png differ
diff --git a/src/assets/screenshots/03-omni-pca-config.png b/src/assets/screenshots/03-omni-pca-config.png
new file mode 100644
index 0000000..7753b8c
Binary files /dev/null and b/src/assets/screenshots/03-omni-pca-config.png differ
diff --git a/src/assets/screenshots/04-panel-device.png b/src/assets/screenshots/04-panel-device.png
new file mode 100644
index 0000000..8327bf7
Binary files /dev/null and b/src/assets/screenshots/04-panel-device.png differ
diff --git a/src/assets/screenshots/05-entities-omni.png b/src/assets/screenshots/05-entities-omni.png
new file mode 100644
index 0000000..c16d141
Binary files /dev/null and b/src/assets/screenshots/05-entities-omni.png differ
diff --git a/src/assets/screenshots/06-developer-states.png b/src/assets/screenshots/06-developer-states.png
new file mode 100644
index 0000000..5ae6d80
Binary files /dev/null and b/src/assets/screenshots/06-developer-states.png differ
diff --git a/src/content/docs/index.mdx b/src/content/docs/index.mdx
index 50b0806..3c2302a 100644
--- a/src/content/docs/index.mdx
+++ b/src/content/docs/index.mdx
@@ -5,6 +5,15 @@ template: doc
 ---
 
 import { Card, CardGrid, LinkCard } from '@astrojs/starlight/components';
+import { Image } from 'astro:assets';
+import wordmark from '../../assets/manual/omnipro-ii-wordmark.png';
+
+<Image
+  src={wordmark}
+  alt="OmniPro II Automation"
+  loading="eager"
+  style="max-width: 480px; width: 100%; height: auto; margin: 1rem 0 2rem; filter: invert(1); opacity: 0.9;"
+/>
 
 ## What it is
 
diff --git a/src/content/docs/reference/ha-entities.md b/src/content/docs/reference/ha-entities.md
index 2ad07f4..7dcb9f5 100644
--- a/src/content/docs/reference/ha-entities.md
+++ b/src/content/docs/reference/ha-entities.md
@@ -204,3 +204,27 @@ first, then reload the integration.
 All of them sit on top of `OmniDataUpdateCoordinator` (`coordinator.py`),
 which keeps a long-lived `OmniClient`, runs one-time discovery on first
 refresh, and patches state in-place from the typed event stream.
+
+## What it looks like in HA
+
+The integration appears alongside the rest of HA's built-in integrations
+in **Settings → Devices & Services**:
+
+![HA Devices and Services dashboard showing HAI/Leviton Omni Panel next to Backup, Sun, and other integrations](../../../assets/screenshots/02-integrations-list.png)
+
+Clicking through, the integration page reports the discovered counts and
+the hub:
+
+![omni_pca integration page — Custom integration, version 2026.5.10, 1 device with 38 entities](../../../assets/screenshots/03-omni-pca-config.png)
+
+The device page is where every entity surfaces. Lights and switches with
+toggles, areas with arm states, thermostats with current temperature and
+setpoints, panel-button macros with Press buttons, plus the Diagnostics
+download:
+
+![Omni Pro II device page — controls grid with lights, areas, thermostats, and button macros all live](../../../assets/screenshots/04-panel-device.png)
+
+Developer Tools → States exposes the raw entity payloads — useful for
+template authoring and for confirming an attribute is wired through:
+
+![Developer Tools showing alarm_control_panel.omni_pro_ii_main with raw_mode_name OFF, code_arm_required true, area_index 1, friendly_name Omni Pro II Main](../../../assets/screenshots/06-developer-states.png)
diff --git a/src/content/docs/start/quickstart.md b/src/content/docs/start/quickstart.md
index 58fe3eb..3cdbbb1 100644
--- a/src/content/docs/start/quickstart.md
+++ b/src/content/docs/start/quickstart.md
@@ -107,6 +107,8 @@ binary_sensors for zones, climate for thermostats, and so on. State
 propagates over the panel's unsolicited push channel; a 30-second poll
 backstops anything that didn't push.
 
+![Home Assistant device page for an Omni Pro II panel — Controls section listing lights, areas, thermostats and panel-button macros](../../../assets/screenshots/04-panel-device.png)
+
 See the [HA entity catalogue](/reference/ha-entities/) for what gets created
 and the [HA service reference](/reference/ha-services/) for the seven
 services you can call from automations.