User Onboarding for Bubble | BreakGround

User Onboarding for Bubble

BreakGround works in any Bubble app via a single script tag added through Bubble's SEO/metatags settings. No Bubble plugin, no API workflow, no custom JS action — just a snippet that runs in the browser.

BreakGround works on any Bubble plan that allows custom scripts in the page header (Personal plan and above). The SDK runs as a client-side script and doesn't interact with Bubble's database or API workflows, so it's safe to install without affecting existing logic. Bubble's single-page app architecture means guides persist correctly across page changes — they're detected via the History API.

How to set up

  1. Add to Settings → SEO/metatags: Open your Bubble app, navigate to Settings → SEO/metatags, and paste the snippet into the 'Script/meta tags in header' section.
  2. Identify users via custom workflow: Add a workflow on user login that runs JavaScript to call `BreakGround.identify` with the current user's data.
  3. Author guides on your live app: Open BreakGround, paste your Bubble app URL (the live one, not the editor), and AI generates the first guide.

Capabilities

  • Works on Personal plan and above: BreakGround installs through the standard Settings → SEO/metatags interface — no Bubble plugin required.
  • Single-page-app aware: Bubble's SPA architecture is handled correctly — guides targeting specific Bubble pages fire on the right page.
  • Doesn't conflict with Bubble workflows: BreakGround runs as an independent client script — your existing workflows, API calls, and database operations are untouched.
  • Custom workflow integration: Use Bubble's 'Run JavaScript' action to call BreakGround functions from any workflow — identify, track events, or trigger guides.

Frequently asked questions

Do I need to build a Bubble plugin to use BreakGround?

No. The standard install uses Bubble's Settings → SEO/metatags section, which allows arbitrary head scripts on Personal plan and above. There's no plugin to build or install.

Will BreakGround interfere with my Bubble workflows?

No. BreakGround runs as an independent client-side script and doesn't touch Bubble's workflow engine, database, or API. Your existing logic continues to work unchanged.

Does the integration affect pricing?

No. BreakGround prices on monthly active users (MAU), not by framework, integration, or site count. The integration is the same on every plan — including the free tier.