PHPackages                             neelkanthk/laravel-surveillance-ui - 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. [Admin Panels](/categories/admin)
4. /
5. neelkanthk/laravel-surveillance-ui

ActiveLaravel-package[Admin Panels](/categories/admin)

neelkanthk/laravel-surveillance-ui
==================================

Laravel Surveillance GUI provides a web based interface for Laravel Surveillance package.

1.0.0(5y ago)21702MITJavaScriptPHP &gt;=7.2

Since Nov 14Pushed 5y ago1 watchersCompare

[ Source](https://github.com/neelkanthk/laravel-surveillance-ui)[ Packagist](https://packagist.org/packages/neelkanthk/laravel-surveillance-ui)[ RSS](/packages/neelkanthk-laravel-surveillance-ui/feed)WikiDiscussions master Synced today

READMEChangelog (2)Dependencies (5)Versions (6)Used By (0)

[![Laravel Surveillance UI Logo](https://github.com/neelkanthk/repo_logos/raw/master/LaravelSurveillanceUI_small.png?raw=true)](https://github.com/neelkanthk/repo_logos/blob/master/LaravelSurveillanceUI_small.png?raw=true)

[![](https://camo.githubusercontent.com/61011409cf00eaa0be65b1bb7025761305ba437181069dcb44dbbac203a1ed10/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f762f72656c656173652f6e65656c6b616e74686b2f6c61726176656c2d7375727665696c6c616e63652d75693f7374796c653d666f722d7468652d6261646765)](https://camo.githubusercontent.com/61011409cf00eaa0be65b1bb7025761305ba437181069dcb44dbbac203a1ed10/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f762f72656c656173652f6e65656c6b616e74686b2f6c61726176656c2d7375727665696c6c616e63652d75693f7374796c653d666f722d7468652d6261646765)[![](https://camo.githubusercontent.com/f535a23e3a2e91eda32187c7e754bba0d54c4ff4ffb5d4cd32f4437b769d35dd/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f7068702d762f6e65656c6b616e74686b2f6c61726176656c2d7375727665696c6c616e63652d75692e7376673f7374796c653d666f722d7468652d6261646765)](https://camo.githubusercontent.com/f535a23e3a2e91eda32187c7e754bba0d54c4ff4ffb5d4cd32f4437b769d35dd/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f7068702d762f6e65656c6b616e74686b2f6c61726176656c2d7375727665696c6c616e63652d75692e7376673f7374796c653d666f722d7468652d6261646765)[![](https://camo.githubusercontent.com/3d574f9beaff1dff3f8892b94b1138e994ce0f5c0b5ef65108e1ee92e27775a7/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f4c61726176656c2d253345253344362e302d7265643f7374796c653d666f722d7468652d6261646765)](https://camo.githubusercontent.com/3d574f9beaff1dff3f8892b94b1138e994ce0f5c0b5ef65108e1ee92e27775a7/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f4c61726176656c2d253345253344362e302d7265643f7374796c653d666f722d7468652d6261646765)[![](https://camo.githubusercontent.com/d222ef5b8c738f207f4d8a430e4e4fbebdfcf374d9ca3d6d05b104c83324ff2e/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f73746172732f6e65656c6b616e74686b2f6c61726176656c2d7375727665696c6c616e63652d75693f7374796c653d666f722d7468652d6261646765)](https://camo.githubusercontent.com/d222ef5b8c738f207f4d8a430e4e4fbebdfcf374d9ca3d6d05b104c83324ff2e/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f73746172732f6e65656c6b616e74686b2f6c61726176656c2d7375727665696c6c616e63652d75693f7374796c653d666f722d7468652d6261646765)[![](https://camo.githubusercontent.com/abdb5d0bcd002dfb36b75d7981e36492747e46fef6843bb32944ffb1e02ad5c7/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f6973737565732f6e65656c6b616e74686b2f6c61726176656c2d7375727665696c6c616e63652d75693f7374796c653d666f722d7468652d6261646765)](https://camo.githubusercontent.com/abdb5d0bcd002dfb36b75d7981e36492747e46fef6843bb32944ffb1e02ad5c7/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f6973737565732f6e65656c6b616e74686b2f6c61726176656c2d7375727665696c6c616e63652d75693f7374796c653d666f722d7468652d6261646765)[![](https://camo.githubusercontent.com/b09eb58c098fd50e346eb4049237de37f6df563eea04e39a8687983c9cf08482/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f6c6963656e73652f6e65656c6b616e74686b2f6c61726176656c2d7375727665696c6c616e63652d75693f7374796c653d666f722d7468652d6261646765)](https://camo.githubusercontent.com/b09eb58c098fd50e346eb4049237de37f6df563eea04e39a8687983c9cf08482/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f6c6963656e73652f6e65656c6b616e74686b2f6c61726176656c2d7375727665696c6c616e63652d75693f7374796c653d666f722d7468652d6261646765)

What is Laravel Surveillance UI?
--------------------------------

[](#what-is-laravel-surveillance-ui)

Provides a Graphical UI for [Laravel Surveillance](https://github.com/neelkanthk/laravel-surveillance) and integrates within your existing application.

What is Laravel Surveillance?
-----------------------------

[](#what-is-laravel-surveillance)

Laravel Surveillance is a package to put malicious users, IP addresses and anonymous browser fingerprints under surveillance, write surveillance logs and block malicious ones from accessing the app. [Read more](https://github.com/neelkanthk/laravel-surveillance#laravel-surveillance-)

Laravel Surveillance UI Demo
----------------------------

[](#laravel-surveillance-ui-demo)

[![](https://raw.githubusercontent.com/neelkanthk/repo_logos/master/LaravelSurveillanceUi-DemoImg.jpg)](https://www.youtube.com/watch?v=G0foqT7WPeA)

Minimum Requirements
--------------------

[](#minimum-requirements)

1. Laravel 6.0
2. PHP 7.2

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

[](#installation)

```
composer require neelkanthk/laravel-surveillance-ui
```

Usage
-----

[](#usage)

Step 1: [Configure Laravel Surveillance](#step-1)
-------------------------------------------------

[](#step-1-configure-laravel-surveillance)

*NOTE:- If you have already installed `neelkanthk/laravel-surveillance` in your application then please go directly to Step 2*.

#### 1.1. Publish the migration files:

[](#11-publish-the-migration-files)

```
php artisan vendor:publish --provider="Neelkanth\Laravel\Surveillance\Providers\SurveillanceServiceProvider" --tag="migrations"
```

#### 1.2. Publish language files:

[](#12-publish-language-files)

```
php artisan vendor:publish --provider="Neelkanth\Laravel\Surveillance\Providers\SurveillanceServiceProvider" --tag="lang"
```

#### 1.3. Run the migrations

[](#13-run-the-migrations)

```
php artisan migrate
```

#### 1.4. Publish the config file (Optional):

[](#14-publish-the-config-file-optional)

```
php artisan vendor:publish --provider="Neelkanth\Laravel\Surveillance\Providers\SurveillanceServiceProvider" --tag="config"
```

[Read more about Laravel Surveillance installation](https://github.com/neelkanthk/laravel-surveillance#installation)

Step 2: [Configure Laravel Surveillance UI](#step-2)
----------------------------------------------------

[](#step-2-configure-laravel-surveillance-ui)

*The following steps will install Laravel Surveillance UI in your application*.

#### 2.1. Publish views:

[](#21-publish-views)

```
php artisan vendor:publish --provider="Neelkanth\Laravel\SurveillanceUi\Providers\SurveillanceUiServiceProvider" --tag="views"
```

#### 2.2. Publish config:

[](#22-publish-config)

```
php artisan vendor:publish --provider="Neelkanth\Laravel\SurveillanceUi\Providers\SurveillanceUiServiceProvider" --tag="config"
```

#### 2.3. Publish assets:

[](#23-publish-assets)

```
php artisan vendor:publish --provider="Neelkanth\Laravel\SurveillanceUi\Providers\SurveillanceUiServiceProvider" --tag="assets"
```

Add Middleware
--------------

[](#add-middleware)

Laravel Surveillance provides a `surveillance` middleware that can be used on any route or route group to make it eligible for surveillance.

```
Route::middleware(["surveillance"])->get('/path', function () {});
```

[Read more about middleware usage](https://github.com/neelkanthk/laravel-surveillance#middleware-usage)

Accessing the Dashboard
-----------------------

[](#accessing-the-dashboard)

The **Laravel Surveillance UI manager dashboard** can be accessed at:

The **Laravel Surveillance UI logs dashboard** can be accessed at:

Overriding and customizing the package default configuration
------------------------------------------------------------

[](#overriding-and-customizing-the-package-default-configuration)

### Customizing the route prefix

[](#customizing-the-route-prefix)

By default `surveillance/ui` route prefix is appended to the package's routes.

If you want to customize it then you can do so easily in the `config/surveillance-ui.php` file's ***prefix*** key as shown below.

```
/**
 * The prefix to be used in the surveillance ui routes
 */
"prefix" => "surveillance/ui",
```

### Customizing the route middleware

[](#customizing-the-route-middleware)

By default `web` middleware is added to the package's routes.

If you want to add more middlewares like `auth` or something else, then you can add them easily in the `config/surveillance-ui.php` file's ***middleware*** key as shown below.

```
/**
 * The middleware(s) to be used in the surveillance ui routes
 */
"middleware" => ["web", "auth"], //auth middleware added
```

### Customizing the views

[](#customizing-the-views)

After publishing the package views you can change the design as per your taste. The views are published inside your project's `resources/views/vendor/surveillance-ui` directory.

### Customizing the JS and CSS

[](#customizing-the-js-and-css)

After publishing the package assets you can tweak the JS and CSS inside your project's `public/surveillance-ui` directory.

### Replacing the default logo

[](#replacing-the-default-logo)

You can change the default CCTV logo and favicon displayed on the Surveillance Dashboard by replacing them with your own at `public/surveillance-ui/images/logo.png` and `public/surveillance-ui/images/favicon.ico`.

Contributing
------------

[](#contributing)

Pull requests are welcome. For major changes, please open an issue first to discuss what you would like to change.

Security
--------

[](#security)

If you discover any security-related issues, please email  instead of using the issue tracker.

Credits
-------

[](#credits)

- [Neelkanth Kaushik](https://github.com/neelkanthk)
- [All Contributors](../../contributors)

License
-------

[](#license)

[MIT](https://choosealicense.com/licenses/mit/)

###  Health Score

28

—

LowBetter than 52% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity18

Limited adoption so far

Community9

Small or concentrated contributor base

Maturity53

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 100% 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.

###  Release Activity

Cadence

Every ~0 days

Total

4

Last Release

2057d ago

Major Versions

v0.0.1.x-dev → 1.0.02020-11-14

### Community

Maintainers

![](https://www.gravatar.com/avatar/8d024795d1517d97c691382c2ff955cb3157ccab11222cbcb3b91d00bc2fe8c1?d=identicon)[Neelkanth Kaushik](/maintainers/Neelkanth%20Kaushik)

---

Top Contributors

[![neelkanthk](https://avatars.githubusercontent.com/u/16952465?v=4)](https://github.com/neelkanthk "neelkanthk (29 commits)")

---

Tags

access-controllaravellaravel-packagelaravel-securitylaravel-surveillancephp

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/neelkanthk-laravel-surveillance-ui/health.svg)

```
[![Health](https://phpackages.com/badges/neelkanthk-laravel-surveillance-ui/health.svg)](https://phpackages.com/packages/neelkanthk-laravel-surveillance-ui)
```

###  Alternatives

[backpack/crud

Quickly build admin interfaces using Laravel, Bootstrap and JavaScript.

3.4k3.7M223](/packages/backpack-crud)[duncanmcclean/statamic-cargo

Comprehensive e-commerce addon for Statamic. Build bespoke e-commerce sites without the complexity.

3416.7k](/packages/duncanmcclean-statamic-cargo)

PHPackages © 2026

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