PHPackages                             mikailfaruqali/health - 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. [Logging & Monitoring](/categories/logging)
4. /
5. mikailfaruqali/health

ActiveLibrary[Logging & Monitoring](/categories/logging)

mikailfaruqali/health
=====================

A beautiful, responsive Laravel package for creating dynamic health checks and system diagnostics with a stunning UI. Run custom database queries, monitor system health, and troubleshoot issues through an elegant dashboard interface.

1.2.2(4mo ago)390↓93.8%MITBladePHP >=7.4

Since Sep 7Pushed 4mo agoCompare

[ Source](https://github.com/mikailfaruqali/health)[ Packagist](https://packagist.org/packages/mikailfaruqali/health)[ Docs](https://github.com/mikailfaruqali/health)[ RSS](/packages/mikailfaruqali-health/feed)WikiDiscussions main Synced today

READMEChangelog (8)Dependencies (8)Versions (9)Used By (0)

🩺 Laravel Health Dashboard
==========================

[](#-laravel-health-dashboard)

> A beautiful, responsive Laravel package for creating dynamic health checks and system diagnostics with a stunning UI. Run custom database queries, monitor system health, and troubleshoot issues through an elegant dashboard interface.

[![Latest Stable Version](https://camo.githubusercontent.com/5c5e10d9b80404dfb2a8bc5cabc5807e44711c29557e08e81ec9d9732ee1af7d/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f6d696b61696c6661727571616c692f6865616c74682e737667)](https://packagist.org/packages/mikailfaruqali/health)[![Total Downloads](https://camo.githubusercontent.com/a19d73ce8b35fe15bb1b3d5c503dbeff82ab7efccc66d9743f5dfa69df09d2f1/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f6d696b61696c6661727571616c692f6865616c74682e737667)](https://packagist.org/packages/mikailfaruqali/health)[![License](https://camo.githubusercontent.com/e70aac00e3dadf2e3b448ca07c7d953074bb11a1590c9053e1fdfb16c36c4290/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f6c2f6d696b61696c6661727571616c692f6865616c74682e737667)](https://packagist.org/packages/mikailfaruqali/health)[![PHP Version](https://camo.githubusercontent.com/f8a9108f9461370fae7bc8a74783e1ca4fed4fec8682a471e42ab5858e1842b3/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f7068702d762f6d696b61696c6661727571616c692f6865616c74682e737667)](https://packagist.org/packages/mikailfaruqali/health)

✨ Features
----------

[](#-features)

### 🎨 **Beautiful & Modern UI**

[](#-beautiful--modern-ui)

- Sleek, responsive design built with Tailwind CSS
- Mobile-first approach with adaptive layouts
- Dark mode friendly with smooth animations
- Professional dashboard that fits any Laravel application

### 🚀 **Zero Configuration Setup**

[](#-zero-configuration-setup)

- Works out of the box with sensible defaults
- Auto-discovery of health check classes
- No database migrations or complex setup required
- Simply install and start adding checks

### 📱 **Mobile-First Responsive Design**

[](#-mobile-first-responsive-design)

- Fully responsive across all device sizes
- Tables automatically transform to cards on mobile
- Touch-friendly interface with optimized interactions
- Perfect viewing experience on phones, tablets, and desktops

### ⚡ **Dynamic Health Checks**

[](#-dynamic-health-checks)

- Just create a PHP class and it automatically appears
- Run checks individually or execute all at once
- Real-time execution with live status updates
- Smart data presentation with automatic table generation

### 🔍 **Advanced Monitoring**

[](#-advanced-monitoring)

- Performance metrics with execution time tracking
- Color-coded status indicators (Success, Warning, Error)
- Detailed error reporting with exception handling
- Data count and issue tracking

### 🔒 **Security & Access Control**

[](#-security--access-control)

- Configurable middleware protection
- Support for authentication and authorization
- Rate limiting and custom middleware support
- Secure by default with web middleware

### 📊 **Smart Data Visualization**

[](#-smart-data-visualization)

- Automatic table generation from array data
- Responsive tables that adapt to screen size
- Mobile card views for complex data
- Syntax highlighting for differences and issues

### 🎯 **Developer Experience**

[](#-developer-experience)

- Abstract base class for quick implementation
- Interface-based architecture for flexibility
- Comprehensive error handling and recovery
- Clean, intuitive API design

📋 Requirements
--------------

[](#-requirements)

- **PHP** >= 7.4
- **Laravel** >= 5.0 (supports Laravel 5.x through 11.x)
- **illuminate/contracts** >= 5.0

🚀 Quick Start
-------------

[](#-quick-start)

### 1. Installation

[](#1-installation)

Install the package via Composer:

```
composer require mikailfaruqali/health
```

### 2. Publish Configuration (Optional)

[](#2-publish-configuration-optional)

```
php artisan vendor:publish --tag=health-config
```

### 3. Access Dashboard

[](#3-access-dashboard)

Visit `/health` in your browser to see the dashboard!

🔧 Configuration
---------------

[](#-configuration)

The configuration file is published to `config/snawbar-health.php`:

```
return [
    /*
    |--------------------------------------------------------------------------
    | Health Check Classes
    |--------------------------------------------------------------------------
    |
    | Register all your health check classes here. Each class must implement
    | the HealthCheck interface or extend the AbstractCheck class.
    |
    */
    'checks' => [
        \App\HealthChecks\DatabaseConnectionCheck::class,
        \App\HealthChecks\StoreDifferenceCheck::class,
        \App\HealthChecks\DuplicateJournalCheck::class,
        // Add your custom health checks here
    ],

    /*
    |--------------------------------------------------------------------------
    | Middleware Configuration
    |--------------------------------------------------------------------------
    |
    | Applied to all health dashboard routes for security and access control.
    |
    */
    'middleware' => ['web'], // Add 'auth' or custom middleware

    /*
    |--------------------------------------------------------------------------
    | Route Configuration
    |--------------------------------------------------------------------------
    |
    | Customize the URL prefix for the health dashboard.
    |
    */
    'route' => 'health', // Accessible at /health
];
```

📝 Creating Health Checks
------------------------

[](#-creating-health-checks)

### Method 1: Extend AbstractCheck (Recommended)

[](#method-1-extend-abstractcheck-recommended)

Create a check class by extending the `AbstractCheck` base class:

```