diff --git a/.github/CONTRIBUTING.md b/.github/CONTRIBUTING.md
index 8941b68..e45898e 100644
--- a/.github/CONTRIBUTING.md
+++ b/.github/CONTRIBUTING.md
@@ -44,7 +44,7 @@ wails3 task dev
 
 ## 🧪 Testing
 
-Before opening a PR, run the tests. See **[test/TESTING.md](../test/TESTING.md)** for full details.
+Before opening a PR, run the tests. See **[TESTING.md](./TESTING.md)** for full details.
 
 ```bash
 # Frontend tests (React/TypeScript, Vitest)
diff --git a/test/TESTING.md b/.github/TESTING.md
similarity index 100%
rename from test/TESTING.md
rename to .github/TESTING.md
diff --git a/README.md b/README.md
index 7120d0d..d734b35 100644
--- a/README.md
+++ b/README.md
@@ -14,7 +14,21 @@ Just a focused, native desktop tool for working with databases.
 
 ## ⬇️ Download
 
-Grab the latest build for **Windows**, **macOS**, or **Linux** from the [**Releases**](../../releases/latest) page - no installer, no account, just download and run.
+Grab the latest build for **Windows**, **macOS**, or **Linux** from the [**Releases**](../../releases/latest) page.
+
+### Recommended assets:
+- **Windows**: `XenSQL-windows-amd64.zip` (portable) **or** `XenSQL-amd64-installer.exe` (installer)
+- **Linux**: `XenSQL-linux-amd64.tar.gz` (portable)
+- **macOS**: `XenSQL-darwin-arm64.zip` **or** `XenSQL-darwin-amd64.zip` (universal `.app`)
+
+### Additional options:
+- **Windows**: `XenSQL.exe` (standalone)
+- **Linux**: `xensql-x86_64.AppImage`, `.deb`, `.rpm`, `.pkg.tar.zst`
+- **macOS**: `XenSQL-macos-universal.dmg`
+
+No account required - just download and run.
+
+Auto-update functionality works with the platform-specific `.zip`/`.tar.gz` assets listed above.
 
 Prefer to build it yourself? See **Installation & Development** below.
 
@@ -41,7 +55,8 @@ Work with **SQLite**, **PostgreSQL**, and **MySQL / MariaDB** in a single fast d
 🧳 Portable  
 ⚡ Fast startup  
 🔒 Local-first  
-🧠 Developer-focused
+🧠 Developer-focused  
+🔄 Auto-updating
 
 ---
 
@@ -53,6 +68,7 @@ Work with **SQLite**, **PostgreSQL**, and **MySQL / MariaDB** in a single fast d
 - Explore schemas instantly
 - Save and reuse queries
 - Export anything in one click
+- Auto-update with one click
 
 ---
 
@@ -202,6 +218,15 @@ View and modify table data directly in the grid - no hand-written `UPDATE` / `DE
 
 ---
 
+## 🔄 Auto Updates
+
+- Automatically checks for new versions on startup
+- Clean modal with changelog highlights
+- One-click download and update
+- Supports Windows (MSI), macOS, and Linux builds
+
+---
+
 ## 🌍 UX
 
 - **Dark & light** themes
@@ -209,6 +234,7 @@ View and modify table data directly in the grid - no hand-written `UPDATE` / `DE
 - **Quick Search palette** (`Ctrl+P`) - jump to connections, saved queries, history, tabs
 - Custom shortcuts editor + keyboard tips
 - Frameless native title bar
+- **Window state persistence** - size, position, and maximized state restored between sessions
 
 ---
 
@@ -294,13 +320,6 @@ wails3 dev
 
 ```bash
 wails3 task build       # or: wails3 task package  (platform bundle/installer)
-```
-
-Output:
-
-```text
-bin/XenSQL(.exe)        # bin/XenSQL.app on macOS
-```
 
 ---
 
@@ -316,8 +335,7 @@ bin/XenSQL(.exe)        # bin/XenSQL.app on macOS
 │   ├── storage/           # JSON persistence (incl. settings.json)
 │   ├── paths/             # Portable data directory
 │   └── service/           # SQL format, export helpers
-├── frontend/              # React + TypeScript + Monaco (Vitest tests)
-└── test/                  # TESTING.md - how to run all suites
+└── frontend/              # React + TypeScript + Monaco (Vitest tests)
 ```
 
 ---