Carrd Site Analytics Overlay

WHAT IT DOES

This userscript adds a real-time analytics overlay to your Carrd site dashboard, giving you instant visibility into your site's performance. It reads visitor data from the Carrd analytics page—including total visitors, unique visitors, page views, today's visitors, referral sources, device types, and most visited pages—and displays them in a clean, color-coded dashboard panel. A traffic status indicator (Good, Moderate, or Low) provides an at-a-glance assessment of your site's traffic levels. A visitor count badge appears in the corner of your screen showing the current visitor count. The script tracks historical data locally, calculating average daily visitors and showing trends over time. This is invaluable for Carrd site owners who want to monitor traffic, understand audience behavior, and make data-driven decisions about content and promotion, all without leaving the Carrd interface.

WHERE IT RUNS

The script runs on all Carrd web application pages at *.carrd.co/*, with automatic detection of analytics pages, the site dashboard, and any page displaying visitor statistics. It works across all Carrd interfaces by using multiple selector strategies to find visitor counts, unique visitors, page views, referral sources, and device types. The script detects dynamic content loading and re-renders the overlay when the analytics data updates. It runs across the entire Carrd domain, ensuring coverage whether you're viewing the main dashboard, analytics page, or site settings.

HOW TO USE

Install the script via the BotGentz extension and navigate to your Carrd site dashboard or analytics page. The analytics overlay will appear automatically, showing your key metrics in a compact panel. The overlay displays total visitors, unique visitors, page views, today's visitors, and a traffic status indicator. A small visitor count badge appears in the bottom-right corner of your screen for quick reference. The summary section shows average daily visitors and your most visited page. Use the panel controls to customize your experience: toggle the overlay on or off, show or hide the visitor count badge, enable or disable real-time updates (every 30 seconds), or show or hide referral sources. The "Refresh data" button manually rescans the page for updated metrics, and the "Copy summary" button exports the analytics summary to your clipboard for reporting.

THE MECHANISM - DATA EXTRACTION, STATUS ASSESSMENT, AND HISTORICAL TRACKING

This script identifies analytics data by scanning the DOM for known Carrd analytics elements. It uses a cascading selector strategy that looks for total visitors (.total-visitors, .visitor-count, .stats-total), unique visitors (.unique-visitors, .unique-count), page views (.page-views, .view-count), today's visitors (.today-visitors, .today-count), referral sources (.top-referral, .referral-source), device types (.top-device, .device-type), and most visited pages (.most-visited, .top-page). When direct selectors fail, the script analyzes text content for numeric patterns. The traffic status indicator uses a simple threshold system: 100+ visitors is "Good," 30-99 is "Moderate," and below 30 is "Low." For historical tracking, the script stores daily visitor counts in GM_setValue keyed by site name, allowing the overlay to show average daily visitors and trends. The visitor count badge is created as a fixed-position DOM element with inline styles and updated automatically.

THE PANEL

The control panel appears as a floating, draggable element that you can position anywhere on the Carrd 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 chart 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 the metrics grid, status indicator, summary, and settings controls. Press the Escape key to quickly collapse the panel to its minimized state. The panel remains visible across page navigation within Carrd, with the overlay updating automatically as you move between pages.

PLEASE NOTE

This script requires the free BotGentz extension to function. It is designed for Carrd site owners who need to monitor visitor analytics. The script reads only visible analytics data from the DOM—it does not access Carrd's API, your account credentials, or any sensitive information. All settings (overlay visibility, badge visibility, real-time toggle, referral toggle, historical data, and panel position) are stored locally using GM_setValue and never leave your browser. The script does not modify your Carrd data—it only reads and visualizes visible metrics. The traffic status indicator is based on visitor count only; use it as a general guide, not a definitive assessment. Historical tracking is stored per site name; if you have multiple sites with the same name, their data will be combined. If Carrd updates its website structure, the script may need to be updated to match new selectors. Real-time updates refresh every 30 seconds and can be disabled to reduce resource usage.