diff --git a/README.md b/README.md
index 2978f86..fe7e337 100644
--- a/README.md
+++ b/README.md
@@ -1,9 +1,22 @@
# LazyRun — lazy shortcut build
+[](https://github.com/oxpoe/lazyrun/actions/workflows/ci.yml)
+[](https://github.com/oxpoe/lazyrun/releases/latest)
+[](LICENSE)
+
+
+
Desktop app (Go + Fyne) that creates application shortcuts on Linux in a few clicks:
from an executable file, or from a web URL as a PWA. Ships as a single-file
AppImage, no terminal needed.
+
+
+
+
+
+
+
- **Repo:**
- **Donate:**
@@ -39,6 +52,9 @@ AppImage, no terminal needed.
## Install
+Needs a desktop Linux with the usual GL/X11 or Wayland libraries (any KDE Plasma or
+GNOME install has them). No root, nothing outside your home directory.
+
Download the AppImage from [Releases](https://github.com/oxpoe/lazyrun/releases), then:
```bash
@@ -66,6 +82,12 @@ Keep it wherever you like (for example `~/.local/bin/`). Automatic updates need
| LazyRun metadata | `~/.config/lazyrun/shortcuts.json` |
Everything stays inside the home directory — no root, no system directories.
+
+The UI follows your system light/dark setting:
+
+
+
+
Filenames use a slug of the app name (`WhatsApp Web` → `whatsapp-web.desktop`);
the `Name=` field keeps the name you typed.
diff --git a/docs/dialog-executable.png b/docs/dialog-executable.png
new file mode 100644
index 0000000..5bba4b1
Binary files /dev/null and b/docs/dialog-executable.png differ
diff --git a/docs/dialog-icons.png b/docs/dialog-icons.png
new file mode 100644
index 0000000..0a4b80f
Binary files /dev/null and b/docs/dialog-icons.png differ
diff --git a/docs/main-dark.png b/docs/main-dark.png
new file mode 100644
index 0000000..e7a85fc
Binary files /dev/null and b/docs/main-dark.png differ
diff --git a/docs/main-light.png b/docs/main-light.png
new file mode 100644
index 0000000..eda3542
Binary files /dev/null and b/docs/main-light.png differ