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.

Requirements

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

Installation and configuration

1. Install Bubble Card Tools using one of the methods below

   Without HACS

   
   

   • Copy the bubble_card_tools folder from custom_components/bubble_card_tools/ into /config/custom_components/
   • Restart Home Assistant

   
   
   With HACS (Recommended)
   ℹ️ This custom integration is still not available by default in HACS, so please expand the steps above to add the repository to HACS.

   
   

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

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

     
     
     

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

     
     
     

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

     
     
     

   • 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.

     
     
     

   • Restart Home Assistant.
     
     

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

3. Search Bubble Card Tools and add it

4. The integration creates the base path:

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

5. 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
• If the migration haven't worked correctly, remove the /config/bubble_card folder then refresh the page and wait a bit.

Troubleshooting

• After install, restart Home Assistant and add the integration
• If the migration haven't worked correctly, remove the /config/bubble_card folder then refresh the page and wait a bit.
• 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

Donate

I dedicate most of my spare time to making this project the best it can be. So if you appreciate my work, any donation would be a great way to show your support 🍻

Thank you everyone for your support, you all are my greatest motivation!