PHPackages                             sakshsky/laravel-smart-scheduler - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Utility &amp; Helpers](/categories/utility)
4. /
5. sakshsky/laravel-smart-scheduler

ActiveLibrary[Utility &amp; Helpers](/categories/utility)

sakshsky/laravel-smart-scheduler
================================

A smart scheduler UI for Laravel applications

00PHP

Since May 20Pushed 1y ago1 watchersCompare

[ Source](https://github.com/sakshsky/laravel-smart-scheduler)[ Packagist](https://packagist.org/packages/sakshsky/laravel-smart-scheduler)[ RSS](/packages/sakshsky-laravel-smart-scheduler/feed)WikiDiscussions main Synced today

READMEChangelogDependenciesVersions (1)Used By (0)

Here's a comprehensive, professional `README.md` file for your Laravel Smart Scheduler package with detailed documentation, examples, and visual sections:

```
# Laravel Smart Scheduler 🚀

[![Latest Version](https://img.shields.io/packagist/v/sakshsky/laravel-smart-scheduler.svg?style=flat-square)](https://packagist.org/packages/sakshsky/laravel-smart-scheduler)
[![Total Downloads](https://img.shields.io/packagist/dt/sakshsky/laravel-smart-scheduler.svg?style=flat-square)](https://packagist.org/packages/sakshsky/laravel-smart-scheduler)
[![License](https://img.shields.io/packagist/l/sakshsky/laravel-smart-scheduler.svg?style=flat-square)](https://github.com/sakshsky/laravel-smart-scheduler/blob/main/LICENSE.md)

A beautiful, intuitive interface for managing Laravel task scheduling with real-time previews, visual cron builder, and one-click task execution.

![Scheduler Dashboard](https://via.placeholder.com/800x400.png?text=Scheduler+Dashboard+Preview)
*(Screenshot placeholder - replace with actual screenshot)*

## Features ✨

- 🎛️ **Visual Cron Expression Builder** - Create schedules without remembering cron syntax
- ⚡ **Real-time Preview** - See next 5 run times before saving
- 📝 **Code Generator** - Get ready-to-use Laravel scheduler code
- 📊 **Task Monitoring** - View execution history and outputs
- 🔔 **Notifications** - Get alerts for failed tasks (Email/Slack)
- 🕒 **Timezone Support** - Set per-task timezones
- 🛡️ **Overlap Protection** - Built-in `withoutOverlapping()` for all tasks

## Installation 📦

1. Require the package via Composer:

```bash
composer require sakshsky/laravel-smart-scheduler
```

2. Publish assets and configuration:

```
php artisan vendor:publish --provider="Sakshsky\SmartScheduler\Providers\SmartSchedulerServiceProvider"
```

3. Run migrations:

```
php artisan migrate
```

Basic Usage 🏁
-------------

[](#basic-usage-)

### Accessing the Dashboard

[](#accessing-the-dashboard)

Navigate to `/scheduler` (configurable in config file) after installation.

### Creating Your First Task

[](#creating-your-first-task)

1. Click "Add New Task"
2. Fill in task details:
    - **Name**: "Send Daily Reports"
    - **Command**: `emails:send --type=daily`
    - **Frequency**: Daily at 9:00 AM
3. Click "Save"

[![Task Creation](https://camo.githubusercontent.com/62afd554ccd3c4d50f97d29097a4163c293b84e0b1141d758c0aa34a54441f29/68747470733a2f2f7669612e706c616365686f6c6465722e636f6d2f363030783430302e706e673f746578743d5461736b2b4372656174696f6e2b466f726d)](https://camo.githubusercontent.com/62afd554ccd3c4d50f97d29097a4163c293b84e0b1141d758c0aa34a54441f29/68747470733a2f2f7669612e706c616365686f6c6465722e636f6d2f363030783430302e706e673f746578743d5461736b2b4372656174696f6e2b466f726d)*(Screenshot placeholder)*

Advanced Examples 🧠
-------------------

[](#advanced-examples-)

### 1. Complex Cron Example

[](#1-complex-cron-example)

Create a task that runs at 15 minutes past every 4 hours on weekdays:

```
// Generated code from the visual builder
$schedule->command('reports:generate')
    ->name('Weekday Reports')
    ->cron('15 */4 * * 1-5')
    ->timezone('America/New_York')
    ->withoutOverlapping()
    ->appendOutputTo(storage_path('logs/reports.log'));
```

### 2. Task with Notifications

[](#2-task-with-notifications)

Configure in `config/smart-scheduler.php`:

```
'notifications' => [
    'mail' => [
        'enabled' => true,
        'to' => 'dev@example.com',
    ],
    'slack' => [
        'enabled' => true,
        'webhook_url' => env('SLACK_WEBHOOK_URL'),
    ],
],
```

### 3. API Usage

[](#3-api-usage)

The package provides an API to manage tasks programmatically:

```
use Sakshsky\SmartScheduler\Models\ScheduledTask;

// Create a new task
ScheduledTask::create([
    'name' => 'Database Backup',
    'command' => 'backup:run',
    'cron_expression' => '0 2 * * *',
    'timezone' => 'UTC',
    'description' => 'Nightly database backup'
]);

// Disable a task
$task = ScheduledTask::find(1);
$task->update(['enabled' => false]);
```

Configuration ⚙️
----------------

[](#configuration-️)

After publishing the config file (`config/smart-scheduler.php`), you can customize:

```
return [
    'route_prefix' => 'scheduler', // Change dashboard URL
    'middleware' => ['web', 'auth'], // Authentication middleware
    'timezone' => env('APP_TIMEZONE', 'UTC'), // Default timezone

    // Enable/disable features
    'features' => [
        'builder' => true,
        'task_management' => true,
        'notifications' => true,
    ],

    // Notification channels
    'notifications' => [
        'mail' => [
            'enabled' => true,
            'to' => env('ADMIN_EMAIL'),
        ],
        'slack' => [
            'enabled' => false,
            'webhook_url' => env('SLACK_WEBHOOK_URL'),
        ],
    ],
];
```

Security Considerations 🔒
-------------------------

[](#security-considerations-)

By default, the scheduler dashboard is protected by:

- `auth` middleware (requires login)
- Route prefix (change from default 'scheduler' if needed)

For production:

1. Consider adding additional middleware (e.g., `can:admin`)
2. Restrict access to specific IPs if needed
3. Regularly update the package

Troubleshooting 🛠️
------------------

[](#troubleshooting-️)

**Issue**: Tasks not running
✅ Check `php artisan schedule:list` to verify tasks are registered
✅ Ensure your cron job is set up correctly on the server:

```
* * * * * cd /path-to-your-project && php artisan schedule:run >> /dev/null 2>&1
```

**Issue**: Timezone not respected
✅ Verify `APP_TIMEZONE` in your `.env`
✅ Check individual task timezone settings

Contributing 🤝
--------------

[](#contributing-)

We welcome contributions! Please follow these steps:

1. Fork the repository
2. Create your feature branch (`git checkout -b feature/amazing-feature`)
3. Commit your changes (`git commit -m 'Add some amazing feature'`)
4. Push to the branch (`git push origin feature/amazing-feature`)
5. Open a Pull Request

License 📄
---------

[](#license-)

This package is open-source software licensed under the [MIT license](https://opensource.org/licenses/MIT).

Support ❤️
----------

[](#support-️)

If you find this package useful, please consider:

- ⭐ Starring the GitHub repo
- 🐛 Reporting issues
- 💡 Suggesting new features

---

\*Created with ❤️ by sakshsky

###  Health Score

15

—

LowBetter than 3% of packages

Maintenance35

Infrequent updates — may be unmaintained

Popularity0

Limited adoption so far

Community9

Small or concentrated contributor base

Maturity15

Early-stage or recently created project

 Bus Factor1

Top contributor holds 50% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/210330406?v=4)[sakshsky](/maintainers/sakshsky)[@sakshsky](https://github.com/sakshsky)

---

Top Contributors

[![sakshsky](https://avatars.githubusercontent.com/u/210330406?v=4)](https://github.com/sakshsky "sakshsky (1 commits)")[![sakshstore](https://avatars.githubusercontent.com/u/44046755?v=4)](https://github.com/sakshstore "sakshstore (1 commits)")

### Embed Badge

![Health badge](/badges/sakshsky-laravel-smart-scheduler/health.svg)

```
[![Health](https://phpackages.com/badges/sakshsky-laravel-smart-scheduler/health.svg)](https://phpackages.com/packages/sakshsky-laravel-smart-scheduler)
```

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)
