PHPackages                             black-paradise/laravel-admin - 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. black-paradise/laravel-admin

ActiveLibrary[Admin Panels](/categories/admin)

black-paradise/laravel-admin
============================

Laravel adapter for BPAdmin — config-driven CRUD admin panel (v3)

3.0.3(3w ago)2721MITPHPPHP ^8.2

Since Feb 15Pushed 3w ago1 watchersCompare

[ Source](https://github.com/BlackRider666/bp-laravel-admin)[ Packagist](https://packagist.org/packages/black-paradise/laravel-admin)[ RSS](/packages/black-paradise-laravel-admin/feed)WikiDiscussions master Synced 3w ago

READMEChangelogDependencies (16)Versions (37)Used By (1)

BPAdmin — Laravel Adapter (v3)
==============================

[](#bpadmin--laravel-adapter-v3)

Laravel 11/12/13 adapter for BPAdmin v3. Provides Eloquent repository/mutator, CRUD controllers, service provider, and route wiring. Requires `bp-admin-core` (pure PHP domain layer).

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

[](#installation)

```
composer require black-paradise/laravel-admin
```

Publish the config:

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

Scaffold entity definition stubs:

```
php artisan bpadmin:install
```

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

[](#configuration)

All options live in `config/bpadmin.php`. Key keys:

KeyDefaultDescription`prefix``'admin'`URL prefix for all admin routes`middleware``['web']`Middleware applied to all admin routes`guard``'web'`Laravel auth guard`storage_disk``'public'`Filesystem disk for file uploads`per_page``15`Default pagination sizeMiddleware & CSRF
---------------------

[](#middleware--csrf)

BPAdmin routes use `config('bpadmin.middleware', ['web'])`. The default `web`middleware group includes `VerifyCsrfToken`. **If you override `bpadmin.middleware`, preserve `VerifyCsrfToken`** — using only `api` will silently strip CSRF protection from every admin form (login, create, update, delete).

To add custom middleware while keeping CSRF, append rather than replace: `config(['bpadmin.middleware' => ['web', 'auth.custom']])`.

Entity Definitions
------------------

[](#entity-definitions)

Create `App\BPAdmin\{Name}` classes extending `EntityDefinition`:

```
use BlackParadise\CoreAdmin\EntityDefinition;
use BlackParadise\CoreAdmin\Domain\Fields\TextField;
use BlackParadise\CoreAdmin\Domain\Fields\BooleanField;

class Users extends EntityDefinition
{
    public string $model = \App\Models\User::class;

    public function fields(): array
    {
        return [
            TextField::make('name')->required()->searchable(),
            TextField::make('email')->required(),
            BooleanField::make('is_active'),
        ];
    }
}
```

`DashboardServiceProvider` auto-discovers all `EntityDefinition` subclasses in `app/BPAdmin/` at boot.

License
-------

[](#license)

MIT

###  Health Score

52

—

FairBetter than 96% of packages

Maintenance94

Actively maintained with recent releases

Popularity13

Limited adoption so far

Community12

Small or concentrated contributor base

Maturity77

Established project with proven stability

 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 ~57 days

Recently: every ~1 days

Total

35

Last Release

27d ago

Major Versions

0.3.0 → 1.02022-12-17

1.0.12 → 2.0.12024-04-12

v2.x-dev → v3.x-dev2026-05-31

### Community

Maintainers

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

---

Top Contributors

[![BlackRider666](https://avatars.githubusercontent.com/u/11577778?v=4)](https://github.com/BlackRider666 "BlackRider666 (56 commits)")

###  Code Quality

TestsPest

Static AnalysisPHPStan, Rector

Code StyleLaravel Pint

Type Coverage Yes

### Embed Badge

![Health badge](/badges/black-paradise-laravel-admin/health.svg)

```
[![Health](https://phpackages.com/badges/black-paradise-laravel-admin/health.svg)](https://phpackages.com/packages/black-paradise-laravel-admin)
```

###  Alternatives

[backpack/crud

Quickly build admin interfaces using Laravel, Bootstrap and JavaScript.

3.4k3.7M222](/packages/backpack-crud)[unopim/unopim

UnoPim Laravel PIM

10.5k2.4k](/packages/unopim-unopim)[october/rain

October Rain Library

1601.7M83](/packages/october-rain)[code16/sharp

Laravel Content Management Framework

79164.7k8](/packages/code16-sharp)[eveseat/web

SeAT Web Interface

2623.5k158](/packages/eveseat-web)[dcat-plus/laravel-admin

dcat-plus admin

1474.0k10](/packages/dcat-plus-laravel-admin)

PHPackages © 2026

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