39 lines
2.4 KiB
Markdown
39 lines
2.4 KiB
Markdown
# boWave Project Updates & Fixes
|
|
|
|
This document summarizes the changes made to the boWave project to improve NMEA 2000 data visibility, dashboard aesthetics, and Windows compatibility.
|
|
|
|
## 🚀 Key Improvements
|
|
|
|
### 1. Unified Dashboard Access (Port 8090)
|
|
- **Problem:** Accessing different services required multiple ports (3000, 1780, 6680, etc.), causing CORS and firewall issues.
|
|
- **Solution:** Configured Nginx and Vite proxies to tunnel all backend services through the main dashboard port (8090).
|
|
- **Paths:**
|
|
- SignalK: `/signalk`
|
|
- Snapcast: `/snapcast-ws`
|
|
- Mopidy: `/mopidy`
|
|
- Jellyfin: `/jellyfin`
|
|
|
|
### 2. "Ship Control" Dashboard Design
|
|
- **New UI:** Implemented a minimalist, high-end yacht aesthetic based on provided photo references.
|
|
- **BoatControl Component:** Added a central interactive boat profile with circular category icons (Lights, Climate, Nav, Music, Energy).
|
|
- **FloorPlan Component:** Created a visual deck plan for controlling lighting and climate in specific zones (Salon, Cabins, etc.).
|
|
- **Central Instrument:** Added a floating gauge over the boat for immediate SOG and Heading monitoring.
|
|
|
|
### 3. NMEA 2000 Data Fixes
|
|
- **SignalK Proxy:** Fixed a bug in the API router that prevented listeners from re-attaching when switching from real to mock data.
|
|
- **Auto-Fallback:** The dashboard now waits 5 seconds for real SignalK data; if none is received, it automatically starts the mock data stream so the dashboard never looks "empty".
|
|
|
|
### 4. Windows Compatibility & Ease of Use
|
|
- **Self-Healing Pipes:** Named pipes (`.pcm` files) are now created automatically inside the Docker containers during startup. No more manual `mkfifo` needed on the host.
|
|
- **Batch Scripts:** Added `dev.bat` and `stop.bat` for Windows users who don't have `make` installed.
|
|
- **Docker Fixes:** Corrected `librespot` execution errors by using the official image and proper command list formatting.
|
|
|
|
### 5. Audio System Enhancements
|
|
- **Spotify & AirPlay Visibility:** Added these services to the health check monitor and updated the `useZones` hook to track their stream status via Snapcast.
|
|
- **Unified API:** The `createApi` factory now automatically uses the dashboard host, making it fully portable across different network setups.
|
|
|
|
## 🛠️ How to start (Windows)
|
|
1. Ensure Docker Desktop is running.
|
|
2. Run `.\dev.bat` in the project root.
|
|
3. Open **http://localhost:8090** in your browser.
|