diff --git a/README.md b/README.md
index 91cb43f..c589b59 100644
--- a/README.md
+++ b/README.md
@@ -9,6 +9,20 @@ How it fits together:
3. A card the service hasn't seen before becomes an **Unassigned tag**. It appears on the web page within a few seconds, where you search the Music Assistant library and assign an album.
4. When a card is removed, HA's `Stop album by tag` script calls `GET /api/tags/{tag_id}`. It stops the player only if that tag has an album.
+## Demo
+
+The main page lists unassigned tags (a card scanned while the page is open appears within a few seconds) and every assignment:
+
+
+
+Assigning a tag: search the Music Assistant library and pick an album. Albums without a cover show a grey placeholder.
+
+
+
+The page follows the system's dark mode and works on a phone:
+
+
+
## API
Both endpoints need `Authorization: Bearer `.
diff --git a/docs/screenshots/assign.png b/docs/screenshots/assign.png
new file mode 100644
index 0000000..9edc229
Binary files /dev/null and b/docs/screenshots/assign.png differ
diff --git a/docs/screenshots/tags-dark-mobile.png b/docs/screenshots/tags-dark-mobile.png
new file mode 100644
index 0000000..c633fc6
Binary files /dev/null and b/docs/screenshots/tags-dark-mobile.png differ
diff --git a/docs/screenshots/tags.png b/docs/screenshots/tags.png
new file mode 100644
index 0000000..5bf13ab
Binary files /dev/null and b/docs/screenshots/tags.png differ