chege-simon/vista

Horizon-style scheduler monitor for Laravel

v0.5.10 2025-12-12 10:24 UTC

Requires

• php: ^8.1
• illuminate/support: ^10.0|^11.0|^12.0

Requires (Dev)

• orchestra/testbench: ^10.8
• phpunit/phpunit: ^12.5

MIT

• Chege Simon

README

Vista is a Horizon-style scheduler monitor for Laravel. It provides a beautiful Vue-powered dashboard to view, supervise, and manage your scheduled tasks in real time. With Vista, you can track the status of your jobs, monitor the scheduler loop, and ensure your application's scheduled commands are running reliably.

✨ Features

• 📊 Dashboard UI — A Vue SPA that displays your scheduled tasks and their execution status.
• ⏱️ Scheduler Supervisor — Runs schedule:run at configurable intervals.
• ⚙️ Configurable Interval — Control how often Vista checks and runs tasks.
• 🔌 Laravel Package — Ships as a reusable package with auto-discovery.
• 🧪 Tested with Orchestra Testbench — Ensures reliability across Laravel versions.

📦 Installation

Require Vista via Composer:

composer require chege-simon/vista

🔧 Publishing Assets

Vista ships with configuration, views, and compiled dashboard assets. Publish them with:

php artisan vendor:publish --tag=vista-config
php artisan vendor:publish --tag=vista-views
php artisan vendor:publish --tag=vista-assets

⚙️ Configuration

The default configuration file is config/vista.php. You can adjust the scheduler interval:

return [
    'interval' => 60, // seconds between schedule checks
];

🚀 Usage

Start the Vista scheduler supervisor:

php artisan vista

This will run schedule:run every configured interval and log output to your console.

🖥️ Dashboard

After installation, visit:

http://your-app.test/vista

to access the Vue SPA dashboard. Here you can monitor scheduled tasks, view logs, and confirm that your scheduler is running smoothly.

🔄 Release Workflow

For maintainers:

1. Build frontend assets with Vite:

npm run build

1. Commit compiled assets.
2. Update CHANGELOG.md.
3. Tag a release:

git tag v0.5.0
git push origin v0.5.0

1. Packagist will auto-update, making the new version installable.

🧪 Testing

Vista uses Orchestra Testbench to ensure compatibility with Laravel. Run the test suite with:

vendor/bin/phpunit

🤝 Contributing

Pull requests are welcome! Please include tests and follow Laravel package conventions. For major changes, open an issue first to discuss what you would like to change.

📜 License

Vista is open-source software licensed under the MIT license.