Framer Web Publish History Overlay

WHAT IT DOES

Framer Web Publish History Overlay automatically scans Framer project pages and publish history to extract comprehensive version data including publish timestamp, version number, and deployment status (Live, Published, Draft, Pending, Failed, Success). The tool displays a floating overlay panel showing a summary of publish history with color-coded indicators—green for Live/Success, blue for Published, yellow for Pending, gray for Draft, and red for Failed. Summary statistics show total publishes, latest version number, and live deployments count. Each history entry displays the version number, timestamp, status badge, and description 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 Framer publish history.

WHERE IT RUNS

This extension operates exclusively on framer.com domain pages that contain project and publish history content—specifically pages with "/projects", "/project", "/publish", or "/editor" in the URL path, or pages that display project information and deployment history. It works alongside the free BotGentz companion extension, which provides the necessary DOM access and page interaction capabilities. The publish history overlay runs entirely within your local browser instance and does not communicate with any external servers or APIs. All publish data extraction, version tracking, and preference storage are processed and stored on your machine, ensuring your project 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 publish history overlay, navigate to any Framer project or publish page. Within 1-2 seconds, a panel appears in the bottom-right corner displaying a summary with total publishes, latest version, and live deployments. The "History" section lists each publish entry with its version number, timestamp, status badge (color-coded), and description 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 publish history and helps you track version deployments.

PUBLISH HISTORY DATA EXTRACTION AND VERSION TRACKING

The publish history overlay uses a multi-strategy extraction system to locate and parse publish data from Framer pages. It first attempts to find structured publish elements using selectors based on the site's typical class naming patterns, including "publish-item," "version-item," "history-item," and "deployment-item." When these selectors fail due to site updates, the tool falls back to text-based parsing, scanning the page for publish-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," "Published," "Draft," "Pending," "Failed," or "Success." The latest version is identified through keyword detection for "latest" or "current" or class name checks. Descriptions are extracted through pattern matching for "description:" or "change:" labels. All data is presented in a clean, organized panel with color-coded indicators.

THE PANEL

The publish history overlay panel is a compact, functional overlay that integrates into the Framer project 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 your publish history. 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 publish history overlay does not work standalone. Framer occasionally updates its page layouts and publish history presentation formats, which may temporarily affect publish data extraction accuracy. The tool extracts publish data from the visible page content; if publish 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 publish history on the official Framer platform. The tool does not store or transmit any data; all publish data extraction, version tracking, and settings are processed and saved entirely within your browser. This tool is designed for personal project tracking and is not affiliated with or endorsed by Framer or its parent company. Publish history data is subject to Framer's terms; always review your official Framer account for authoritative project information.