hover

Hover 🐝

A comprehensive website health and performance tool that monitors site health, detects broken links, identifies slow pages, and warms cache for optimal performance after publishing. Integrates seamlessly with Webflow via OAuth with automated scheduling and webhook-triggered crawls.

Keep your site fast and healthy with continuous monitoring and intelligent cache warming.

Built by the Good Native team in Castlemaine, Victoria, Australia.

Key Features

Site Health Monitoring

• 🔍 Broken link detection across your entire site
• 🚨 Identify 404s, timeouts, and redirect chains
• 🐌 Detect slow-loading pages and performance bottlenecks
• 📈 Track broken links and performance over time
• ⚡ Lightning fast speed, without being blocked or spamming your site

Cache Warming

• 🔥 Smart warming with automatic retry on cache MISS
• 🥇 Priority processing - homepage and critical pages first
• ⚡ Improved initial page load times after publishing
• 🤖 Robots.txt compliance with crawl-delay honouring

Automation & Integration

• 🔄 Scheduled crawls (6/12/24/48 hour intervals) per site
• 🚀 Webflow OAuth integration with auto-crawl on publish webhooks
• 📊 Real-time dashboard with live job progress via WebSockets
• 🔔 Slack notifications via DMs when jobs complete or fail
• 🔐 Multi-organisation support with Supabase Auth and RLS
• 🔌 RESTful API for platform integrations
• 🏷️ Technology detection (CMS, CDN, frameworks)

Quick Start

# Clone the repository
git clone https://github.com/Harvey-AU/hover.git hover
cd hover

# Set up tracked Git hooks once per clone
# Future worktrees inherit this shared hooks path automatically
bash scripts/setup-hooks.sh

# Start development environment
# Windows:
dev              # Clean output (info level)
dev debug        # Verbose output (debug level)

# Mac/Linux:
./dev.sh         # Clean output (info level)
./dev.sh debug      # Verbose output (debug level)

One command starts everything:

• ✅ Checks prerequisites (Docker + Supabase CLI)
• 🐳 Starts local Supabase database
• 🔄 Auto-applies migrations
• 📝 Generates .env.local on first run (from supabase status)
• 🔥 Hot reloading on port 8847
• 📊 Displays helpful URLs for homepage, dashboard, and Supabase Studio
• 🚀 Completely isolated from production
• 🔇 Clean logging by default, verbose mode available

Then log in: navigate to http://localhost:8847/dev/auto-login — signs you in as the dev seed user instantly, no OAuth flow needed. See Local Authentication for details.

.env.local is generated automatically by dev.sh — do not commit it.

Status

~65% Complete - Stage 4 of 7 (Core Authentication & MVP Interface)

Recent milestones:

• ✅ Webflow OAuth integration with per-site scheduling and webhooks (v0.23.0)
• ✅ Slack notifications and real-time dashboard updates (v0.20.x)
• ✅ Multi-organisation support with context switching (v0.19.0)
• ✅ Security and compliance testing with CI/CD (Go Report Card: A)

In progress: Google Analytics integration, payment infrastructure, platform SDK

See Roadmap.md for detailed progress tracking.

Tech Stack

• Backend: Go 1.26 with PostgreSQL (Supabase)
• Frontend: Vanilla JavaScript with data-binding (no build process)
• Infrastructure: Fly.io (app + DB), Cloudflare CDN, Supabase (auth + realtime)
• Monitoring: Sentry (errors), Grafana Cloud (traces), Codecov (coverage)

Documentation

• Getting Started
• OpenCode Desktop Setup
• API Reference
• Configuration Reference
• Architecture Overview
• Supabase Realtime
• Observability & Tracing
• All Documentation →

Support

• Report Issues
• Security Policy
• Email: hello@teamharvey.co

License

MIT - See LICENSE