https://github.com/harvey-au/hover
Check sites for broken links, slow pages, while warming cache.
https://github.com/harvey-au/hover
cache cache-warmer go link-checker performance saas shopify web-crawler webflow
Last synced: 2 days ago
JSON representation
Check sites for broken links, slow pages, while warming cache.
- Host: GitHub
- URL: https://github.com/harvey-au/hover
- Owner: Harvey-AU
- License: mit
- Created: 2025-04-05T02:53:22.000Z (about 1 year ago)
- Default Branch: main
- Last Pushed: 2026-04-04T06:20:53.000Z (23 days ago)
- Last Synced: 2026-04-04T08:29:14.963Z (23 days ago)
- Topics: cache, cache-warmer, go, link-checker, performance, saas, shopify, web-crawler, webflow
- Language: Go
- Homepage: https://adapt.app.goodnative..co
- Size: 186 MB
- Stars: 2
- Watchers: 0
- Forks: 0
- Open Issues: 6
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
- Security: SECURITY.md
- Roadmap: Roadmap.md
- Agents: AGENTS.md
Awesome Lists containing this project
README
# Hover 🐝
[](https://github.com/Harvey-AU/hover/actions/workflows/fly-deploy.yml)
[](https://github.com/Harvey-AU/hover/actions/workflows/test.yml)
[](https://codecov.io/github/harvey-au/hover)
[](https://goreportcard.com/report/github.com/Harvey-AU/hover)
[](https://pkg.go.dev/github.com/Harvey-AU/hover)
[](https://golang.org/)
[](https://opensource.org/licenses/MIT)
[](https://github.com/Harvey-AU/hover/graphs/commit-activity)
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
```bash
# 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](docs/development/DEVELOPMENT.md#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](./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](docs/development/DEVELOPMENT.md)
- [OpenCode Desktop Setup](docs/development/OPENCODE_DESKTOP.md)
- [API Reference](docs/architecture/API.md)
- [Architecture Overview](docs/architecture/ARCHITECTURE.md)
- [Supabase Realtime](docs/development/SUPABASE-REALTIME.md)
- [Observability & Tracing](docs/operations/OBSERVABILITY.md)
- [All Documentation →](docs/)
## Support
- [Report Issues](https://github.com/Harvey-AU/hover/issues)
- [Security Policy](SECURITY.md)
- Email:
## License
MIT - See [LICENSE](LICENSE)