A React/Next.js component library that brings the AdminLTE 4 dashboard to the App Router — server-first, themeable, and free of jQuery.
What it is
adminlte-react packages the AdminLTE 4 admin theme (built on Bootstrap 5.3) as a set of typed React components: a full dashboard shell, widgets, form controls, and tool components. It is designed for the Next.js App Router and React Server Components, but works in any React 18+ application.
Design principles
- Server-first. The
DashboardLayoutis a React Server Component that computes static layout classes on the server and nests the interactive client providers inside. Presentational widgets ship as Server Components; only components that need state, effects, or browser APIs are marked'use client'. - No jQuery, no adminlte.js.Interactive behaviors (sidebar toggle, card collapse/maximize, treeview, fullscreen, command palette) are re-implemented with React state and small hooks. AdminLTE's
data-lte-togglemarkup still works via a delegated listener for any raw HTML you drop in. - Lazy plugins. Heavy third-party libraries (ApexCharts, Tabulator, Quill, Flatpickr, Tom Select, jsVectorMap) are loaded with dynamic
import()inside the components that use them, so they never enter your initial bundle. - TypeScript first. Every component, hook, context, and the menu data model is fully typed and exported.
- Dark mode built in. A
ColorModeProvidermanages light / dark / auto, drives Bootstrap'sdata-bs-theme, and persists the choice.
What's in the box
- Layout —
DashboardLayout,AuthLayout,AppContent, plus the lower-levelTopbar,Sidebar, andFooterpieces. - Widgets — stat boxes, cards, alerts, callouts, progress, ratings, timeline, profile card, navbar dropdowns, direct chat, charts, world map, and a command palette.
- Forms — inputs, select, textarea, switch, color, file, plus plugin-backed date picker and advanced select.
- Tools — modal, datatable (Tabulator), and a rich-text editor (Quill).
- Hooks & context — sidebar, color mode and command-palette contexts, plus standalone hooks for card widgets, fullscreen, treeview animation, sortable lists, and direct chat.
Requirements
- React 18 or newer and React DOM.
- Next.js 14+ in practice — the sidebar uses
next/navigationfor active-link detection and the command palette uses the Next router. - Bootstrap 5.3 JavaScript for components that rely on Bootstrap's own behavior (dropdowns, modals, tooltips, toasts).
Ready to build? Continue to Installation.