PHPackages                             bagsiz/laravel-maintenance - 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 & Helpers](/categories/utility)
4. /
5. bagsiz/laravel-maintenance

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

bagsiz/laravel-maintenance
==========================

A simple maintenance mode package for Laravel applications

v1.0.5(1y ago)05MITPHPPHP ^7.2|^8.0

Since Mar 4Pushed 1y ago1 watchersCompare

[ Source](https://github.com/bagsiz/laravel-maintenance)[ Packagist](https://packagist.org/packages/bagsiz/laravel-maintenance)[ RSS](/packages/bagsiz-laravel-maintenance/feed)WikiDiscussions main Synced 1mo ago

READMEChangelogDependencies (3)Versions (6)Used By (0)

Laravel Maintenance Mode Package
================================

[](#laravel-maintenance-mode-package)

A simple and flexible maintenance mode package for Laravel applications.

Installation
------------

[](#installation)

You can install the package via composer:

```
composer require bagsiz/laravel-maintenance
```

The package will automatically register its service provider and middleware.

Configuration
-------------

[](#configuration)

You can publish the configuration file and views:

```
php artisan vendor:publish --provider="Bagsiz\Maintenance\MaintenanceServiceProvider" --tag="maintenance"
```

This will create:

- `config/maintenance.php` - Configuration file
- `resources/views/maintenance/maintenance.blade.php` - Default maintenance view

Usage
-----

[](#usage)

### Using the Facade

[](#using-the-facade)

```
use Bagsiz\Maintenance\Facades\Maintenance;

// Enable maintenance mode
Maintenance::enable(['127.0.0.1'], ['admin/*']);

// Disable maintenance mode
Maintenance::disable();

// Check if maintenance mode is enabled
if (Maintenance::isEnabled()) {
    // ...
}

// Get maintenance mode data
$data = Maintenance::getData();
```

### Using Artisan Commands

[](#using-artisan-commands)

Enable maintenance mode:

```
php artisan maintenance on --ip=127.0.0.1 --ip=192.168.1.1 --path=admin/* --path=api/*
```

Disable maintenance mode:

```
php artisan maintenance off
```

### Customizing the Maintenance View

[](#customizing-the-maintenance-view)

The package includes a default maintenance view that you can customize. After publishing the views, you can modify `resources/views/maintenance/maintenance.blade.php` to match your application's design.

The view includes:

- A maintenance icon
- A title and description
- Maintenance start time
- Contact information (uses `config('app.admin_email')`)

Features
--------

[](#features)

- Enable/disable maintenance mode
- Allow specific IP addresses to access the application during maintenance
- Allow specific paths to be accessible during maintenance
- Command-line interface for easy management
- Configurable through config file
- Customizable maintenance view
- Automatic middleware registration for both web and API routes
- Simple and lightweight

License
-------

[](#license)

The MIT License (MIT). Please see [License File](LICENSE.md) for more information.

###  Health Score

27

—

LowBetter than 49% of packages

Maintenance44

Moderate activity, may be stable

Popularity4

Limited adoption so far

Community4

Small or concentrated contributor base

Maturity46

Maturing project, gaining track record

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.

###  Release Activity

Cadence

Every ~0 days

Total

5

Last Release

434d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/e6b0f3e32d9c4b7d5a9974c11b25348d88b289891eca38f177774055ccd5741a?d=identicon)[muratbagsiz](/maintainers/muratbagsiz)

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/bagsiz-laravel-maintenance/health.svg)

```
[![Health](https://phpackages.com/badges/bagsiz-laravel-maintenance/health.svg)](https://phpackages.com/packages/bagsiz-laravel-maintenance)
```

###  Alternatives

[barryvdh/laravel-ide-helper

Laravel IDE Helper, generates correct PHPDocs for all Facade classes, to improve auto-completion.

14.9k123.0M687](/packages/barryvdh-laravel-ide-helper)[orchestra/canvas

Code Generators for Laravel Applications and Packages

21017.2M158](/packages/orchestra-canvas)[illuminate/pipeline

The Illuminate Pipeline package.

9446.6M213](/packages/illuminate-pipeline)[illuminate/pagination

The Illuminate Pagination package.

10532.5M862](/packages/illuminate-pagination)[spatie/laravel-pjax

A pjax middleware for Laravel 5

513371.8k11](/packages/spatie-laravel-pjax)[spatie/laravel-mix-preload

Add preload and prefetch links based your Mix manifest

169176.0k2](/packages/spatie-laravel-mix-preload)

PHPackages © 2026

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