Feat/UI vite

PenguinWave/README.md

@@ -1,7 +1,65 @@
-# Tauri + React + Typescript
+# PenguinWave
 
-This template should help get you started developing with Tauri, React and Typescript in Vite.
+PipeWire virtual-sink manager for Linux gamers. Route per-app audio between virtual sinks and drive your headset's ChatMix wheel from one place.
 
-## Recommended IDE Setup
+> v0.1 — desktop-only, Linux-only. Tested on Arch (CachyOS).
 
-- [VS Code](https://code.visualstudio.com/) + [Tauri](https://marketplace.visualstudio.com/items?itemName=tauri-apps.tauri-vscode) + [rust-analyzer](https://marketplace.visualstudio.com/items?itemName=rust-lang.rust-analyzer)
+## What it does
+
+- **Virtual sinks**: creates `game_sink` + `chat_sink` on first launch; lets you create / delete more.
+- **Per-app routing**: drag-and-drop applications between sinks, or pick from a dropdown.
+- **Per-stream volume + mute**: real `pactl set-sink-input-volume` / `set-sink-input-mute`, debounced sliders.
+- **ChatMix wheel integration**: turn your headset wheel, watch the slider move and the game/chat sink volumes flip live.
+- **Port linking**: a power-user panel to wire any source output port to any target input port (`pw-link`).
+- **Friendlier stream names**: falls back from `application.name` to `application.process.binary` to `/proc/<pid>/cmdline` to a `media.role`-based hybrid label. Rename anything inline (persisted to `localStorage`).
+
+## Supported headsets (v0.1)
+
+- SteelSeries Arctis Nova 7
+
+Adding more is a matter of implementing `DeviceTrait` in `src-tauri/src/headsets/` and registering it in `AppStateManager::initialize_supported_devices`.
+
+## Requirements
+
+- **PipeWire** userland: `pactl`, `pw-cli`, `pw-link` on PATH (Debian/Ubuntu: `pipewire pipewire-pulse pipewire-cli`; Arch: `pipewire pipewire-pulse wireplumber`).
+- **Linux** only — uses `/proc` and HID via `hidapi`.
+- HID device permissions for headset access (udev rules typically grant via `plugdev` / `input` group).
+
+## Install (from source)
+
+```bash
+git clone <repo> penguinwave
+cd penguinwave
+npm install
+npm run tauri:build
+# .deb / AppImage ends up in src-tauri/target/release/bundle/
+```
+
+## Run in dev
+
+```bash
+npm run tauri:debug   # full app, RUST_BACKTRACE=full RUST_LOG=debug
+npm run dev           # frontend only on http://localhost:1420 (no Tauri commands)
+```
+
+## Architecture
+
+```
+React (Vite)  ──invoke──▶  Tauri 2 commands  ──shell out──▶  pactl / pw-cli / pw-link
+     ▲                            │                                    │
+     │                            ▼                                    ▼
+   listen()  ◀──emit─────  chatmix poll thread (100ms)  ◀──HID──  hidapi
+```
+
+- Frontend: React 18, TanStack Query 5, wouter, Radix + shadcn/ui (style "new-york"), Tailwind 3.
+- Backend: Rust edition 2021, Tauri 2, `hidapi`, `anyhow`/`thiserror`.
+
+## Project layout
+
+- `src/` — React frontend (pages, components, hooks, queries, types).
+- `src-tauri/` — Rust crate (`controllers/`, `system/pipewire.rs`, `event/chatmix_listener.rs`, `headsets/`, `utils/`).
+- `shared/` — vestigial Drizzle schema (not wired up).
+
+## License
+
+TBD.

PenguinWave/RunConfigurations/RunDevServer.run.xml

@@ -5,7 +5,7 @@
     <scripts>
       <script value="dev" />
     </scripts>
-    <node-interpreter value="project" />
+    <node-interpreter value="$USER_HOME$/.nvm/versions/node/v24.16.0/bin/node" />
     <envs />
     <method v="2" />
   </configuration>

PenguinWave/RunConfigurations/RunTauriApp.run.xml

@@ -3,7 +3,9 @@
     <option name="buildProfileId" value="dev" />
     <option name="command" value="run --no-default-features" />
     <option name="workingDirectory" value="file://$PROJECT_DIR$/src-tauri" />
-    <envs />
+    <envs>
+      <env name="RUST_BACKTRACE" value="full" />
+    </envs>
     <option name="emulateTerminal" value="true" />
     <option name="channel" value="DEFAULT" />
     <option name="requiredFeatures" value="true" />

PenguinWave/components.json

@@ -0,0 +1,20 @@
+{
+    "$schema": "https://ui.shadcn.com/schema.json",
+    "style": "new-york",
+    "rsc": false,
+    "tsx": true,
+    "tailwind": {
+      "config": "tailwind.config.ts",
+      "css": "src/index.css",
+      "baseColor": "neutral",
+      "cssVariables": true,
+      "prefix": ""
+    },
+    "aliases": {
+      "components": "@/components",
+      "utils": "@/lib/utils",
+      "ui": "@/components/ui",
+      "lib": "@/lib",
+      "hooks": "@/hooks"
+    }
+}

PenguinWave/index.html

@@ -3,10 +3,10 @@
   <head>
     <meta charset="UTF-8" />
     <link rel="icon" type="image/svg+xml" href="/vite.svg" />
-    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
-    <title>Tauri + React + Typescript</title>
+    <meta name="viewport" content="width=device-width, initial-scale=1.0, maximum-scale=1" />
+    <title>PenguinWave</title>
+    <meta name="description" content="PipeWire virtual-sink manager. Route per-app audio between sinks and drive your headset's ChatMix wheel." />
   </head>
-
   <body>
     <div id="root"></div>
     <script type="module" src="/src/main.tsx"></script>