docs: update CHANGELOG and README for settings consolidation

CHANGELOG.md

@@ -3,6 +3,7 @@
 ## v0.2.0 (2026-04-08)
 
 ### Features
+- **Server-side settings consolidation** -- all display preferences (font size, grid columns, hover delay, view mode, device badges, hover preview, activity indicator, grid view mode, sidebar state) moved from browser localStorage to server-side `settings.json`; settings now survive browser clears and are consistent per-server
 - **Federation session deletion** -- kill sessions on remote devices from any muxplex client
 - **Session creation error reporting** -- replaced fire-and-forget subprocess with async process that checks exit codes, surfaces stderr, and pre-flight checks the command binary on PATH
 - **TTY-attach resilience** -- session commands that exit non-zero but still create the tmux session (e.g. `amplifier-workspace` which tries to attach after create) are detected and treated as success

README.md

@@ -244,6 +244,16 @@ All settings are stored in `~/.config/muxplex/settings.json`.
 | `multi_device_enabled` | `false` | Enable multi-instance federation |
 | `tls_cert` | `""` | Path to TLS certificate file (empty = HTTP) |
 | `tls_key` | `""` | Path to TLS private key file (empty = HTTP) |
+| `fontSize` | `14` | Terminal and tile preview font size (px) |
+| `hoverPreviewDelay` | `1500` | Hover preview popup delay (ms) |
+| `gridColumns` | `"auto"` | Number of grid columns (`"auto"` or integer) |
+| `bellSound` | `false` | Play audio sound on terminal bell |
+| `viewMode` | `"auto"` | Grid tile sizing: `auto` or `fit` |
+| `showDeviceBadges` | `true` | Show device name labels on tiles |
+| `showHoverPreview` | `true` | Show hover preview popover on tile hover |
+| `activityIndicator` | `"both"` | Activity style: `none`, `glow`, `dot`, `both` |
+| `gridViewMode` | `"flat"` | Multi-device grid layout: `flat`, `grouped`, `filtered` |
+| `sidebarOpen` | `null` | Sidebar state: `true`, `false`, or `null` (auto-detect from screen width) |
 
 **Priority:** CLI flags > `settings.json` > defaults.
 

pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "muxplex"
-version = "0.2.0"
+version = "0.2.1"
 description = "Web-based tmux session dashboard — access all your tmux sessions from any browser"
 readme = "README.md"
 license = { text = "MIT" }