hover

module

v0.33.12 Latest Latest Go to latest Published: Apr 28, 2026 License: MIT

Details

Valid go.mod file
Redistributable license
Tagged version
Stable version
Learn more about best practices

Repository

github.com/Harvey-AU/hover

Links

Open Source Insights

README ¶

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 — API server (cmd/app) + worker service (cmd/worker), coordinated via Redis broker (ZSET scheduler + Streams)
Database: Supabase PostgreSQL with pgBouncer pooler
Frontend: Vanilla JavaScript with data-binding (no build process)
Infrastructure: Fly.io (API + worker apps), Cloudflare CDN, Upstash Redis, Supabase (auth + realtime)
Monitoring: Sentry (errors), Grafana Cloud (OTLP metrics), Codecov (coverage)

Documentation

Support

License

MIT - See LICENSE

Directories ¶

Path	Synopsis
cmd
analysis command Dedicated lighthouse audit service: consumes per-job streams (stream:{jobID}:lh) and writes results back into lighthouse_runs.	Dedicated lighthouse audit service: consumes per-job streams (stream:{jobID}:lh) and writes results back into lighthouse_runs.
app command
archive_key_migrate command
hover command Command hover is the native CLI for the Hover application.	Command hover is the native CLI for the Hover application.
worker command
internal
api
archive Package archive uploads task HTML to cold object storage (R2, S3, B2) and exposes the canonical key layout used by the HTML persister.	Package archive uploads task HTML to cold object storage (R2, S3, B2) and exposes the canonical key layout used by the HTML persister.
auth
broker Package broker provides Redis-backed task scheduling, dispatch, and coordination primitives for the hover crawl execution pipeline.	Package broker provides Redis-backed task scheduling, dispatch, and coordination primitives for the hover crawl execution pipeline.
cache
crawler
db
jobs
lighthouse Package lighthouse implements the sampler, scheduler, and runner used to capture Lighthouse performance audits for a small subset of pages during each crawl.	Package lighthouse implements the sampler, scheduler, and runner used to capture Lighthouse performance audits for a small subset of pages during each crawl.
logging Package logging provides a unified slog + Sentry logging interface.	Package logging provides a unified slog + Sentry logging interface.
loops Package loops provides a client for the Loops.so email API.	Package loops provides a client for the Loops.so email API.
mocks
notifications
observability
techdetect Package techdetect provides technology detection for websites using wappalyzergo.	Package techdetect provides technology detection for websites using wappalyzergo.
testutil
util
watchdog Package watchdog forces process exit when the worker heartbeat goes flat with active workload, letting the platform's restart policy recover from latent Go-side wedges (blocked pipe, mutex deadlock, exhausted resource pool).	Package watchdog forces process exit when the worker heartbeat goes flat with active workload, letting the platform's restart policy recover from latent Go-side wedges (blocked pipe, mutex deadlock, exhausted resource pool).
scripts
deadlock_repro command Deadlock reproduction harness for the jobs/tasks counter triggers.	Deadlock reproduction harness for the jobs/tasks counter triggers.

?	: This menu
/	: Search site
f or F	: Jump to
y or Y	: Canonical URL