Teamwork Project Health Badge

WHAT IT DOES

This userscript transforms your Teamwork project dashboard into a health monitoring system. It reads project data including completion percentage, overdue tasks, tasks due soon, milestone completion, and days remaining until the due date, then calculates an overall project health score from 0 to 100. Each project card displays a color-coded health badge: green for good health (70+), yellow for at risk (40-69), orange for warning (below your warning threshold), and red for critical (below your critical threshold). Hovering over a badge reveals a detailed breakdown showing how each factor contributed to the score with visual progress bars. A summary panel shows total projects, average health score, counts by health status, and highlights the healthiest and most at-risk projects. This helps project managers, team leads, and executives quickly identify which projects need attention, track overall portfolio health, and make data-driven decisions about resource allocation.

WHERE IT RUNS

The script runs on all Teamwork web application pages at *.teamwork.com/*, with automatic detection of project lists, dashboards, and any page displaying project cards or items. It works across all Teamwork interfaces by using multiple selector strategies to find project cards, names, completion percentages, task metrics, milestone data, and due dates. The script detects dynamic content loading and re-applies health badges whenever the project list changes. It runs across the entire Teamwork domain, ensuring coverage whether you're viewing your main projects dashboard, a specific project list, or a portfolio overview.

HOW TO USE

Install the script via the BotGentz extension and navigate to your Teamwork project dashboard. Health badges will appear automatically on every project card. Each badge shows the health score and status label. Hover over any badge to see a detailed breakdown of the health factors: completion percentage, overdue tasks, days remaining, milestone progress, and due soon tasks, each with a visual progress bar. The summary panel appears above your project list showing total projects, average health score, counts by health status, and the healthiest and worst-performing projects. Use the panel controls to customize your experience: toggle badges on or off, enable or disable the detailed breakdown on hover, show or hide the summary panel, or adjust the warning and critical threshold percentages. The "Refresh" button manually reapplies all health badges if the page updates.

THE MECHANISM - METRIC EXTRACTION, SCORE CALCULATION, AND HEALTH VISUALIZATION

This script identifies project data by scanning each project card using a cascading selector strategy. It extracts project names from title elements, completion percentages from progress bars or percentage labels, overdue task counts from overdue indicators, due soon task counts from upcoming task labels, milestone data from milestone completion text, and due dates from date elements. The health score is calculated using a weighted formula: completion percentage contributes up to 40% of the score, overdue tasks penalize up to 25%, days remaining contributes up to 20% (pro-rated to 30 days), milestone completion contributes up to 15%, and tasks due soon has a small penalty up to 10%. Each factor is calculated individually, then aggregated to produce a score from 0 to 100. The badge is created as a DOM element with inline styles and inserted into the project card. The breakdown tooltip is dynamically generated with factor names, values, and color-coded progress bars. The summary panel aggregates data across all projects and identifies best and worst performers.

THE PANEL

The control panel appears as a floating, draggable element that you can position anywhere on the Teamwork 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 all setting toggles, threshold controls, action buttons, and a health legend. Press the Escape key to quickly collapse the panel to its minimized state. The panel remains visible across page navigation within Teamwork, with health badges updating automatically as you move between views.

PLEASE NOTE

This script requires the free BotGentz extension to function. It is designed for Teamwork users who need to monitor project health and prioritize interventions. The script reads only visible project data from the DOM—it does not access Teamwork's API, your account credentials, or any sensitive information. All settings (badge visibility, breakdown toggle, summary toggle, threshold values, and panel position) are stored locally using GM_setValue and never leave your browser. The script does not modify your Teamwork data—it only reads and visualizes visible information. The health score is a proprietary metric based on available data and should be used as a guide, not a definitive assessment. If Teamwork updates its website structure, the script may need to be updated to match new selectors. The summary panel reflects projects currently visible on the page; if the list is paginated, the summary may not include all projects.