emmanpbarrameda/laravel-scheduled-maintenance

Modern Laravel scheduled maintenance windows with notices, bypass mode, redirects, and custom maintenance responses.

v1.0.4 2026-05-01 13:17 UTC

Requires

• php: ^8.1
• illuminate/contracts: ^10.0|^11.0|^12.0
• illuminate/database: ^10.0|^11.0|^12.0
• illuminate/support: ^10.0|^11.0|^12.0
• spatie/laravel-package-tools: ^1.16

Requires (Dev)

• larastan/larastan: ^3.0
• nunomaduro/collision: ^7.0|^8.0|^9.0
• orchestra/testbench: ^8.0|^9.0|^10.0
• phpunit/phpunit: ^10.0|^11.0

MIT

• James Burrow
• Emman P. Barrameda

• laravel
• laravel-maintenance
• maintenance-mode
• laravel-scheduled-maintenance
• scheduled-maintenance

README

A modern Laravel package for scheduling app maintenance, showing upcoming downtime notices, and customizing the maintenance page. Supports Laravel 10, 11, and 12 with PHP 8.1 and newer.

A Modern Version of laravel-scheduled-maintenance by James Burrow

Requirements

Requirement	Version
PHP	^8.1 (up to latest)
Laravel	^10.0 | ^11.0 | ^12.0

Installation

Step 1

composer require emmanpbarrameda/laravel-scheduled-maintenance

Step 2

Publish the config, migration, views, and assets:

php artisan vendor:publish --provider="Emmanpbarrameda\ScheduledMaintenance\ScheduledMaintenanceServiceProvider"

Step 3

Run the migration:

php artisan migrate

Step 4

Register the middleware in bootstrap/app.php (Laravel 11+):

->withMiddleware(function (Middleware $middleware) {
    $middleware->prepend(\Emmanpbarrameda\ScheduledMaintenance\Http\Middleware\CheckForScheduledMaintenance::class);
})

Or in app/Http/Kernel.php (Laravel 10):

protected $middleware = [
    \Emmanpbarrameda\ScheduledMaintenance\Http\Middleware\CheckForScheduledMaintenance::class,
    // ...
];

Full Documentation

Read the full installation and configuration guide here: Laravel Scheduled Maintenance by Emman

Screenshots

License

MIT - see LICENSE for details.

Credits

• Original package by James Burrow
• Modernized and maintained by Emman P. Barrameda