diff --git a/README.md b/README.md
index cf9188a..703c33b 100644
--- a/README.md
+++ b/README.md
@@ -8,6 +8,14 @@ comes from an admin invite or a room invite. See
 [ARCHITECTURE.md](ARCHITECTURE.md) for the full system design and phased
 build plan.
 
+![DS Chat main view: a room with Markdown formatting, an @mention, and emoji reactions](docs/screenshots/chat-dark.png)
+
+| Custom theme builder | Same room, custom theme applied |
+|---|---|
+| ![The custom theme builder: a live, hoverable mockup mapped to 12 color fields](docs/screenshots/theme-builder.png) | ![The same room under a custom theme built with the theme editor](docs/screenshots/chat-aurora.png) |
+
+<sub>Also responsive on mobile — [screenshot](docs/screenshots/chat-mobile.png)</sub>
+
 ## Features
 
 - **Auth & accounts** — session-based auth, invite-only signup (admin-issued
diff --git a/docs/screenshots/chat-aurora.png b/docs/screenshots/chat-aurora.png
new file mode 100644
index 0000000..3631df3
Binary files /dev/null and b/docs/screenshots/chat-aurora.png differ
diff --git a/docs/screenshots/chat-dark.png b/docs/screenshots/chat-dark.png
new file mode 100644
index 0000000..f13b3ec
Binary files /dev/null and b/docs/screenshots/chat-dark.png differ
diff --git a/docs/screenshots/chat-mobile.png b/docs/screenshots/chat-mobile.png
new file mode 100644
index 0000000..d8cc7e6
Binary files /dev/null and b/docs/screenshots/chat-mobile.png differ
diff --git a/docs/screenshots/theme-builder.png b/docs/screenshots/theme-builder.png
new file mode 100644
index 0000000..8d32075
Binary files /dev/null and b/docs/screenshots/theme-builder.png differ