Skippable Home Assistant first-run setup wizard + global HA connection status indicator #8
Description
Home Assistant is expected to be the primary (and initially the only) external service supported by Edge Mining. Since the HA connection is fundamental for core features (energy monitoring, miner control via smart plugs, etc.), we should guide users to connect HA as the first step when opening Edge Mining for the first time.
At the same time, this setup must be skippable so users can explore the UI without configuring anything yet.
In addition, the UI should always expose a clear, global indication of whether Home Assistant is connected or not (green/red), with quick access to connection details.
Proposal
1) First-run wizard (skippable)
On first launch (or whenever Home Assistant is not configured), show a lightweight onboarding wizard with two clear options:
- Connect Home Assistant (Recommended) (primary CTA)
- Explore / Skip for now (secondary CTA)
Wizard step (minimal):
- Home Assistant URL
- Long-lived access token
- Test connection button + clear success/failure feedback
If the user skips:
- The app remains navigable (explore mode)
- Features that require HA should display a clear “not connected” state
- A persistent entry point to connect HA later must remain available
2) Global HA connection status indicator (bottom-right)
Add a small connection status indicator in the bottom-right corner (global, always visible):
- Green = HA connected
- Red = HA disconnected / not configured
Interaction:
- On click (and optionally on hover), show a small status popover with at least:
- Home Assistant: Connected / Disconnected + optional last check timestamp
- A shortcut button: Open Home Assistant settings / Connect now
Note: We can later extend the popover to also list other adapters (Miner Controllers, Energy Monitors, Forecast Providers), but this sub-issue focuses on Home Assistant first.