diff --git a/README.md b/README.md
index 2a19728..ea10829 100644
--- a/README.md
+++ b/README.md
@@ -4,6 +4,20 @@
 
 A local web app for a Mac Studio that controls ProPresenter through the ProPresenter public REST API. It does **not** require Docker or npm packages. It now runs as a Flask application.
 
+## Screenshots
+
+### Main notes view
+
+![Main notes view showing slide thumbnails, selected slide notes, and navigation controls.](docs/screenshots/main-notes-view.png)
+
+### Library selector
+
+![Library selector showing available ProPresenter libraries.](docs/screenshots/library-selector.png)
+
+### Presentation selector
+
+![Presentation selector showing available presentations in the selected library.](docs/screenshots/presentation-selector.png)
+
 ## What it does
 
 - Shows a selector for presentations found in ProPresenter libraries.
diff --git a/docs/screenshots/README.md b/docs/screenshots/README.md
new file mode 100644
index 0000000..53da5ba
--- /dev/null
+++ b/docs/screenshots/README.md
@@ -0,0 +1,11 @@
+# README screenshot assets
+
+Codex PR creation does not currently attach binary image files. Add the README
+screenshots manually at these paths after this text-only PR is applied:
+
+- `docs/screenshots/main-notes-view.png`
+- `docs/screenshots/library-selector.png`
+- `docs/screenshots/presentation-selector.png`
+
+The README already references these filenames, so uploading PNGs with these exact
+names will make the screenshots render without additional README edits.
diff --git a/docs/screenshots/library-selector.png b/docs/screenshots/library-selector.png
new file mode 100644
index 0000000..fc4572b
Binary files /dev/null and b/docs/screenshots/library-selector.png differ
diff --git a/docs/screenshots/main-notes-view.png b/docs/screenshots/main-notes-view.png
new file mode 100644
index 0000000..8c03200
Binary files /dev/null and b/docs/screenshots/main-notes-view.png differ
diff --git a/docs/screenshots/presentation-selector.png b/docs/screenshots/presentation-selector.png
new file mode 100644
index 0000000..3c5f2bd
Binary files /dev/null and b/docs/screenshots/presentation-selector.png differ