Download the PHP package jamesjulius/laravel-nexus without Composer
On this page you can find all versions of the php package jamesjulius/laravel-nexus. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download jamesjulius/laravel-nexus
More information about jamesjulius/laravel-nexus
Files in jamesjulius/laravel-nexus
Package laravel-nexus
Short Description Laravel Nexus - Your central hub for queue worker management with auto-discovery, live logging, and file watching
License MIT
Homepage https://github.com/jamesjulius/laravel-nexus
Informations about the package laravel-nexus
Laravel Nexus
Laravel Nexus is your central hub for queue worker management. It automatically discovers your queues, provides interactive configuration, and manages multiple workers with beautiful real-time logging and hot reload capabilities.
๐ค Why Laravel Nexus?
Tired of this? ๐ค
Laravel Nexus was born from this exact frustration!
Instead of juggling multiple terminal windows and remembering different queue configurations, Laravel Nexus lets you:
โจ Run ONE command to manage ALL your queues ๐ Auto-discover all queues in your app โ๏ธ Configure once, run everywhere ๐บ Monitor everything in one beautiful interface
That's it! All your queues running with optimized settings, beautiful logs, and zero mental overhead.
โจ Features
- ๐ Auto-Discovery - Scans Jobs, Events, Mail, Notifications, and Listeners
- โ๏ธ Interactive Setup - Beautiful Laravel Prompts for easy configuration
- ๐บ Live Log Streaming - Real-time, color-coded worker output
- ๐๏ธ Process Management - Start, stop, restart, and monitor workers
- ๐ฅ Hot Reload - Auto-restart workers when files change (perfect for development)
- ๐ Auto-restart - Responds to Laravel's
queue:restartsignals - ๐ Smart Defaults - Optimized settings based on queue type
- ๐ Production Ready - Built for reliability and performance
- โ Thoroughly Tested - Comprehensive test suite with 31 tests covering all functionality
๐งช Testing & Quality
Laravel Nexus is thoroughly tested with a comprehensive test suite:
- 31 Tests covering all package functionality
- Unit Tests for core services and queue discovery
- Feature Tests for all commands and workflows
- Architecture Tests ensuring code quality and standards
- CI/CD Pipeline testing against PHP 8.1, 8.2, 8.3, 8.4 and Laravel 10.x, 11.x, 12.x
- Code Style enforcement with Laravel Pint
- Security Auditing with automated dependency scanning
Installation
Install the package via Composer:
The package will automatically register its service provider.
Optionally, publish the configuration file:
Quick Start
1. Interactive Setup (Recommended)
Run the interactive configuration to discover and set up your queues:
This will:
- ๐ Scan your app for Jobs, Events, Mail, and Notifications
- ๐ Show discovered queues with job counts and statistics
- โ๏ธ Let you configure worker settings interactively
- ๐พ Save configuration to
config/nexus.php - ๐ Optionally start workers immediately
2. Start Workers
Start your configured workers:
3. Management Commands
Commands Reference
Configuration Management
Worker Management
Help & Documentation
Configuration
The package automatically generates a config/nexus.php file with your queue configurations:
Advanced Configuration Options
Laravel Nexus now offers advanced configuration modes to reduce repetitive configuration across multiple queues:
Global Defaults Mode
When configuring multiple queues, you can set global defaults that apply to all workers:
This lets you set:
- Default timeout per job (seconds)
- Default memory limit per worker (MB)
- Default max retry attempts
- Default sleep time between jobs
- Default max jobs per worker before restart
- Default max worker runtime
Simplified Configuration Mode
For teams that don't want to configure timeout/memory for every queue:
In simplified mode, you only configure:
- Worker count per queue (the most important setting)
- Everything else uses smart defaults or your global settings
This is perfect when you want to:
- ๐ Quick setup - Just set worker counts, use smart defaults
- ๐ฏ Focus on scaling - Configure what matters most (process count)
- ๐ Consistent settings - Same timeout/memory across all queues
Configuration Flow Example
Queue Auto-Discovery
Laravel Nexus automatically discovers queues from:
- Jobs with
$queueproperty oronQueue()calls - Broadcasting Events with
broadcastQueue()method - Mail Classes using the
Queueabletrait - Notifications implementing
ShouldQueue - Event Listeners that are queued
Example Queue Detection
Development Workflow
Hot Reload
Perfect for development - automatically restarts workers when files change:
Monitors:
app/directoryconfig/directoryroutes/directorydatabase/migrations/directoryresources/views/directory
Live Logging
Stream worker logs in real-time with beautiful color coding:
Log Features:
- โ Color-coded job statuses (Processing=Orange, Success=Green, Failed=Red)
- ๐ฏ Job class highlighting
- ๐ Memory usage and duration highlighting
- ๐ Job ID extraction in detailed mode
- โฐ Smart timestamp formatting
Production Usage
Basic Setup
Supervisor Configuration
Health Monitoring
Environment Variables
Troubleshooting
No Queues Detected
Workers Not Starting
Performance Issues
- Adjust worker counts based on your server capacity
- Tune memory limits per queue type in config
- Monitor with
--statuscommand - Use appropriate timeouts for different job types
Contributing
Contributions are welcome! Please feel free to submit a Pull Request.
Development Setup
Testing Guidelines
- All new features must include tests
- Tests should cover both success and failure scenarios
- Run the full test suite before submitting PRs
- Follow the existing test patterns and structure
Pull Request Process
- Ensure all tests pass:
composer test - Ensure code style compliance:
composer format-test - Update documentation if needed
- Submit PR with clear description of changes
License
The MIT License (MIT). Please see License File for more information.
Credits
- James Julius - Initial development
- Built with โค๏ธ for the Laravel community
Laravel Nexus - Your central hub for queue worker management ๐
All versions of laravel-nexus with dependencies
illuminate/console Version ^10.0|^11.0|^12.0
illuminate/support Version ^10.0|^11.0|^12.0
illuminate/process Version ^10.0|^11.0|^12.0
laravel/prompts Version ^0.1|^0.3