Bubble Web App Version History Badge

WHAT IT DOES

Bubble Web App Version History Badge automatically scans Bubble app editor and deployment pages to extract comprehensive version history data including version numbers, deployment timestamps, deployment status (Live, Deployed, Draft, Pending, Failed, Success, Archived), and change descriptions. The tool displays a floating overlay panel showing a summary of version history with color-coded indicators—green for Live/Success, blue for Deployed, yellow for Pending, gray for Draft, red for Failed, and dark gray for Archived. Summary statistics show total versions, latest version number, and live deployments count. Each history entry displays the version number, timestamp, status badge, change description, and author when available. The latest version is highlighted with a star icon and green border. Quick stats show unique versions and the latest status. This provides a complete, organized view of your Bubble app version history.

WHERE IT RUNS

This extension operates exclusively on bubble.io domain pages that contain app editor and deployment content—specifically pages with "/editor", "/deploy", "/app", or "/version" in the URL path, or pages that display version history and deployment information. It works alongside the free BotGentz companion extension, which provides the necessary DOM access and page interaction capabilities. The version history badge runs entirely within your local browser instance and does not communicate with any external servers or APIs. All version data extraction, status tracking, and preference storage are processed and stored on your machine, ensuring your app data and tracking preferences remain private. It supports all modern Chromium-based browsers (Chrome, Edge, Brave, Opera) and Firefox when paired with the BotGentz bridge.

HOW TO USE

After installing both BotGentz and this version history badge, navigate to any Bubble app editor or deployment page. Within 1-2 seconds, a panel appears in the bottom-right corner displaying a summary with total versions, latest version, and live deployments. The "History" section lists each version entry with its version number, timestamp, status badge (color-coded), change description, and author when available. The latest version is highlighted with a star icon. Quick stats show unique versions and the latest status. The panel provides a complete, organized view of your version history and helps you track deployment progress.

VERSION HISTORY DATA EXTRACTION AND STATUS TRACKING

The version history badge uses a multi-strategy extraction system to locate and parse version data from Bubble pages. It first attempts to find structured version elements using selectors based on the site's typical class naming patterns, including "version-item," "version-row," "deployment-item," and "history-item." When these selectors fail due to site updates, the tool falls back to text-based parsing, scanning the page for version-related patterns using pattern matching for version numbers, date formats, and status labels. Version numbers are extracted through pattern matching for "v" or "version" labels with numeric values. Timestamps are extracted through pattern matching for date formats or "ago" patterns. Deployment status is determined through keyword detection for "Live," "Deployed," "Draft," "Pending," "Failed," "Success," or "Archived." The latest version is identified through keyword detection for "latest" or "current" or class name checks. Change descriptions are extracted through pattern matching for "description:" or "change:" labels. Authors are extracted through pattern matching for "by" or "deployed by" labels. All data is presented in a clean, organized panel with color-coded indicators.

THE PANEL

The version history badge panel is a compact, functional overlay that integrates into the Bubble editor page. It can be dragged by clicking and holding the title bar, positioning the panel anywhere on the screen for optimal visibility while you track versions. The panel includes a built-in snap feature that automatically aligns to the nearest screen edge when released within 48 pixels, keeping your workspace organized. Click the collapse arrow in the top-right corner to minimize the panel to a small icon bubble showing a gear emoji, preserving screen space while keeping the tool accessible. The panel is not resizable in this version, maintaining a consistent compact size that works on all screen resolutions. Press the Escape key to instantly hide the panel; press Escape again to restore it. All position, collapse state, and version tracking preferences are saved locally using GM_setValue and persist across browsing sessions.

PLEASE NOTE

This extension requires the free BotGentz extension to function—the version history badge does not work standalone. Bubble occasionally updates its page layouts and version history presentation formats, which may temporarily affect version data extraction accuracy. The tool extracts version data from the visible page content; if version history is loaded dynamically after page load, you may need to wait a moment or refresh the page for the panel to populate. Version numbers and statuses are extracted from the page and are for reference only—always verify your version history on the official Bubble platform. The tool does not store or transmit any data; all version data extraction, status tracking, and settings are processed and saved entirely within your browser. This tool is designed for personal app development tracking and is not affiliated with or endorsed by Bubble or its parent company. Version history data is subject to Bubble's terms; always review your official Bubble account for authoritative app version information.