What problem does it solve?
It solves the problem of keeping the frontend in sync with backend changes by streaming real-time events instead of relying on manual refreshes.
Core Features & Use Cases
- Real-time UI updates via SSE: Uses a single EventSource connection through
useServerEvents to receive server-sent events and update the application state indirectly.
- Query-driven consistency with TanStack Query: Reacts to incoming event names by invalidating specific query keys rather than writing to local stores.
- Typed, contract-based event propagation: Defines clear event contracts (playlists, download history, library stats, feed/release updates) and routes backend emission through a dedicated app event bus.
Quick Start
Use the spotiarr-sse Skill to add real-time playlist, download, library, and feed updates by wiring a new SSE event end-to-end using the defined bus and frontend query invalidation pattern.