From 03033bf5c3894f531a41e27771442d15c2a5cef6 Mon Sep 17 00:00:00 2001
From: Samuel Onoja <samiodev@icloud.com>
Date: Fri, 25 Sep 2026 05:32:43 +0100
Subject: [PATCH] docs: explain glass preview workflow

---
 README.md | 12 ++++++++++++
 1 file changed, 12 insertions(+)

diff --git a/README.md b/README.md
index a527c66..16d3db0 100644
--- a/README.md
+++ b/README.md
@@ -39,6 +39,18 @@ cargo build -p ferese-effects-probe
 cargo run -p ferese -- --grant-effects -- target/debug/ferese-effects-probe
 ```
 
+Add `--preview` to keep a glass popover visible in the nested compositor:
+
+```bash
+cargo build -p ferese-effects-probe
+cargo run -p ferese -- --backend nested --grant-effects -- \
+  target/debug/ferese-effects-probe --preview
+```
+
+Press `Super+Enter` in the Ferese window to open `foot`, then move or update the
+terminal beneath the popover to see backdrop capture, blur, tint, and damage
+invalidation. Stop the preview with `Ctrl+C` in the host terminal.
+
 To verify that the private global is absent from the public Wayland socket:
 
 ```bash