@dskripchenko/laravel-admin

中文文档
1.69.1发布于 2026/11/01MITTypeScriptESM + CJS

Vue 3 admin-panel constructor: SPA bundle для Laravel-приложений на @dskripchenko/laravel-admin (PHP backend) — JSON-driven Field/Layout/Infolist/Widget renderer'ы поверх @dskripchenko/ui design system.

原始使用文档
文档目录7 节
  1. What's inside
  2. Install
  3. Documentation
  4. Stack
  5. Sister-packs
  6. Contributing
  7. License

dskripchenko/laravel-admin

🌐 English · Русский · Deutsch · 中文

A Laravel admin-panel constructor inspired by Orchid, with a Vue 3 SPA frontend.

npm Packagist License

Live demo: laravel-admin.dskripchenko.space — a shop and a blog with a few thousand records, a showcase where every field, layout and action shows its own source, and this documentation inside the panel. No sign-up: pick Administrator, Editor or Viewer on the login page; the data resets every hour.

Admin::resources([UserResource::class, ArticleResource::class]);
Admin::screen([ContactScreen::class, SystemStatusScreen::class]);
Admin::menu()->add(
    MenuNode::make('content', 'Content')->icon('book')->children([
        MenuNode::resource('articles'),
        MenuNode::dashboard('analytics'),
    ]),
);

What's inside

  • CRUD pipeline — declare an Eloquent model as a Resource, get list/create/edit/view screens for free.
  • Custom Screens — non-CRUD pages (forms, dashboards, reports) with Admin::screen(). Handles state, layout, command-bar, validation, permissions.
  • Hierarchical menu — fluent Admin::menu()->add(MenuNode::...), any depth, auto-resolve resource()/screen()/dashboard().
  • 30+ field types — Input/Number/Select/Combobox/DatePicker/ ColorPicker/FileUpload/Wysiwyg/Markdown/TranslatableInput/Repeater/ RelationSelect/Cascader/TreeSelect/Slug/KeyValue/TagsInput/...
  • 15+ layouts — Rows/Columns/Tabs/Wizard+Step/Block/Modal/Drawer/ Wrapper/Infolist/Dashboard/Accordion/View/...
  • Tables — sortable columns, presets, filters (input/date/switcher/ options/select-from-model), inline-edit, summary, saved views, group-by, polling, exports (CSV/XLSX/PDF).
  • Dashboard — 8 widget types (Stats/Chart/RecentList/Markdown/ Iframe/Table/Heatmap/Gauge), per-user layout overrides, drag/resize, polling.
  • Auth & RBAC — multi-guard; a separate admin_users table or your existing users (shared strategy), roles, 2FA TOTP, profile, impersonation, password reset, email verification.
  • Audit — append-only log of admin actions (AuditLog + Loggable trait).
  • Settings — singleton-style configuration screens.
  • Notifications — bell badge + drawer (Database notifications).
  • API tokens — Sanctum integration in Profile (conditional).
  • Theming — light/dark + per-user preference, @dskripchenko/ui design tokens.
  • i18n — locale resolver (6-step priority), TranslatableField bridge for dskripchenko/laravel-translatable.
  • Tenancy — TenantResolver / TenantContext / TenantScoped trait. Strategy is host-side; we provide the contract.
  • Plugins — AdminPlugin interface; sister-packs use the same hook.
  • Testing — AdminTestCase, ActsAsAdmin and InteractsWithAdminResources traits.
  • OpenAPI 3.0 — generated from docblock @input/@output tags.

Install

composer require dskripchenko/laravel-admin
php artisan admin:install

That's it — the admin SPA ships prebuilt, no Node needed. Visit /admin/login. Getting started walks through the first resource and the custom-build mode for your own Vue components.

Adding it to an application that already has users, its own API or a proxy? Read Adding the admin to an existing application — including admin:install --shared, which lets your existing users sign in.

Documentation

Stack

  • PHP ^8.2
  • Laravel 11 / 12 / 13
  • Vue ^3.4 + TypeScript + Pinia + Vue Router
  • Frontend — prebuilt SPA ~350 KB gz JS + ~35 KB gz CSS; the npm library entry for custom builds ~260 KB gz (Vue, Pinia and the UI kit external)
  • WYSIWYG — @dskripchenko/wysiwyg by default; Quill and TinyMCE adapters ship in the npm package (/quill, /tinymce)

Sister-packs

Optional extensions, install only what you need:

PackagePurpose
dskripchenko/laravel-admin-starterUser, Role and Audit Log resources
dskripchenko/laravel-admin-mediaMedia library (no Spatie/medialibrary dependency)
dskripchenko/laravel-admin-healthHealth checks (no Spatie/laravel-health dependency)
dskripchenko/laravel-admin-pulseTelemetry sampler (no laravel/pulse dependency)
dskripchenko/laravel-admin-jobsFailed jobs / batches viewer

Contributing

See CONTRIBUTING.md. PRs welcome.

License

MIT © Denis Skripchenko

版本与发布记录

@dskripchenko/laravel-admin 共发布 166 个版本,首次发布于 2026/05/02;过去 12 个月发布了 166 个版本。

版本发布日期距今
1.69.1latest2026/11/012 天前
1.69.02026/11/012 天前
1.68.02026/11/012 天前
1.67.02026/11/012 天前
1.66.02026/11/012 天前
1.65.02026/11/012 天前

关于 @dskripchenko/laravel-admin 的常见问题

@dskripchenko/laravel-admin 是什么?

Vue 3管理面板构造器:SPA bundle для Laravel-приложений на @dskripchenko/ Laravel- admin (PHP后端)- json驱动的字段/布局/Infolist/小部件渲染器' patrik поверх @dskripchenko/ui设计系统。

如何安装 @dskripchenko/laravel-admin?

在项目目录运行 npm install @dskripchenko/laravel-admin,或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖:vue(^3.4)、axios(^1.6)、pinia(^2.1 || ^3.0)、vue-router(^4.3 || ^5.0)、@dskripchenko/ui(^1.21.0)、@dskripchenko/wysiwyg(^0.6.0)。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖,Yarn 需要手动安装。

@dskripchenko/laravel-admin 支持 TypeScript 吗?

支持。包内自带 TypeScript 类型声明(package.json 声明了 types 入口),安装后即可获得类型提示,无需再安装 @types 包。

@dskripchenko/laravel-admin 支持 ESM 还是 CommonJS?

同时提供 ES Module 与 CommonJS 入口,import 和 require() 都可以使用,打包工具会自动选择合适的版本。

@dskripchenko/laravel-admin 需要什么版本的 Node.js?

package.json 的 engines 字段要求 Node.js >=20。版本不符时 npm 默认只给出警告,开启 engine-strict 后会拒绝安装。

@dskripchenko/laravel-admin 可以商用吗?

@dskripchenko/laravel-admin 使用 MIT 许可。宽松许可:允许商业使用、修改和再分发,通常只需在分发时保留原版权与许可声明。以上为概括,不构成法律意见,请以许可原文为准。

@dskripchenko/laravel-admin 还在维护吗?

最新版本 1.69.1 发布于 2026/11/01(2 天前);至今共发布 166 个版本,其中过去 12 个月发布了 166 个;首次发布于 2026/05/02。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。