boWave/CHANGES_SUMMARY.md

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.