k-flow-card is a specialized Home Assistant Lovelace card designed to visualize real-time energy flow for solar-plus-storage systems. It sits within a crowded landscape of energy monitoring solutions, where most cards focus on static dashboards or single metrics. Unlike generic energy monitors, k-flow-card emphasizes dynamic, animated visuals—tracking solar generation, battery charging/discharging, grid interactions, and even electric vehicle charging on a single moving diagram. This approach shifts energy tracking from numbers on a screen to a choreographed narrative of power movement, which could appeal to users who want to intuitively grasp system behavior without parsing individual sensor values.

The card’s differentiation lies in its focus on specific hardware integrations and visual storytelling. It’s built for GoodWe solar inverters paired with JK BMS batteries, a niche combination that many other cards might not support. The S-curve flow paths and sun-tracking animation aren’t just decorative; they map to real-time data from sun.sun and battery telemetry, creating a living visualization that reflects actual energy transitions. Dual battery support and EV charger integration are also unique in this space, though these features require compatible hardware. The absence of YAML configuration—a common pain point in Lovelace cards—stands out too. Users configure everything through a visual editor, which simplifies setup but may limit advanced customization compared to YAML-driven alternatives.

Trade-offs emerge when comparing k-flow-card to simpler or more generalized tools. The animations and real-time updates demand more processing power than static cards, which could affect performance on less powerful devices. While the card is self-contained (no external dependencies beyond HACS), its reliance on specific entity names like goodwe_pv1_power or jk_soc means it won’t work out-of-the-box for users without those exact integrations. The color logic, though detailed (SOC thresholds, cell temperature ranges), is hardcoded and tied to the card’s design, leaving little room for customization without modifying the code. For users prioritizing flexibility or broader compatibility, this might be a limitation.

What it ships with is a comprehensive feature set tailored for solar-plus-storage monitoring. The core includes animated flow paths, live sun positioning, and a dual-battery layout. Additional features cover EV charger state tracking, system limits (inverter and PV caps), and granular battery telemetry like cell temperatures and voltages. The visual editor lets users toggle sections (e.g., hiding secondary batteries or EV nodes) without touching YAML, and customizable labels allow renaming stat tiles with entity overrides. Notably, it includes a limitations panel showing battery capacity, inverter max power, and PV generation totals, which adds context beyond raw numbers. The color coding—red/orange/green thresholds for SOC, temperature, and voltage—provides instant visual warnings, though users might need to adjust thresholds if their setup differs from the defaults.

If you want to try it, the project requires Home Assistant with specific integrations: a GoodWe inverter (using the official or community integration) and a JK BMS battery (via Bluetooth or other supported method). A basic understanding of Lovelace card configuration is helpful, even though the card avoids YAML. The card’s self-contained nature means installation is straightforward via HACS or manual upload, but users must ensure their entity names match those in the README (e.g., sensor.goodwe_pv1_power). For setup, the README provides clear steps, though it skips detailed commands in favor of HACS or manual folder placement.

The source is on k-flow-card.