Sketch Cloud Version History Viewer

WHAT IT DOES

This userscript adds a compact, always-visible version history viewer to your Sketch Cloud document pages. It scans the page for version history entries and extracts version numbers, timestamps, author names, and comment descriptions, then displays them in a clean, scannable panel directly in the document header. Each version entry shows its number, relative time since it was saved, author name, and a comment indicator. The viewer color-codes entries: green for the current version, blue highlight for recent versions (within the last 7 days), and neutral for older versions. A summary at the top of the viewer shows the total number of versions, when the latest version was saved, and how many versions were created in the last 7 days. A one-click "Open History" button opens Sketch Cloud's full version history panel, and a "Copy" button exports the version list to your clipboard for sharing or documentation. This is invaluable for designers, product managers, and collaborators who need to track document evolution, understand who made changes, or quickly reference version history without navigating through menus.

WHERE IT RUNS

The script runs on all Sketch Cloud web application pages at *.sketch.com/*, with automatic detection of document pages (paths containing /document/ or /workspace/). It works across all Sketch Cloud interfaces by using multiple selector strategies to find version history items, version numbers, timestamps, author names, and comments. The script detects dynamic content loading and re-renders the viewer when navigating between documents. It runs across the entire Sketch domain, ensuring coverage whether you're viewing a design file, a prototype, or a workspace document.

HOW TO USE

Install the script via the BotGentz extension and open any Sketch Cloud document. The version history viewer will appear in the document header automatically. The viewer shows a summary of total versions, latest version date, and recent versions count. Below the summary, a scrollable list displays each version with its number, relative time, author, and a comment indicator. Versions from the last 7 days are highlighted for easy identification. Use the "Open History" button to open Sketch Cloud's full version history panel. Use the "Copy" button to copy the entire version list to your clipboard for reporting or documentation. Use the panel controls to toggle the viewer on or off, show or hide the summary, or enable or disable highlighting of recent versions. The "Refresh" button manually re-scans the page for version history updates.

THE MECHANISM - VERSION EXTRACTION, SORTING, AND VISUAL SUMMARIZATION

This script identifies version history entries by scanning the page for known Sketch Cloud version elements. It uses a cascading selector strategy that looks for version items (.version-item, .history-item, .version-entry, .revision-item), then extracts version numbers from numeric labels or text patterns, timestamps from date elements or relative time strings ("2 days ago"), author names from user-name elements, and comments from description fields. When direct selectors fail, the script analyzes text content for patterns like "Version #5" or "Saved 3 hours ago." Version entries are sorted by version number descending (or timestamp if no numbers are present). The viewer is built as a DOM element with inline styles and inserted into the document header. The summary calculates total versions, finds the latest timestamp, and counts versions within the last 7 days. The list displays up to 20 most recent versions with color coding based on recency and current status. The "Copy" function formats the version list as plain text.

THE PANEL

The control panel appears as a floating, draggable element that you can position anywhere on the Sketch Cloud page. Drag by the header to reposition it, and the position is saved per site using GM_setValue so it stays where you left it across sessions. Release the panel near any edge and it snaps into place, keeping your workspace organized. Click the panel header to collapse it into a small bubble showing only the calendar emoji (📅), minimizing distraction while keeping controls accessible. Drag from the bubble to restore the full panel. The panel automatically resizes to fit its content and includes all setting toggles and action buttons. Press the Escape key to quickly collapse the panel to its minimized state. The panel remains visible across page navigation within Sketch Cloud, with the version viewer updating automatically as you move between documents.

PLEASE NOTE

This script requires the free BotGentz extension to function. It is designed for Sketch Cloud users who need quick access to version history information. The script reads only visible version data from the DOM—it does not access Sketch Cloud's API, your account credentials, or any sensitive information. All settings (viewer visibility, summary toggle, highlight preference, and panel position) are stored locally using GM_setValue and never leave your browser. The script does not modify your Sketch Cloud data—it only reads and displays visible version information. The version history viewer relies on the version history entries being present in the DOM; if the version history panel is not loaded, the script may show limited information. If Sketch Cloud updates its website structure, the script may need to be updated to match new selectors.