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.5(1mo ago)2781MITPHPPHP ^8.2

Since Feb 15Pushed 1mo 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 3d ago

READMEChangelogDependencies (29)Versions (39)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.

Production Deployment
---------------------

[](#production-deployment)

During a production deploy, cache entity definitions alongside Laravel's own caches:

```
php artisan config:cache
php artisan route:cache
php artisan bpadmin:cache   # pre-builds entity manifest → bootstrap/cache/bpadmin-entities.php
```

Without `bpadmin:cache`, every request walks the filesystem to discover entity classes. This is fine locally, but in production it adds measurable overhead and triggers a boot-time log warning to remind you to run the cache command.

To clear the entity manifest (e.g. during rollback or after removing an entity):

```
php artisan bpadmin:cache --clear
```

License
-------

[](#license)

MIT

###  Health Score

51

—

FairBetter than 95% of packages

Maintenance90

Actively maintained with recent releases

Popularity12

Limited adoption so far

Community12

Small or concentrated contributor base

Maturity78

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

Recently: every ~6 days

Total

37

Last Release

53d ago

Major Versions

0.3.0 → 1.02022-12-17

1.0.12 → 2.0.02024-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 (58 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.8M228](/packages/backpack-crud)[unopim/unopim

UnoPim Laravel PIM

10.8k2.5k](/packages/unopim-unopim)[code16/sharp

Laravel Content Management Framework

79466.1k10](/packages/code16-sharp)[leantime/leantime

Open source project management system for non-project managers. Simple like Trello, powerful like Jira. Built with neurodiversity in mind.

11.3k4.0k](/packages/leantime-leantime)[october/rain

October Rain Library

1601.7M103](/packages/october-rain)[dcat-plus/laravel-admin

dcat-plus admin

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

PHPackages © 2026

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