diff --git a/README.md b/README.md
index 0ef4618..4ba8404 100644
--- a/README.md
+++ b/README.md
@@ -6,6 +6,16 @@ IBM VIBE is a conversation-centric testing suite for evaluating AI agents throug
 
 Use it to script realistic agent conversations, run them against agent configurations, and inspect the resulting sessions, jobs, token usage, similarity scores, and failures.
 
+## Screenshots
+
+| Dashboard                                                                                                                     | Conversation detail                                                                                                  |
+| ----------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------- |
+| ![Dashboard showing first-run checklist, summary metrics, job status, and agent performance table](docs/assets/dashboard.png) | ![Conversation detail page showing the script alongside the latest session transcript](docs/assets/conversation.png) |
+
+| Quick execute                                                                                                               | Session                                                                                                          |
+| --------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------- |
+| ![Quick execute page with agent and conversation selectors and a conversation preview panel](docs/assets/quick-execute.png) | ![Session page showing turn-by-turn messages with similarity scores and token metadata](docs/assets/session.png) |
+
 ## Why VIBE?
 
 - **Test conversations, not just prompts**: model the multi-turn exchanges your users actually have.
@@ -111,17 +121,6 @@ For multi-instance local setups, use `env.instance1.example` as a template and c
 - [`CONTRIBUTING.md`](CONTRIBUTING.md) - contributor workflow
 - [`SECURITY.md`](SECURITY.md) - private vulnerability reporting
 
-## Visuals to add before a public push
-
-The repo will read much better on GitHub with a small visual set under `docs/assets/`:
-
-- Dashboard screenshot with first-run guidance visible
-- Conversation editor screenshot
-- Quick execute screenshot
-- Session transcript screenshot
-
-Add those images to this README once captured from a representative local instance.
-
 ## License
 
 Apache-2.0. See [`LICENSE`](LICENSE).
diff --git a/docs/assets/conversation.png b/docs/assets/conversation.png
new file mode 100644
index 0000000..ca7b9c2
Binary files /dev/null and b/docs/assets/conversation.png differ
diff --git a/docs/assets/dashboard.png b/docs/assets/dashboard.png
new file mode 100644
index 0000000..6af8906
Binary files /dev/null and b/docs/assets/dashboard.png differ
diff --git a/docs/assets/quick-execute.png b/docs/assets/quick-execute.png
new file mode 100644
index 0000000..fd4aa54
Binary files /dev/null and b/docs/assets/quick-execute.png differ
diff --git a/docs/assets/session.png b/docs/assets/session.png
new file mode 100644
index 0000000..e353113
Binary files /dev/null and b/docs/assets/session.png differ