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/

   
   
   With HACS (Recommended)

   
   

   This method allows you to get updates directly on the Home Assistant Community Store

   • If HACS is not installed yet, download it following the instructions on https://hacs.xyz/docs/setup/download/
   • Proceed to the HACS initial configuration following the instructions on https://hacs.xyz/docs/configuration/basic
   • On your sidebar go to "HACS"
   • Search for "Bubble Card Tools", or click on the blue button below
   • Click on "Download"

   

2. Restart Home Assistant then 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!