Bug and Feature Reporting

The Dreame Vacuum Card operates as part of the dreame_vacuum Home Assistant integration and does not maintain a separate repository. All bug reports, feature requests and discussions go to the main integration repository.

Issue Titles

Issue titles must clearly indicate relation to the Dreame Vacuum Card, such as [Card] Map is not loading. This distinguishes card-specific issues from general integration issues.

Check for Updates

Checking HACS ensures the absolute latest version of the dreame_vacuum integration is running before opening an issue. A reported bug or requested feature might already exist in a recent release.

Open an Issue on GitHub

Requesting a Feature

New feature ideas and improvements are always welcome.

A clear description of the idea, the reasoning behind its usefulness and the envisioned functionality is required. Mockups, sketches, or examples from other apps, such as the official Dreame app, facilitate visual or behavioral change requests.

Reporting a Bug

Providing clear and detailed information when unexpected behavior occurs accelerates the resolution process.

Visual Evidence

A full screenshot or screen recording showing the issue on the dashboard is required for this visual UI component.

Get Home Assistant Logs

Troubleshooting UI glitches, broken buttons, or loading failures requires reviewing the frontend errors happening behind the scenes. Home Assistant automatically captures and logs browser and frontend errors natively. These logs are retrieved directly from the Home Assistant system.

Capturing frontend logs from Home Assistant:

1. Reproducing the issue first, such as clicking the broken button or refreshing the page if the card fails to load, ensures the error is captured right before checking the logs.
2. Navigating to Settings, followed by System and then Logs in the Home Assistant sidebar.
3. Clicking the Download Full Log button at the bottom of the page saves the homeassistant.log file locally.
4. Using the Show full logs option or the overflow menu (three dots) in the top right displays the raw logs directly in the browser.
5. Filtering the downloaded log file, or copying the relevant error messages, prepares them for attachment to the GitHub issue.

Protect Sensitive Data

The full homeassistant.log file contains sensitive information, such as passwords, tokens, or personal identifiers from other integrations. Extracting and sharing only the parts related to frontend or dreame_vacuum protects this data. The entire log file should never be uploaded publicly without reviewing its contents.