Download the PHP package colorlibhq/adminlte-symfony without Composer

AdminLTE everywhere

Features

• 🧩 Twig Components — <twig:Adminlte:Card>, <twig:Adminlte:SmallBox>, … typed, documented, slot-aware.
• 🧭 Config-driven sidebar menu — one array in config/packages/adminlte.yaml, with automatic active-route detection and per-item security (permission).
• 🌗 SSR-safe dark mode — Bootstrap 5.3 data-bs-theme, set before first paint (no flash), persisted to localStorage, follows the OS while on auto.
• ⚡ AssetMapper-first — no Webpack Encore, no Node build required. CDN works out of the box; AssetMapper is the production path.
• 🎛️ Optional EasyAdmin theme — layer AdminLTE styling onto your EasyAdmin backend.
• 🧱 Symfony-native — AbstractBundle, autoconfigured services, PHP 8.4, strict types, PHPStan + php-cs-fixer.

Requirements

Installation

With Symfony Flex the bundle is registered automatically. Otherwise add it to config/bundles.php:

Configuration

Create config/packages/admin_lte.yaml (Symfony underscores the bundle name, so the config key is admin_lte):

Menu item keys: label, header, route, route_params, url, target, icon, badge, badge_class, permission, children.

Usage

Extend the layout from any page (this is the Symfony-idiomatic equivalent of the other ports' DashboardLayout):

A complete example lives in templates/demo/dashboard.html.twig. Wire it up:

Components (35+)

Layout — Sidebar, SidebarNavItem (recursive), Topbar, Footer, ColorModeToggle. The dashboard layout itself is {% extends '@AdminLte/layout.html.twig' %}.

Widgets — Card, SmallBox, InfoBox, Alert, Callout, Progress, ProgressGroup, Timeline + TimelineItem, ProfileCard, DescriptionBlock, Breadcrumb, Ratings, Toast, Modal, Accordion + AccordionItem, Tabs, NavNotifications, NavMessages, NavTasks, CommandPalette (⌘K).

Forms — Button, Input, Select, Textarea, InputSwitch, InputColor, InputFile.

Every component is a Twig Component:

This matches the component inventory of the Vue/React ports. A few heavy plugin wrappers (charts, datatables, rich editors) remain optional add-ons.

Dark mode

The <head> script in _color_mode_script.html.twig sets data-bs-theme before the body paints (no flash), persists the choice to localStorage, and tracks the OS preference while on auto. <twig:Adminlte:ColorModeToggle /> flips it via the exposed window.adminlteToggleColorMode(). A Stimulus alternative ships in assets/controllers/color-mode_controller.js.

Production assets (AssetMapper)

The CDN links in the layout's stylesheets/javascripts blocks make the bundle work with zero config. For production, serve assets locally:

Then override the layout blocks in your base template to emit {{ importmap('app') }} instead of the CDN tags.

EasyAdmin theme

Layer AdminLTE onto an existing EasyAdmin backend. Either copy the shipped override into your app:

…or load the assets from your DashboardController:

Note: this is an initial integration that applies AdminLTE styling to EasyAdmin's own layout. A fully restructured AdminLTE shell (sidebar/topbar/config menu) for EasyAdmin is being rolled out incrementally.

Development

License

MIT © Colorlib & AdminLTE contributors.