docs: add Ukrainian quick-start README

README.md

@@ -5,7 +5,7 @@ Lives in the system tray. Detects when you start typing in the wrong
 layout, switches it, and retypes the last word — like a friendly
 poltergeist that haunts your keyboard.
 
-> 🌐 [Español](README.es.md)
+> 🌐 [Español](README.es.md) · [Українська](README.uk.md)
 
 ![Typing "ma;ana" with the wrong layout active: PolterType switches the layout and retypes it as "mañana", and the rest of the sentence comes out right as typed](docs/screenshots/demo.gif)
 

README.uk.md

@@ -0,0 +1,33 @@
+# PolterType
+
+Кросплатформовий автоматичний перемикач розкладки клавіатури. Працює в
+системному треї, помічає, коли ви починаєте друкувати в неправильній розкладці,
+перемикає її та повторює останнє слово — ніби доброзичливий полтергейст у вашій
+клавіатурі.
+
+Повну документацію, нотатки для розробників і докладні застереження дивіться в
+[англійському README](README.md).
+
+## Встановлення
+
+Бінарники публікуються на [сторінці Releases](../../releases). Кожен реліз
+містить чотири інсталятори:
+
+| Система | Файл | Як встановити |
+| --- | --- | --- |
+| Windows 10 / 11 | `poltertype-<ver>-x86_64-pc-windows-msvc.msi` | Подвійне натискання. Встановлення для користувача, без прав адміністратора та UAC. SmartScreen може показати «Windows захистив ваш ПК» → **Додатково** → **Виконати все одно**. |
+| macOS 11+ (Intel та Apple Silicon) | `poltertype-<ver>-universal-apple-darwin.dmg` | Відкрийте DMG і перетягніть `poltertype.app` у `/Applications`. Під час першого запуску клацніть правою кнопкою → **Відкрити** (або виконайте `xattr -dr com.apple.quarantine /Applications/poltertype.app`). Потім надайте **Спеціальні можливості** та **Моніторинг введення**, коли macOS попросить. |
+| Linux (x86_64) | `poltertype-<ver>-x86_64.AppImage` | `chmod +x` і запустіть. Встановлення для користувача, без системного встановлення. Дивіться [docs/PERMISSIONS.md](docs/PERMISSIONS.md) для доступу `evdev` у Wayland. |
+| Linux (aarch64) | `poltertype-<ver>-aarch64.AppImage` | Як вище, для ARM64: Raspberry Pi 5, Asahi, ноутбуки та сервери ARM. |
+
+> Інсталятори поки що **не підписані**, тому Gatekeeper або SmartScreen
+> попереджають під час першого запуску. Підпис коду з’явиться на пізнішому етапі.
+
+> **Flatpak немає і не буде.** PolterType записує у `/dev/uinput`, на що жоден
+> дозвіл Flatpak не дає права, окрім `--device=all` (усе дерево пристроїв), і для
+> цього не існує порталу. Перемикання розкладки також потребує системних
+> бінарників (`hyprctl`, `gsettings`, `qdbus`, `ibus`), яких у пісочниці немає.
+> Використовуйте AppImage або нативний пакет.
+
+Збірку з вихідного коду описано в
+[CONTRIBUTING.md](CONTRIBUTING.md).