diff --git a/README.md b/README.md
index a6abb7a..e4321ee 100644
--- a/README.md
+++ b/README.md
@@ -28,6 +28,36 @@ BGG has no bulk import and no write API. Cataloging a few hundred games by hand
 
 Every stage is idempotent and resumable: kill it mid-run, restart, lose nothing. All artifacts are flat CSV/JSON files you can inspect and edit.
 
+## What it looks like
+
+**The Pipeline page** — every stage is a card with live counts and a Run button; blockers (missing token, stub-data lock) are banners, not surprises.
+
+![Pipeline dashboard: six stage cards with live counts, Run buttons, and warning banners for the missing BGG token and the stub-data upload lock](docs/screenshots/01.png)
+
+**Photos** — drag shelf photos in; boxes the vision model saw but couldn't read become illustrated reshoot tickets with shelf directions a human can follow.
+
+![Photos page: drag-and-drop upload zone, reshoot tickets with photo thumbnails and shelf-location descriptions, and the gallery of all shelf photos with per-photo title counts](docs/screenshots/02.png)
+
+**Titles** — every read off the shelves, alphabetized with status and source photos. This is the proofreading checkpoint: edit misreads, split multi-copy lines, remove non-games.
+
+![Titles page: 123 extracted titles with AUTO / AWAITING BGG status chips, source photo links, edit and split-into-copies actions, and a shaky-reads filter](docs/screenshots/03.png)
+
+**Review** — keyboard-first decisions on ambiguous matches, editions, and cross-photo merges (with veto). Here: everything resolvable is reviewed, 106 titles parked awaiting the API token.
+
+![Review page in its done state: 123 extracted, 17 recognized, 2 with versions, 0 rejected, with 106 titles waiting on the BGG API token](docs/screenshots/04.png)
+
+**Queue** — exactly what upload will do before it does it, and a permanent log of every attempt ever made.
+
+![Upload queue: six new collection entries with game, version, and source photos, plus empty version-updates and upload-log sections](docs/screenshots/05.png)
+
+**Library** — the enriched collection browser (board games and RPGs), waiting for real BGG data to fill its shelves.
+
+![Library page empty state with search and Board games / RPGs filters, explaining that the library fills after the enrich stage runs](docs/screenshots/06.png)
+
+**Help** — the whole flow, every page, every status, and every keyboard shortcut, documented in-app.
+
+![Help page documenting the shelves-to-collection flow, what each page is for, and the proofreading and review checkpoints](docs/screenshots/07.png)
+
 ## Requirements
 
 - macOS or Linux, Python 3.12+, [uv](https://docs.astral.sh/uv/)
diff --git a/docs/screenshots/01.png b/docs/screenshots/01.png
new file mode 100644
index 0000000..a6a1726
Binary files /dev/null and b/docs/screenshots/01.png differ
diff --git a/docs/screenshots/02.png b/docs/screenshots/02.png
new file mode 100644
index 0000000..0548ebe
Binary files /dev/null and b/docs/screenshots/02.png differ
diff --git a/docs/screenshots/03.png b/docs/screenshots/03.png
new file mode 100644
index 0000000..d08c932
Binary files /dev/null and b/docs/screenshots/03.png differ
diff --git a/docs/screenshots/04.png b/docs/screenshots/04.png
new file mode 100644
index 0000000..0df8394
Binary files /dev/null and b/docs/screenshots/04.png differ
diff --git a/docs/screenshots/05.png b/docs/screenshots/05.png
new file mode 100644
index 0000000..4768e57
Binary files /dev/null and b/docs/screenshots/05.png differ
diff --git a/docs/screenshots/06.png b/docs/screenshots/06.png
new file mode 100644
index 0000000..6e2773f
Binary files /dev/null and b/docs/screenshots/06.png differ
diff --git a/docs/screenshots/07.png b/docs/screenshots/07.png
new file mode 100644
index 0000000..cc39837
Binary files /dev/null and b/docs/screenshots/07.png differ