docs: update README and website with GIF demos and improvements

- Replace static screenshots with animated GIF demos in README and website
- Change 'Screenshots' section to 'Demos' for accuracy
- Remove redundant 'User Experience' section from README
- Add unified demos section to website with side-by-side layout
- Reorganize quickstart section: Desktop App first, then TUI
- Add comprehensive quickstart instructions with prerequisites and first-run notes
- Update tag format from v0.3.0 to tui-v0.3.0 in README
- Add release process documentation to CONTRIBUTING.md
- Add subtle dark grey grid accent pattern to website background
- Change arrow indicators from teal to white for better visibility
- Ensure consistent ordering (Desktop App first) across all sections

Author: hate

CHANGELOG.md

@@ -51,7 +51,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 [0.1.0]: https://github.com/hate/keyless/releases/tag/v0.1.0
 
-## [0.3.0] - 2025-11-11
+## [0.3.0] - 2025-11-12
 
 ### Added
 

CONTRIBUTING.md

@@ -222,6 +222,59 @@ fn test_file_write() -> Result<(), Box<dyn std::error::Error>> {
 
 ---
 
+## Releases
+
+Releases are automated via GitHub Actions workflows that trigger on git tags.
+
+### Release Types
+
+- **TUI releases**: Tag format `tui-v*` (e.g., `tui-v0.3.0`)
+- **Desktop releases**: Tag format `desktop-v*` (e.g., `desktop-v0.3.0`)
+
+### Creating a Release
+
+1. **Update versions** in all relevant files:
+   - `Cargo.toml` (workspace version)
+   - `keyless-desktop/src-tauri/Cargo.toml` (desktop package version)
+   - `keyless-desktop/src-tauri/tauri.conf.json` (desktop app version)
+
+2. **Update CHANGELOG.md** with the new version and changes
+
+3. **Commit version changes**:
+   ```bash
+   git add Cargo.toml keyless-desktop/src-tauri/Cargo.toml keyless-desktop/src-tauri/tauri.conf.json CHANGELOG.md
+   git commit -m "chore: bump version to X.Y.Z"
+   ```
+
+4. **Create and push the tag**:
+   ```bash
+   # For TUI release
+   git tag tui-v0.3.0
+   git push origin tui-v0.3.0
+   
+   # For Desktop release
+   git tag desktop-v0.3.0
+   git push origin desktop-v0.3.0
+   
+   # Or both
+   git tag tui-v0.3.0 desktop-v0.3.0
+   git push origin tui-v0.3.0 desktop-v0.3.0
+   ```
+
+5. **GitHub Actions will automatically**:
+   - Build binaries/installers for all platforms
+   - Create a GitHub Release with artifacts attached
+   - Use the tag name as the release name
+
+### Versioning
+
+We follow [Semantic Versioning](https://semver.org/):
+- **MAJOR** (X.0.0): Breaking changes
+- **MINOR** (0.X.0): New features, backwards compatible
+- **PATCH** (0.0.X): Bug fixes, backwards compatible
+
+---
+
 ## License
 
 By contributing, you agree that your contributions will be licensed under the MIT License.

README.md

@@ -57,36 +57,6 @@ The goal is a tool you can trust: local and no accounts. Choose the interface th
 - High-quality resampling via rubato (supports all device sample rates)
 - Auto mic rate (device default; prefers 48 kHz; caps high rates)
 
-**User Experience**
-
-**TUI (Terminal):**
-- Phased, non-blocking startup with a responsive terminal interface
-- Loading overlay with granular Whisper steps; press [esc] to cancel
-- Resumable model downloads with progress; press [esc] to pause, [backspace] to cancel (deletes partial)
-- Clear live info panel while dictating: mic, sink, time (session), model, language, words (session)
-- Config screen shows lifetime counters: total words and total talk time (persisted)
-- Audio feedback: gentle beeps on PTT press/release and successful transcription delivery
-
-**Desktop App (Beta)** 🎉
-- **Native desktop application** built with Tauri v2 + React + TypeScript
-  - Modern, responsive UI with smooth animations
-  - System tray integration with quick access menu
-  - Full feature parity with TUI version
-- **Listening Pill Overlay**: Bottom-center indicator with animated EQ bars showing real-time audio levels and VAD state
-  - **Toast Notifications**: Top-right notifications displaying transcription results
-    - Shows real-time preview text while speaking
-    - Displays final transcription with word count and output destination (paste/clipboard/file) after PTT release
-    - Sink branding flashes in background on final delivery
-- Always-on-top, non-intrusive overlays with smooth animations
-- **Comprehensive settings UI**
-  - General, AI, and VAD settings with real-time persistence
-  - Model management with download progress tracking
-  - Onboarding flow for first-time users
-- **System integration**
-  - macOS/Windows/Linux support
-  - Microphone and accessibility permission handling
-  - Configurable hotkeys (control+option, control+shift)
-
 ## 🚀 Quick Start
 
 ### Desktop App (Beta) 🎉
@@ -151,7 +121,7 @@ cargo build --release
 cargo install --git https://github.com/hate/keyless --package keyless --locked
 
 # Or pin a release tag
-cargo install --git https://github.com/hate/keyless --tag v0.3.0 --package keyless --locked
+cargo install --git https://github.com/hate/keyless --tag tui-v0.3.0 --package keyless --locked
 
 # Update existing install
 cargo install --git https://github.com/hate/keyless --package keyless --locked --force
@@ -166,16 +136,15 @@ Note: CUDA is an optional feature flag on the same install; use `--features cuda
 **First run:** Downloads Whisper model 
 **Usage:** Press Control+Option (configurable) to start dictating
 
-## 📸 Screenshots
+## 📸 Demos
 
-**TUI (Terminal) Version:**
-- **Configuration View:** Model selection, output mode, and settings
-- **Running View:** Real-time transcription with EQ visualization
+**Desktop App (Beta):**
 
-![Configuration screen](assets/config.png)
-![Transcription demo](assets/transcribe.png)
+![Desktop app demo](assets/keylessDESKTOP.gif)
+
+**TUI (Terminal) Version:**
 
-**Desktop App:** See the [Desktop App Guide](keyless-desktop/README.md) for screenshots and UI details.
+![TUI demo](assets/keylessTUI.gif)
 
 ## 🔧 How It Works