PHPackages                             elmekadem/architector-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. elmekadem/architector-admin

ActiveLibrary[Admin Panels](/categories/admin)

elmekadem/architector-admin
===========================

A powerful Laravel admin dashboard generator with automatic Tailwind UI scaffolding, API-driven CRUD operations, and dynamic entity management

v2.0.1(2mo ago)019MITPHPPHP ^8.2

Since Mar 27Pushed 2mo agoCompare

[ Source](https://github.com/Adam-Elmekadem/architector-admin-package)[ Packagist](https://packagist.org/packages/elmekadem/architector-admin)[ RSS](/packages/elmekadem-architector-admin/feed)WikiDiscussions main Synced 3w ago

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

Architector Admin
=================

[](#architector-admin)

Architector Admin is a Laravel package that provisions an admin-ready backend and scaffolds a React frontend through a single setup command.

The package is designed for teams that want a fast and repeatable admin bootstrap flow with Sanctum-based authentication and a generated frontend starter.

Highlights
----------

[](#highlights)

- Single setup entrypoint: `php artisan admin:setup`
- Roles and permissions scaffold: `php artisan admin:roles`
- Migration CRUD backend generator: `php artisan admin:generate-entity`
- Interactive or non-interactive setup
- Admin user create/login verification flow
- Sanctum token issuance
- API auth endpoint provisioning (`/api/auth/login`, `/api/auth/logout`, `/api/auth/me`)
- Migration-driven CRUD generation (entities discovered from migrations)
- Auto-generated CRUD controller/routes plus React CRUD modals and forms
- Validation auto-generation from migration/schema metadata
- Relationship detection with belongsTo metadata and select options
- React frontend scaffold (Vite + Tailwind v4 + Redux Toolkit + Router + Axios + React Icons)
- Safe regeneration using `--force`

Release Docs
------------

[](#release-docs)

- Changelog: `CHANGELOG.md`
- Current release note: `docs/releases/V1.3.3.md`

Requirements
------------

[](#requirements)

- PHP 8.2+
- Laravel 12+
- Composer
- Node.js 18+

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

[](#installation)

```
composer require elmekadem/architector-admin
```

Laravel package discovery registers the provider automatically.

Available Commands
------------------

[](#available-commands)

```
php artisan admin:setup
php artisan admin:roles
php artisan admin:generate-entity
```

Recommended flow is still `admin:setup` first, then `admin:roles` when you need role-based protection.

Command Options
---------------

[](#command-options)

```
php artisan admin:setup \
  [--frontend-path=frontend] \
  [--force] \
  [--skip-frontend]
```

- `--frontend-path`: output directory for generated React app (default: `frontend`)
- `--force`: overwrite generated files
- `--skip-frontend`: complete backend/auth setup without frontend generation

What `admin:setup` Does
-----------------------

[](#what-adminsetup-does)

1. Ensures `routes/api.php` exists
2. Creates or validates an admin user
3. Issues a Sanctum token
4. Ensures API auth controller exists at `app/Http/Controllers/Api/AuthController.php`
5. Ensures auth routes exist in `routes/api.php`
6. Generates migration-driven CRUD backend components:

- `app/Http/Controllers/AdminDashboardCrudController.php`
- `app/Support/AdminDashboard/FieldResolver.php`
- `app/Support/AdminDashboard/EntityTableResolver.php`
- `app/Support/AdminDashboard/CrudPayloadBuilder.php`
- `/api/admin-dashboard/*` entity/schema/records routes

7. Writes/updates `config/admin_dashboard.php`
8. Generates React frontend files (unless `--skip-frontend`), including CRUD table views and create/edit modals based on detected entity schemas

Generated Frontend Stack
------------------------

[](#generated-frontend-stack)

- React 18
- Vite 7
- Tailwind CSS v4
- Redux Toolkit + React Redux
- React Router DOM
- Axios
- React Icons

Generated Frontend Structure
----------------------------

[](#generated-frontend-structure)

Default output path: `frontend`

```
frontend/
  package.json
  vite.config.js
  index.html
  .env.example
  src/
    main.jsx
    App.jsx
    api.js
    styles.css
    app/store.js
    components/EntitySidebar.jsx
    features/auth/authSlice.js
    pages/LoginPage.jsx

```

Quick Start
-----------

[](#quick-start)

```
# 1) Run setup
php artisan admin:setup

# 2) Install frontend deps
cd frontend
npm install

# 3) Start frontend dev server
npm run dev

# 4) Start Laravel backend (separate terminal)
php artisan serve
```

Non-Interactive Setup (CI / Automation)
---------------------------------------

[](#non-interactive-setup-ci--automation)

```
php artisan admin:setup --no-interaction --force --frontend-path=frontend
```

Optional environment variables used by non-interactive mode:

- `ADMIN_SETUP_EMAIL` (default: `admin@example.com`)
- `ADMIN_SETUP_NAME` (default: `Admin User`)
- `ADMIN_SETUP_PASSWORD` (default: `admin12345`)

API Endpoints
-------------

[](#api-endpoints)

Auth endpoints provisioned by setup:

- `POST /api/auth/login`
- `POST /api/auth/logout` (requires Sanctum auth)
- `GET /api/auth/me` (requires Sanctum auth)

Generated frontend also targets admin dashboard endpoints under:

- `/api/admin-dashboard/...`

Roles and Permissions
---------------------

[](#roles-and-permissions)

Generate baseline role management scaffolding:

```
php artisan admin:roles
```

This command generates:

- Roles: `admin`, `editor`, `user`
- Permissions: `create`, `edit`, `delete`
- Seeder: `database/seeders/AdminRolesSeeder.php`
- Middleware: `App\Http\Middleware\AdminRolePermissionMiddleware`
- Middleware alias: `admin.role` in `bootstrap/app.php`

Route usage examples:

```
Route::middleware(['auth:sanctum', 'admin.role:role:admin'])->group(function () {
  // admin-only routes
});

Route::middleware(['auth:sanctum', 'admin.role:permission:edit'])->group(function () {
  // editor/admin routes with edit permission
});
```

Publishing Assets (Optional)
----------------------------

[](#publishing-assets-optional)

```
php artisan vendor:publish --provider="Elmekadem\ArchitectorAdmin\Providers\ArchitectorServiceProvider"
```

Available tags:

- `architector-views`
- `architector-stubs`
- `architector-config`
- `architector-migrations`
- `architector`

Troubleshooting
---------------

[](#troubleshooting)

### Command not found: `admin:setup`

[](#command-not-found-adminsetup)

Run:

```
composer dump-autoload
php artisan package:discover --ansi
php artisan list | findstr admin:setup
```

### Frontend files were not regenerated

[](#frontend-files-were-not-regenerated)

Use the force flag:

```
php artisan admin:setup --force
```

### Auth routes/controller not created as expected

[](#auth-routescontroller-not-created-as-expected)

Run setup again with force:

```
php artisan admin:setup --force
```

Then verify:

- `app/Http/Controllers/Api/AuthController.php`
- `routes/api.php`

Versioning
----------

[](#versioning)

The package is released with semantic version tags.

License
-------

[](#license)

MIT

###  Health Score

39

—

LowBetter than 85% of packages

Maintenance83

Actively maintained with recent releases

Popularity6

Limited adoption so far

Community6

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

12

Last Release

85d ago

Major Versions

V1.3.3 → v2.0.12026-03-31

### Community

Maintainers

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

---

Top Contributors

[![Adam-Elmekadem](https://avatars.githubusercontent.com/u/187334629?v=4)](https://github.com/Adam-Elmekadem "Adam-Elmekadem (27 commits)")

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/elmekadem-architector-admin/health.svg)

```
[![Health](https://phpackages.com/badges/elmekadem-architector-admin/health.svg)](https://phpackages.com/packages/elmekadem-architector-admin)
```

###  Alternatives

[backpack/crud

Quickly build admin interfaces using Laravel, Bootstrap and JavaScript.

3.4k3.6M217](/packages/backpack-crud)[unopim/unopim

UnoPim Laravel PIM

10.3k2.2k](/packages/unopim-unopim)

PHPackages © 2026

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