diff --git a/README.md b/README.md
index f85b2c9..2204f22 100644
--- a/README.md
+++ b/README.md
@@ -14,6 +14,32 @@ live-omladdning av JSON-configen.
 |---|---|
 | ![dock](assets/screenshots/dock-closeup.png) | ![settings](assets/screenshots/settings.png) |
 
+Samma dock, sex olika configar — bara JSON-filen ändrades mellan bilderna:
+
+![galleri](assets/screenshots/gallery.png)
+
+## Vad kan konfigureras?
+
+- **Placering**: nere/uppe/vänster/höger; centrerad/vänster-/högerjusterad ö
+  eller expanderad över hela kanten; tre marginaler (från kanten + start/slut,
+  minusvärden ok) — med ritad illustration i settings som visar måtten
+- **Utseende**: panelfärg + transparens, accentfärg, hörnradie, kant, skugga,
+  ikonstorlek/-avstånd, hover-zoom, animationer, indikatorstil
+- **Beteende**: klick (fokus/minimera/växla), mittklick, skroll (växla fönster
+  eller starta stoppad app), gruppering, fönsterlista vid klick eller hover,
+  peek/fokus vid hover i listan, tooltips, urgency-puls
+- **Menyer**: välj exakt vilka val högerklicksmenyn ska ha
+  (minimera/maximera/flytta till skärm/pinna/stäng)
+- **Per skärm**: vilken inställning som helst kan överridas per skärm —
+  egna pins, position, färger, filter för bara-den-skärmens-fönster
+- **Autohide**: dodge (göm vid fönsteröverlapp) eller göm alltid, med
+  sensor vid kanten och animation
+- **Hotspots**: hot corners/edges som kör kommandon eller Wayfire-IPC
+  (t.ex. scale-översikten)
+
+Allt via `~/.config/waydock/config.json` (live-omladdning) **eller**
+settings-GUI:t — högerklicka på tom dockyta → Inställningar…
+
 - Config: `~/.config/waydock/config.json` (skapas automatiskt första starten)
 - Djupare docs: [`doc/plan.md`](doc/plan.md),
   [`doc/architecture.md`](doc/architecture.md),
diff --git a/assets/screenshots/gallery.png b/assets/screenshots/gallery.png
new file mode 100644
index 0000000..e937306
Binary files /dev/null and b/assets/screenshots/gallery.png differ
diff --git a/doc/usage.md b/doc/usage.md
index a19ce02..640e45f 100644
--- a/doc/usage.md
+++ b/doc/usage.md
@@ -45,6 +45,14 @@ inställningar; "Återställ skärmen till globalt" tar bort dem.
 
 ## Configreferens (`config.json`)
 
+I korthet kan du styra: **placering** (kant, justering, ö/expanderad,
+marginaler), **utseende** (färger, transparens, radie, skugga, ikoner,
+indikatorer, animationer), **beteende** (klick/mittklick/skroll,
+gruppering, fönsterlistans öppning och hover-effekt), **menyinnehåll**,
+**specialknappar**, **per-skärm-överridar**, **autohide/dodge**,
+**hotspots** och **loggning**. Exempelgalleri med färdiga teman finns i
+[wikin](https://gitea.brasse-pc.eu/brasse/waydock/wiki/Konfiguration).
+
 ```jsonc
 {
   "position": "bottom",        // bottom | top | left | right