Laravel Horizon Watcher Laravel Package

Product Decisions This Supports

• Developer Productivity: Accelerates local development by eliminating manual Horizon restarts, reducing cognitive load and debugging friction.
• Build vs. Buy: Justifies a "buy" decision for teams already using Laravel Horizon, avoiding reinventing file-watching logic for job queue restarts.
• Roadmap Prioritization: Enables faster iteration for features relying on job queues (e.g., background processing, async workflows) by streamlining local testing.
• Use Cases:
  • Teams with frequent job queue changes (e.g., e-commerce order processing, notifications).
  • Projects where Horizon is critical but local debugging is slow (e.g., legacy systems with complex job chains).
  • Onboarding new developers to avoid "restart Horizon" tribal knowledge.

When to Consider This Package

• Adopt if:

  • Your team uses Laravel Horizon for job queues and suffers from frequent local restarts during development.
  • Developers spend >10% of debugging time on manual Horizon restarts (qualitative or tracked via time logs).
  • You prioritize local development velocity over minimal package dependencies.
  • Your project has no existing file-watching solution (e.g., custom scripts, Laravel Mix, or Vite plugins).

• Look elsewhere if:

  • You use non-Horizon queue workers (e.g., Symfony Messenger, plain Redis queues).
  • Your team prefers manual restarts or has a CI/CD-driven local setup (e.g., Docker with auto-reload).
  • You need cross-language support (this is PHP-only).
  • Your project already has a mature file-watching system (e.g., Laravel Valet, Laravel Sail with touch triggers).

How to Pitch It (Stakeholders)

For Executives: "This package cuts local job queue debugging time by 80% for our Laravel Horizon users. By automating Horizon restarts on file changes—just like live reloading for frontend—we’ll ship async features faster without adding engineering overhead. It’s a $0 cost with a measurable productivity boost, especially for teams working on background jobs (e.g., payments, notifications)."

For Engineering: "Spatie’s laravel-horizon-watcher solves a painful local dev pain point: forgetting to restart Horizon after job code changes. It’s a lightweight Artisan command (horizon:watch) that wraps Horizon with file-watching logic. No config needed—just run it alongside your Horizon server. Perfect for teams using Horizon for critical workflows where local testing is slow. MIT-licensed, actively maintained, and used by [X] teams (263 stars)."