Bubble Card Tools

Bubble Card Tools is a custom integration for Home Assistant that handles the Bubble Card backend. It adds a safe, local API that installs, edits, and removes Bubble Card modules as separated YAML files. It powers the Module Store and is required to manage modules from the UI. It is designed to grow with new features.

Installation

Requirements

• Home Assistant (recent stable)
• Bubble Card (v3.1.0 and up) installed

Without HACS

1. Copy the bubble_card_tools folder from custom_components/bubble_card_tools/ into /config/custom_components/
2. Restart Home Assistant

With HACS (Recommended)

This method allows you to get updates directly on the HACS main page

1. In HACS, go to the menu in the top right corner, then go to "Custom repositories" (it will soon be added natively in HACS).

   
   
   

2. Then add https://github.com/Clooos/Bubble-Card-Tools as the repository and select "Integration". After that, click on "Add".

   
   
   

3. Once it is added, click on "Cancel" next to the "Add" button.

   
   
   

4. Now search for "Bubble Card Tools" and click on it. Then finally, click on the "Download" button in the bottom right corner to install it.

   
   
   

5. Restart Home Assistant.
   
   

Important

This custom integration is still not available by default in HACS, so please follow the steps above to add the repository to HACS.

Configure in Home Assistant

1. Go to Settings → Devices & services → Add Integration
   or click on this button:
   
   

2. Search Bubble Card Tools and add it

3. The integration creates the base path:

   • Base: /config/bubble_card
   • Modules: /config/bubble_card/modules

4. You are all set! Just check in the editor (in Modules) if the warning has been removed.

Migration (if you used the old method)

• If legacy modules exist (sensor or bubble-modules.yaml), the migration will be made automatically
• Migration keeps legacy data untouched for safe rollback
• After migration, files become the single source

Troubleshooting

• After install, restart Home Assistant and add the integration
• If the UI says “Unknown command,” the integration is not loaded, check logs and folder paths
• For support, include HA version, logs, and steps to reproduce