@ziuus/vanta 0.10.0 → 0.10.5

package/README.md

@@ -152,6 +152,10 @@ Every key, on screen, on any page.
 | `<` `>` | Volume down / up |
 | `?` | Help overlay |
 | `q` | Quit |
+| `~` / `F12` | Toggle Debug Logs overlay (`s` saves them to file) |
+| `S` / `,` | Open Settings overlay |
+| `Ctrl + ←/→` | Resize dashboard columns horizontally (when focused) |
+| `Ctrl + ↑/↓` | Resize dashboard components vertically (when focused) |
 
 **Processes (Monitor):** `↑↓ PgUp PgDn Home End` select · `/` filter (`Enter` keeps, `Esc` clears) · `s` sort field · `r` reverse · `t` tree · `←→` fold · `c` full command · `k` SIGTERM · `K` SIGKILL (press twice to confirm, `x` cancels)
 
@@ -165,185 +169,35 @@ Every key, on screen, on any page.
 
 Cycle with `T` — your choice is written back to the config file.
 
-## Configuration
-
-`~/.config/vanta/config.toml`. Every key is optional; delete the file to reset.
-
-```toml
-[ui]
-refresh_rate = 0.5      # seconds between samples
-fps = 30                # render rate (animations)
-theme = "dark"
-startup_mode = "dashboard"
-clock_24h = true
-visualizer = "bars"     # bars | mirror | wave | peaks
-
-[widgets]               # all default to true
-cpu = true
-memory = true
-disk = true
-network = true
-gpu = true
-clock = true
-calendar = true
-music_viz = true
-processes = true
-media = true
-matrix = true
-video = true
-```
-
-## WASM Extensions (v0.10+)
-
-Vanta is extensible through runtime WASM extensions. You can install completely new UI panels and capabilities created by the community *without* recompiling Vanta.
-
-### 1. Discover Extensions
-Search the community registry (hosted via the [vanta-integrations](https://github.com/ziuus/vanta-integrations) repo):
-```bash
-vanta search
-```
-```text
-Vanta Extensions (API v0.9.1)
-
-  security     Vanta Security
-               Live CVE security feeds and threat monitoring.
-               v0.1.0 (API v0.9.0) by Community
-```
-
-### 2. Install & Verify
-Install an extension. Vanta will securely download the `.wasm` artifact, verify its **SHA-256 checksum**, check API compatibility, and place it in your local extensions folder:
-```bash
-vanta install security
-```
-
-> 🔒 **Security Notice**: Extensions are sandboxed by default. Currently, extensions are granted UI and Configuration access, but are denied Network, Filesystem, and Process execution capabilities.
-
-### 3. Enable in Config
-Enable the extension so Vanta loads it on startup:
-```bash
-vanta enable security
-```
-It will automatically append to the `enabled` array in your `~/.config/vanta/config.toml`. 
-
-Start Vanta (`vanta`) and the new panel will appear in your dashboard! 
-
-### Custom Pages (No Code Required)
-You can still build custom views natively with flexible grid layouts by defining `[[pages]]` in your config:
-
-```toml
-[[pages]]
-name = "DevOps"
-layout = [
-    ["system", "network"],
-    ["processes", "clock"]
-]
-```
-
-## Custom Widgets
-
-Add your own data panels to the Dashboard without recompiling Vanta.  
-Each `[[custom_widgets]]` entry in `config.toml` runs a command or reads a file in the background and displays the result.
-
-### Quick examples
-
-**Raspberry Pi voltage:**
-
-```toml
-[[custom_widgets]]
-id = "pi_voltage"
-title = "Pi Battery"
-source = "command"
-command = "vcgencmd measure_volts"
-renderer = "value"
-refresh = 2.0
-```
-
-**Raspberry Pi CPU temperature (millidegrees → degrees with min/max):**
-
-```toml
-[[custom_widgets]]
-id = "pi_temp"
-title = "CPU Temp"
-source = "command"
-command = "cat /sys/class/thermal/thermal_zone0/temp"
-renderer = "gauge"
-refresh = 2.0
-min = 0
-max = 100000
-unit = "m°C"
-```
-
-**Linux battery percentage (gauge renderer):**
-
-```toml
-[[custom_widgets]]
-id = "battery"
-title = "Battery"
-source = "file"
-path = "/sys/class/power_supply/BAT0/capacity"
-renderer = "gauge"
-refresh = 1.0
-min = 0
-max = 100
-```
-
-**Any shell command as plain text:**
-
-```toml
-[[custom_widgets]]
-id = "uptime_cmd"
-title = "Uptime"
-source = "command"
-command = "uptime -p"
-renderer = "text"
-refresh = 10.0
-```
-
-**Docker running containers:**
-
-```toml
-[[custom_widgets]]
-id = "docker_count"
-title = "Containers"
-source = "command"
-command = "docker ps -q"
-renderer = "text"
-refresh = 5.0
-```
-
-### All options
-
-| Key | Required | Default | Description |
-|-----|----------|---------|-------------|
-| `id` | ✓ | — | Unique identifier (used for focus/zoom). |
-| `title` | ✓ | — | Panel title shown in the border. |
-| `source` | — | `command` | `command` or `file`. |
-| `command` | when `source = "command"` | — | Command to run (supports quoted args; no shell). |
-| `path` | when `source = "file"` | — | File to read (e.g. `/sys/class/…`). |
-| `renderer` | — | `value` | `value` · `text` · `gauge` · `bar` · `graph`. |
-| `refresh` | — | `5.0` | Seconds between fetches (0.1 – 3600). |
-| `unit` | — | none | Unit suffix appended to `value` displays (e.g. `"V"`). |
-| `min` | — | `0` | Range minimum for `gauge` and `bar`. |
-| `max` | — | `100` | Range maximum for `gauge` and `bar`. |
-| `enabled` | — | `true` | Set `false` to hide without removing the entry. |
-
-### Renderers
-
-| Name | Shows |
-|------|-------|
-| `value` | Single value, centred and bold. Appends `unit` if set. |
-| `text` | Raw text output, word-wrapped. |
-| `gauge` | Horizontal bar `████░░ 82%` normalised to `min`/`max`. |
-| `bar` | Horizontal bar without percentage label. |
-| `graph` | Scrolling history graph using Vanta's block-character primitives. |
-
-### How it works
-
-- Each widget runs on its own background thread at its own `refresh` interval. The render loop (30 fps) only reads a cached result — it never blocks on I/O.
-- Commands are executed directly (no `sh -c`). Arguments with spaces can be quoted: `command = 'grep -r "error" /var/log'`.
-- Commands that hang are killed after 10 seconds. Crashed commands, missing files, and parse errors are shown as status messages (`Command failed`, `Unavailable`, `Invalid value`, `Timeout`, `Loading…`) — they never crash Vanta.
-- Custom widgets appear as a horizontal row at the bottom of the Dashboard page. They participate in normal Tab focus and Enter zoom like any built-in panel.
-- Set `VANTA_DEBUG=1` before running Vanta to see per-widget error messages on stderr.
+### Custom Themes
+
+You can easily load custom themes dynamically without recompiling Vanta.
+
+1. Create a `themes` folder inside your config directory (e.g. `~/.config/vanta/themes/`).
+2. Drop in a `.toml` file with your theme name (e.g., `cyberpunk.toml`).
+3. Define your colors using hex codes:
+   ```toml
+   bg = "#000000"
+   accent = "#00ff00"
+   secondary = "#ff00ff"
+   surface = "#111111"
+   text = "#ffffff"
+   dim = "#555555"
+   green = "#00ff00"
+   yellow = "#ffff00"
+   red = "#ff0000"
+   ```
+4. Press `T` in Vanta to cycle to it, or set it explicitly in your `config.toml` (`theme = "cyberpunk"`).
+
+## Configuration & Customization
+
+Vanta is highly configurable via `~/.config/vanta/config.toml`. You can:
+- Change the layout, refresh rates, and themes
+- Add your own **Custom Widgets** using shell commands or files
+- Install community-built **WASM Extensions** to add entirely new UI panels without recompiling
+
+For a complete guide to all configuration options, extensions, and custom widgets, please read:
+👉 **[docs/CONFIGURATION.md](docs/CONFIGURATION.md)**
 
 ## Architecture
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ziuus/vanta",
-  "version": "0.10.0",
+  "version": "0.10.5",
   "description": "Aesthetic Rust TUI system dashboard — CPU, memory, disk, network, GPU, processes, now-playing, clock, file manager, notes and visualizer in one terminal pane",
   "bin": {
     "vanta": "bin/vanta.js"