diff --git a/README.md b/README.md
index 5734f9e..38f93a0 100644
--- a/README.md
+++ b/README.md
@@ -16,6 +16,10 @@
 Ferese is built in Rust on Smithay, with its own menu bar, control center
 and native Settings app.
 
+![Ferese desktop with a stacked clock widget, compact workspace bar, and control center](docs/images/ferese-desktop.png)
+
+![Ferese Settings showing the Monochrome theme and appearance presets](docs/images/ferese-monochrome.png)
+
 ## Features
 
 - Scrolling columns, tree tiling and floating windows
@@ -71,8 +75,9 @@ session logs and rollback.
 
 Built-in defaults (your configuration can override them):
 
-The bar shows workspaces 1–9 in a compact numbered strip, including empty ones.
-Click a number to switch using the same behavior as Super+1–9. A filled button marks this monitor's
+A single-display session starts with workspace 1 in a compact numbered strip.
+More workspaces are created when you use Super+1–9 or swipe forward past the last
+workspace. Click a number to switch. A filled button marks this monitor's
 active workspace; an outlined button marks one active on another monitor.
 Status controls and the clock use matching compact groups. The control center
 opens as one rounded panel with grouped controls and a Settings shortcut.
diff --git a/docs/images/ferese-desktop.png b/docs/images/ferese-desktop.png
new file mode 100644
index 0000000..9ceb1a0
Binary files /dev/null and b/docs/images/ferese-desktop.png differ
diff --git a/docs/images/ferese-monochrome.png b/docs/images/ferese-monochrome.png
new file mode 100644
index 0000000..b32c867
Binary files /dev/null and b/docs/images/ferese-monochrome.png differ