Bubble Skill

Overview

Quick Install

curl -sSL https://canifi.com/skills/bubble/install.sh | bash

cp -r skills/bubble ~/.canifi/skills/

Setup

# First, ensure canifi-env is installed:
# curl -sSL https://canifi.com/install.sh | bash

canifi-env set BUBBLE_EMAIL "your-email@example.com"
canifi-env set BUBBLE_PASSWORD "your-password"

Privacy & Authentication

Option 1: Manual Browser Login (Recommended)

1. Complete the Browser Automation Setup using CDP mode
2. Login to the service manually in the Playwright-controlled Chrome window
3. Claude will use your authenticated session without ever seeing your password

Option 2: Environment Variables

canifi-env set SERVICE_EMAIL "your-email"
canifi-env set SERVICE_PASSWORD "your-password"

Capabilities

• Edit application pages and elements
• Manage database records
• Configure workflows and logic
• View application logs and analytics
• Deploy to development and production
• Manage user data and settings

Usage Examples

Example 1: Update Database

User: "Add a new user role to my Bubble app database"
Claude: I'll add the new role.
1. Opening Bubble via Playwright MCP
2. Navigating to your app's data tab
3. Opening the User data type
4. Adding new field for role
5. Saving database changes

Example 2: Deploy to Production

User: "Deploy my app changes to live"
Claude: I'll deploy your application.
1. Opening your Bubble app
2. Clicking deployment menu
3. Selecting deploy to live
4. Confirming deployment
5. Verifying live app is updated

Example 3: Check App Logs

User: "Show me recent error logs from my app"
Claude: I'll retrieve error logs.
1. Opening your Bubble app
2. Navigating to logs section
3. Filtering for errors
4. Listing recent issues
5. Summarizing error patterns

Authentication Flow

1. Navigate to bubble.io via Playwright MCP
2. Click "Log in" and enter email
3. Enter password
4. Handle SSO if configured
5. Complete 2FA if required (via iMessage)

Error Handling

• Login Failed: Retry up to 3 times, notify via iMessage
• Session Expired: Re-authenticate automatically
• Rate Limited: Implement exponential backoff
• 2FA Required: Send iMessage notification
• Deploy Failed: Check for workflow errors
• Database Error: Verify data type constraints

Self-Improvement Instructions

1. Document new element types
2. Update workflow action patterns
3. Track database feature changes
4. Log plugin integration updates

Notes

• Bubble is powerful but has learning curve
• Performance depends on app optimization
• Plugins extend functionality
• Separate dev and live environments
• API connector for external services