adminlte4
Version:
911 lines (890 loc) • 55.7 kB
HTML
<!doctype html>
<html lang="en">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
<title>Customization & Theming | AdminLTE 4</title>
<!--begin::Accessibility Meta Tags-->
<meta name="viewport" content="width=device-width, initial-scale=1.0, user-scalable=yes" />
<meta name="color-scheme" content="light dark" />
<meta name="theme-color" content="#007bff" media="(prefers-color-scheme: light)" />
<meta name="theme-color" content="#1a1a1a" media="(prefers-color-scheme: dark)" />
<!--end::Accessibility Meta Tags-->
<!--begin::Primary Meta Tags-->
<meta name="title" content="Customization & Theming | AdminLTE 4" />
<meta name="author" content="ColorlibHQ" />
<meta
name="description"
content="AdminLTE is a Free Bootstrap 5 Admin Dashboard, 30 example pages using Vanilla JS. Fully accessible with WCAG 2.1 AA compliance."
/>
<meta
name="keywords"
content="bootstrap 5, bootstrap, bootstrap 5 admin dashboard, bootstrap 5 dashboard, bootstrap 5 charts, bootstrap 5 calendar, bootstrap 5 datepicker, bootstrap 5 tables, bootstrap 5 datatable, vanilla js datatable, colorlibhq, colorlibhq dashboard, colorlibhq admin dashboard, accessible admin panel, WCAG compliant"
/>
<!--end::Primary Meta Tags-->
<!--begin::Accessibility Features-->
<!-- Skip links will be dynamically added by accessibility.js -->
<meta name="supported-color-schemes" content="light dark" />
<link rel="preload" href="../css/adminlte.css" as="style" />
<!--end::Accessibility Features-->
<!--begin::Fonts-->
<link
rel="stylesheet"
href="https://cdn.jsdelivr.net/npm/@fontsource/source-sans-3@5.0.12/index.css"
integrity="sha256-tXJfXfp6Ewt1ilPzLDtQnJV4hclT9XuaZUKyUvmyr+Q="
crossorigin="anonymous"
media="print"
onload="this.media = 'all'"
/>
<!--end::Fonts-->
<!--begin::Third Party Plugin(OverlayScrollbars)-->
<link
rel="stylesheet"
href="https://cdn.jsdelivr.net/npm/overlayscrollbars@2.11.0/styles/overlayscrollbars.min.css"
crossorigin="anonymous"
/>
<!--end::Third Party Plugin(OverlayScrollbars)-->
<!--begin::Third Party Plugin(Bootstrap Icons)-->
<link
rel="stylesheet"
href="https://cdn.jsdelivr.net/npm/bootstrap-icons@1.13.1/font/bootstrap-icons.min.css"
crossorigin="anonymous"
/>
<!--end::Third Party Plugin(Bootstrap Icons)-->
<!--begin::Required Plugin(AdminLTE)-->
<link rel="stylesheet" href="../css/adminlte.css" />
<!--end::Required Plugin(AdminLTE)-->
</head>
<body class="layout-fixed sidebar-expand-lg bg-body-tertiary docs-page">
<div class="app-wrapper">
<!--begin::Header-->
<nav class="app-header navbar navbar-expand bg-body">
<!--begin::Container-->
<div class="container-fluid">
<!--begin::Start Navbar Links-->
<ul class="navbar-nav">
<li class="nav-item">
<a class="nav-link" data-lte-toggle="sidebar" href="#" role="button">
<i class="bi bi-list"></i>
</a>
</li>
<li class="nav-item d-none d-md-block">
<a href="../docs/introduction.html" class="nav-link">
<i class="bi bi-book me-1" aria-hidden="true"></i>
Documentation
</a>
</li>
<li class="nav-item d-none d-md-block">
<a href="../index.html" class="nav-link">
<i class="bi bi-arrow-left me-1" aria-hidden="true"></i>
Back to live preview
</a>
</li>
</ul>
<!--end::Start Navbar Links-->
<!--begin::End Navbar Links-->
<ul class="navbar-nav ms-auto">
<!--begin::Navbar Search-->
<li class="nav-item">
<a class="nav-link" data-widget="navbar-search" href="#" role="button">
<i class="bi bi-search"></i>
</a>
</li>
<!--end::Navbar Search-->
<!--begin::Messages Dropdown Menu-->
<li class="nav-item dropdown">
<a class="nav-link" data-bs-toggle="dropdown" href="#">
<i class="bi bi-chat-text"></i>
<span class="navbar-badge badge text-bg-danger">3</span>
</a>
<div class="dropdown-menu dropdown-menu-lg dropdown-menu-end">
<a href="#" class="dropdown-item">
<!--begin::Message-->
<div class="d-flex">
<div class="flex-shrink-0">
<img
src="../assets/img/user1-128x128.jpg"
alt="User Avatar"
class="img-size-50 rounded-circle me-3"
/>
</div>
<div class="flex-grow-1">
<h3 class="dropdown-item-title">
Brad Diesel
<span class="float-end fs-7 text-danger"
><i class="bi bi-star-fill"></i
></span>
</h3>
<p class="fs-7">Call me whenever you can...</p>
<p class="fs-7 text-secondary">
<i class="bi bi-clock-fill me-1"></i> 4 Hours Ago
</p>
</div>
</div>
<!--end::Message-->
</a>
<div class="dropdown-divider"></div>
<a href="#" class="dropdown-item">
<!--begin::Message-->
<div class="d-flex">
<div class="flex-shrink-0">
<img
src="../assets/img/user8-128x128.jpg"
alt="User Avatar"
class="img-size-50 rounded-circle me-3"
/>
</div>
<div class="flex-grow-1">
<h3 class="dropdown-item-title">
John Pierce
<span class="float-end fs-7 text-secondary">
<i class="bi bi-star-fill"></i>
</span>
</h3>
<p class="fs-7">I got your message bro</p>
<p class="fs-7 text-secondary">
<i class="bi bi-clock-fill me-1"></i> 4 Hours Ago
</p>
</div>
</div>
<!--end::Message-->
</a>
<div class="dropdown-divider"></div>
<a href="#" class="dropdown-item">
<!--begin::Message-->
<div class="d-flex">
<div class="flex-shrink-0">
<img
src="../assets/img/user3-128x128.jpg"
alt="User Avatar"
class="img-size-50 rounded-circle me-3"
/>
</div>
<div class="flex-grow-1">
<h3 class="dropdown-item-title">
Nora Silvester
<span class="float-end fs-7 text-warning">
<i class="bi bi-star-fill"></i>
</span>
</h3>
<p class="fs-7">The subject goes here</p>
<p class="fs-7 text-secondary">
<i class="bi bi-clock-fill me-1"></i> 4 Hours Ago
</p>
</div>
</div>
<!--end::Message-->
</a>
<div class="dropdown-divider"></div>
<a href="#" class="dropdown-item dropdown-footer">See All Messages</a>
</div>
</li>
<!--end::Messages Dropdown Menu-->
<!--begin::Notifications Dropdown Menu-->
<li class="nav-item dropdown">
<a class="nav-link" data-bs-toggle="dropdown" href="#">
<i class="bi bi-bell-fill"></i>
<span class="navbar-badge badge text-bg-warning">15</span>
</a>
<div class="dropdown-menu dropdown-menu-lg dropdown-menu-end">
<span class="dropdown-item dropdown-header">15 Notifications</span>
<div class="dropdown-divider"></div>
<a href="#" class="dropdown-item">
<i class="bi bi-envelope me-2"></i> 4 new messages
<span class="float-end text-secondary fs-7">3 mins</span>
</a>
<div class="dropdown-divider"></div>
<a href="#" class="dropdown-item">
<i class="bi bi-people-fill me-2"></i> 8 friend requests
<span class="float-end text-secondary fs-7">12 hours</span>
</a>
<div class="dropdown-divider"></div>
<a href="#" class="dropdown-item">
<i class="bi bi-file-earmark-fill me-2"></i> 3 new reports
<span class="float-end text-secondary fs-7">2 days</span>
</a>
<div class="dropdown-divider"></div>
<a href="#" class="dropdown-item dropdown-footer"> See All Notifications </a>
</div>
</li>
<!--end::Notifications Dropdown Menu-->
<!--begin::Fullscreen Toggle-->
<li class="nav-item">
<a class="nav-link" href="#" data-lte-toggle="fullscreen">
<i data-lte-icon="maximize" class="bi bi-arrows-fullscreen"></i>
<i data-lte-icon="minimize" class="bi bi-fullscreen-exit d-none"></i>
</a>
</li>
<!--end::Fullscreen Toggle-->
<!--begin::Color Mode Toggle (#6010)-->
<li class="nav-item dropdown">
<a
class="nav-link"
href="#"
id="bd-theme"
aria-label="Toggle color scheme"
data-bs-toggle="dropdown"
aria-expanded="false"
>
<i class="bi bi-sun-fill" data-lte-theme-icon="light"></i>
<i class="bi bi-moon-fill d-none" data-lte-theme-icon="dark"></i>
<i class="bi bi-circle-half d-none" data-lte-theme-icon="auto"></i>
</a>
<ul
class="dropdown-menu dropdown-menu-end"
aria-labelledby="bd-theme"
style="--bs-dropdown-min-width: 8rem"
>
<li>
<button
type="button"
class="dropdown-item d-flex align-items-center"
data-bs-theme-value="light"
aria-pressed="false"
>
<i class="bi bi-sun-fill me-2"></i>
Light
<i class="bi bi-check-lg ms-auto d-none"></i>
</button>
</li>
<li>
<button
type="button"
class="dropdown-item d-flex align-items-center"
data-bs-theme-value="dark"
aria-pressed="false"
>
<i class="bi bi-moon-fill me-2"></i>
Dark
<i class="bi bi-check-lg ms-auto d-none"></i>
</button>
</li>
<li>
<button
type="button"
class="dropdown-item d-flex align-items-center active"
data-bs-theme-value="auto"
aria-pressed="true"
>
<i class="bi bi-circle-half me-2"></i>
Auto
<i class="bi bi-check-lg ms-auto d-none"></i>
</button>
</li>
</ul>
</li>
<!--end::Color Mode Toggle-->
<!--begin::User Menu Dropdown-->
<li class="nav-item dropdown user-menu">
<a href="#" class="nav-link dropdown-toggle" data-bs-toggle="dropdown">
<img
src="../assets/img/user2-160x160.jpg"
class="user-image rounded-circle shadow"
alt="User Image"
/>
<span class="d-none d-md-inline">Alexander Pierce</span>
</a>
<ul class="dropdown-menu dropdown-menu-lg dropdown-menu-end">
<!--begin::User Image-->
<li class="user-header text-bg-primary">
<img
src="../assets/img/user2-160x160.jpg"
class="rounded-circle shadow"
alt="User Image"
/>
<p>
Alexander Pierce - Web Developer
<small>Member since Nov. 2023</small>
</p>
</li>
<!--end::User Image-->
<!--begin::Menu Body-->
<li class="user-body">
<!--begin::Row-->
<div class="row">
<div class="col-4 text-center">
<a href="#">Followers</a>
</div>
<div class="col-4 text-center">
<a href="#">Sales</a>
</div>
<div class="col-4 text-center">
<a href="#">Friends</a>
</div>
</div>
<!--end::Row-->
</li>
<!--end::Menu Body-->
<!--begin::Menu Footer-->
<li class="user-footer">
<a href="#" class="btn btn-outline-secondary">Profile</a>
<a href="#" class="btn btn-outline-danger float-end">Sign out</a>
</li>
<!--end::Menu Footer-->
</ul>
</li>
<!--end::User Menu Dropdown-->
</ul>
<!--end::End Navbar Links-->
</div>
<!--end::Container-->
</nav>
<!--end::Header-->
<!--begin::Sidebar (docs mode)-->
<aside class="app-sidebar bg-body-secondary shadow" data-bs-theme="dark">
<!--begin::Sidebar Brand-->
<div class="sidebar-brand">
<a href="../docs/introduction.html" class="brand-link">
<img
src="../assets/img/AdminLTELogo.png"
alt="AdminLTE Logo"
class="brand-image opacity-75 shadow"
/>
<span class="brand-text fw-light">
AdminLTE 4 <span class="opacity-75">· Docs</span>
</span>
</a>
</div>
<!--end::Sidebar Brand-->
<!--begin::Sidebar Wrapper-->
<div class="sidebar-wrapper">
<nav class="mt-2">
<!-- Back to preview CTA -->
<div class="px-3 pb-2">
<a
href="../index.html"
class="btn btn-sm btn-outline-light w-100 d-flex align-items-center justify-content-center gap-2"
>
<i class="bi bi-arrow-left" aria-hidden="true"></i>
Back to live preview
</a>
</div>
<!--begin::Sidebar Menu-->
<ul
class="nav sidebar-menu flex-column"
data-lte-toggle="treeview"
role="navigation"
aria-label="Documentation navigation"
data-accordion="false"
id="docs-navigation"
>
<li class="nav-header">START HERE</li>
<li class="nav-item">
<a href="../docs/introduction.html" class="nav-link">
<i class="nav-icon bi bi-download"></i>
<p>Installation</p>
</a>
</li>
<li class="nav-item">
<a href="../docs/getting-started.html" class="nav-link">
<i class="nav-icon bi bi-rocket-takeoff"></i>
<p>Getting Started</p>
</a>
</li>
<li class="nav-header">FOUNDATIONS</li>
<li class="nav-item">
<a href="../docs/layout.html" class="nav-link">
<i class="nav-icon bi bi-grip-horizontal"></i>
<p>Layout Classes</p>
</a>
</li>
<li class="nav-item">
<a href="../docs/layout-blueprint.html" class="nav-link">
<i class="nav-icon bi bi-diagram-3"></i>
<p>Layout Blueprint</p>
</a>
</li>
<li class="nav-item">
<a href="../docs/customization.html" class="nav-link active">
<i class="nav-icon bi bi-palette"></i>
<p>Customization</p>
</a>
</li>
<li class="nav-item">
<a href="../docs/color-mode.html" class="nav-link">
<i class="nav-icon bi bi-star-half"></i>
<p>Color Mode</p>
</a>
</li>
<li class="nav-item">
<a href="../docs/rtl.html" class="nav-link">
<i class="nav-icon bi bi-text-paragraph"></i>
<p>RTL Support</p>
</a>
</li>
<li class="nav-header">BUILDING</li>
<li class="nav-item">
<a href="../docs/recipes.html" class="nav-link">
<i class="nav-icon bi bi-clipboard-check"></i>
<p>Recipes</p>
</a>
</li>
<li class="nav-item">
<a href="#" class="nav-link">
<i class="nav-icon bi bi-ui-checks-grid"></i>
<p>
Components
<i class="nav-arrow bi bi-chevron-right"></i>
</p>
</a>
<ul class="nav nav-treeview">
<li class="nav-item">
<a href="../docs/components/main-header.html" class="nav-link">
<i class="nav-icon bi bi-circle"></i>
<p>Main Header</p>
</a>
</li>
<li class="nav-item">
<a href="../docs/components/main-sidebar.html" class="nav-link">
<i class="nav-icon bi bi-circle"></i>
<p>Main Sidebar</p>
</a>
</li>
</ul>
</li>
<li class="nav-item">
<a href="#" class="nav-link">
<i class="nav-icon bi bi-filetype-js"></i>
<p>
JavaScript Plugins
<i class="nav-arrow bi bi-chevron-right"></i>
</p>
</a>
<ul class="nav nav-treeview">
<li class="nav-item">
<a href="../docs/javascript/plugins-overview.html" class="nav-link">
<i class="nav-icon bi bi-circle"></i>
<p>Overview</p>
</a>
</li>
<li class="nav-item">
<a href="../docs/javascript/layout.html" class="nav-link">
<i class="nav-icon bi bi-circle"></i>
<p>Layout</p>
</a>
</li>
<li class="nav-item">
<a href="../docs/javascript/pushmenu.html" class="nav-link">
<i class="nav-icon bi bi-circle"></i>
<p>PushMenu</p>
</a>
</li>
<li class="nav-item">
<a href="../docs/javascript/treeview.html" class="nav-link">
<i class="nav-icon bi bi-circle"></i>
<p>Treeview</p>
</a>
</li>
<li class="nav-item">
<a href="../docs/javascript/card-widget.html" class="nav-link">
<i class="nav-icon bi bi-circle"></i>
<p>Card Widget</p>
</a>
</li>
<li class="nav-item">
<a href="../docs/javascript/direct-chat.html" class="nav-link">
<i class="nav-icon bi bi-circle"></i>
<p>Direct Chat</p>
</a>
</li>
<li class="nav-item">
<a href="../docs/javascript/fullscreen.html" class="nav-link">
<i class="nav-icon bi bi-circle"></i>
<p>Fullscreen</p>
</a>
</li>
<li class="nav-item">
<a href="../docs/javascript/accessibility.html" class="nav-link">
<i class="nav-icon bi bi-circle"></i>
<p>Accessibility</p>
</a>
</li>
</ul>
</li>
<li class="nav-item">
<a href="../docs/integrations.html" class="nav-link">
<i class="nav-icon bi bi-puzzle"></i>
<p>Integrations</p>
</a>
</li>
<li class="nav-header">SHIPPING</li>
<li class="nav-item">
<a href="../docs/migration.html" class="nav-link">
<i class="nav-icon bi bi-arrow-up-right-square"></i>
<p>Migration from v3</p>
</a>
</li>
<li class="nav-item">
<a href="../docs/deployment.html" class="nav-link">
<i class="nav-icon bi bi-cloud-upload"></i>
<p>Deployment</p>
</a>
</li>
<li class="nav-item">
<a href="../docs/browser-support.html" class="nav-link">
<i class="nav-icon bi bi-browser-chrome"></i>
<p>Browser Support</p>
</a>
</li>
<li class="nav-header">RESOURCES</li>
<li class="nav-item">
<a href="../docs/faq.html" class="nav-link">
<i class="nav-icon bi bi-question-circle"></i>
<p>FAQ</p>
</a>
</li>
<li class="nav-item">
<a href="../docs/how-to-contribute.html" class="nav-link">
<i class="nav-icon bi bi-people"></i>
<p>Contributing</p>
</a>
</li>
<li class="nav-item">
<a href="../docs/license.html" class="nav-link">
<i class="nav-icon bi bi-patch-check"></i>
<p>License</p>
</a>
</li>
<li class="nav-item">
<a
href="https://github.com/ColorlibHQ/AdminLTE"
target="_blank"
rel="noopener"
class="nav-link"
>
<i class="nav-icon bi bi-github"></i>
<p>
GitHub
<i class="bi bi-box-arrow-up-right ms-1" aria-hidden="true"></i>
</p>
</a>
</li>
</ul>
<!--end::Sidebar Menu-->
</nav>
</div>
<!--end::Sidebar Wrapper-->
</aside>
<!--end::Sidebar (docs mode)-->
<main class="app-main">
<div class="app-content-header">
<div class="container-fluid">
<div class="row">
<div class="col-sm-6">
<h3 class="mb-0">Customization & Theming</h3>
</div>
<div class="col-sm-6">
<ol class="breadcrumb float-sm-end">
<li class="breadcrumb-item"><a href="#">Docs</a></li>
<li class="breadcrumb-item active" aria-current="page">Customization</li>
</ol>
</div>
</div>
</div>
</div>
<div class="app-content">
<div class="container-fluid">
<div class="row">
<div class="col-12">
<div class="card">
<div class="card-body">
<p>
AdminLTE inherits Bootstrap 5.3’s CSS-custom-properties theming model and adds
its own layer of SCSS variables on top. You can customize the look two ways:
</p>
<ol>
<li>
<strong>CSS custom properties</strong> — quick, no build step, works on
prebuilt CSS.
</li>
<li>
<strong>SCSS variables</strong> — slower (requires a build), but lets you
change anything including grid breakpoints and sidebar width.
</li>
</ol>
<h5 id="quick-wins-with-css-variables">Quick wins with CSS variables</h5>
<p>
Bootstrap and AdminLTE expose dozens of CSS custom properties on
<code>:root</code>. Override them in your own stylesheet to retheme without
rebuilding:
</p>
<pre
class="astro-code dark-plus"
style="background-color: #1e1e1e; color: #d4d4d4; overflow-x: auto"
tabindex="0"
data-language="css"
><code><span class="line"><span style="color:#D7BA7D">:root</span><span style="color:#D4D4D4">,</span></span>
<span class="line"><span style="color:#D4D4D4">[</span><span style="color:#9CDCFE">data-bs-theme</span><span style="color:#D4D4D4">=</span><span style="color:#CE9178">"light"</span><span style="color:#D4D4D4">] {</span></span>
<span class="line"><span style="color:#9CDCFE"> --bs-primary</span><span style="color:#D4D4D4">: </span><span style="color:#CE9178">#6610f2</span><span style="color:#D4D4D4">; </span><span style="color:#6A9955">/* swap Bootstrap's blue for purple */</span></span>
<span class="line"><span style="color:#9CDCFE"> --bs-primary-rgb</span><span style="color:#D4D4D4">: </span><span style="color:#B5CEA8">102</span><span style="color:#D4D4D4">, </span><span style="color:#B5CEA8">16</span><span style="color:#D4D4D4">, </span><span style="color:#B5CEA8">242</span><span style="color:#D4D4D4">;</span></span>
<span class="line"><span style="color:#9CDCFE"> --bs-body-bg</span><span style="color:#D4D4D4">: </span><span style="color:#CE9178">#f3f4f6</span><span style="color:#D4D4D4">;</span></span>
<span class="line"><span style="color:#D4D4D4">}</span></span>
<span class="line"></span>
<span class="line"><span style="color:#D4D4D4">[</span><span style="color:#9CDCFE">data-bs-theme</span><span style="color:#D4D4D4">=</span><span style="color:#CE9178">"dark"</span><span style="color:#D4D4D4">] {</span></span>
<span class="line"><span style="color:#9CDCFE"> --bs-body-bg</span><span style="color:#D4D4D4">: </span><span style="color:#CE9178">#14171c</span><span style="color:#D4D4D4">; </span><span style="color:#6A9955">/* darker than Bootstrap's default */</span></span>
<span class="line"><span style="color:#9CDCFE"> --bs-body-color</span><span style="color:#D4D4D4">: </span><span style="color:#CE9178">#e9ecef</span><span style="color:#D4D4D4">;</span></span>
<span class="line"><span style="color:#D4D4D4">}</span></span></code></pre>
<p>
Components built on <code>var(--bs-primary)</code> (most of AdminLTE’s chrome)
pick this up automatically.
</p>
<h6 id="common-variables-worth-knowing">Common variables worth knowing</h6>
<table>
<thead>
<tr>
<th>Variable</th>
<th>Default</th>
<th>What it controls</th>
</tr>
</thead>
<tbody>
<tr>
<td><code>--bs-primary</code></td>
<td><code>#0d6efd</code></td>
<td>Brand colour, used in active sidebar items, primary buttons</td>
</tr>
<tr>
<td><code>--bs-body-bg</code></td>
<td><code>#fff</code> (light) / <code>#212529</code> (dark)</td>
<td>Page background</td>
</tr>
<tr>
<td><code>--bs-body-color</code></td>
<td><code>#212529</code></td>
<td>Default text colour</td>
</tr>
<tr>
<td><code>--bs-border-color</code></td>
<td><code>#dee2e6</code></td>
<td>All hairline borders</td>
</tr>
<tr>
<td><code>--bs-border-radius</code></td>
<td><code>.375rem</code></td>
<td>Default radius for cards, buttons, inputs</td>
</tr>
<tr>
<td><code>--bs-border-radius-lg</code></td>
<td><code>.5rem</code></td>
<td>Larger radius, used for modals</td>
</tr>
<tr>
<td><code>--bs-font-sans-serif</code></td>
<td><code>system-ui, ...</code></td>
<td>Default font stack</td>
</tr>
</tbody>
</table>
<p>
For the full list, see
<a href="https://getbootstrap.com/docs/5.3/customize/css-variables/"
>Bootstrap CSS variables</a
>.
</p>
<h5 id="scss-variables">SCSS variables</h5>
<p>
If you’re building from source (cloned the repo or installed via npm + your
own bundler), edit
<a
href="https://github.com/ColorlibHQ/AdminLTE/blob/master/src/scss/_variables.scss"
><code>src/scss/_variables.scss</code></a
>
and recompile.
</p>
<p>The most-overridden variables, with their defaults:</p>
<pre
class="astro-code dark-plus"
style="background-color: #1e1e1e; color: #d4d4d4; overflow-x: auto"
tabindex="0"
data-language="scss"
><code><span class="line"><span style="color:#6A9955">// Sidebar</span></span>
<span class="line"><span style="color:#9CDCFE">$lte-sidebar-width</span><span style="color:#D4D4D4">: </span><span style="color:#B5CEA8">250px</span><span style="color:#D4D4D4">; </span><span style="color:#6A9955">// collapse to mini at ~70px</span></span>
<span class="line"><span style="color:#9CDCFE">$lte-sidebar-breakpoint</span><span style="color:#D4D4D4">: lg; </span><span style="color:#6A9955">// breakpoint at which sidebar starts off-canvas</span></span>
<span class="line"><span style="color:#9CDCFE">$lte-sidebar-padding-x</span><span style="color:#D4D4D4">: </span><span style="color:#B5CEA8">.5rem</span><span style="color:#D4D4D4">;</span></span>
<span class="line"><span style="color:#9CDCFE">$lte-sidebar-padding-y</span><span style="color:#D4D4D4">: </span><span style="color:#B5CEA8">.5rem</span><span style="color:#D4D4D4">;</span></span>
<span class="line"></span>
<span class="line"><span style="color:#6A9955">// Sidebar colours (light theme)</span></span>
<span class="line"><span style="color:#9CDCFE">$lte-sidebar-color</span><span style="color:#D4D4D4">: </span><span style="color:#9CDCFE">$gray-800</span><span style="color:#D4D4D4">;</span></span>
<span class="line"><span style="color:#9CDCFE">$lte-sidebar-hover-bg</span><span style="color:#D4D4D4">: </span><span style="color:#DCDCAA">rgba</span><span style="color:#D4D4D4">(</span><span style="color:#9CDCFE">$black</span><span style="color:#D4D4D4">, </span><span style="color:#B5CEA8">.1</span><span style="color:#D4D4D4">);</span></span>
<span class="line"><span style="color:#9CDCFE">$lte-sidebar-active-color</span><span style="color:#D4D4D4">: </span><span style="color:#9CDCFE">$black</span><span style="color:#D4D4D4">;</span></span>
<span class="line"><span style="color:#9CDCFE">$lte-sidebar-menu-active-bg</span><span style="color:#D4D4D4">: </span><span style="color:#DCDCAA">rgba</span><span style="color:#D4D4D4">(</span><span style="color:#9CDCFE">$black</span><span style="color:#D4D4D4">, </span><span style="color:#B5CEA8">.1</span><span style="color:#D4D4D4">);</span></span>
<span class="line"></span>
<span class="line"><span style="color:#6A9955">// Header</span></span>
<span class="line"><span style="color:#9CDCFE">$lte-app-header-height</span><span style="color:#D4D4D4">: </span><span style="color:#9CDCFE">$nav-link-height</span><span style="color:#D4D4D4"> + (</span><span style="color:#9CDCFE">$lte-app-header-link-padding-y</span><span style="color:#D4D4D4"> * </span><span style="color:#B5CEA8">2</span><span style="color:#D4D4D4">);</span></span>
<span class="line"><span style="color:#9CDCFE">$lte-app-header-bottom-border-color</span><span style="color:#D4D4D4">: </span><span style="color:#DCDCAA">var</span><span style="color:#D4D4D4">(</span><span style="color:#9CDCFE">--#{$prefix}border-color</span><span style="color:#D4D4D4">);</span></span>
<span class="line"></span>
<span class="line"><span style="color:#6A9955">// Transitions</span></span>
<span class="line"><span style="color:#9CDCFE">$lte-transition-speed</span><span style="color:#D4D4D4">: </span><span style="color:#B5CEA8">.3s</span><span style="color:#D4D4D4">;</span></span>
<span class="line"><span style="color:#9CDCFE">$lte-transition-fn</span><span style="color:#D4D4D4">: </span><span style="color:#CE9178">ease-in-out</span><span style="color:#D4D4D4">;</span></span></code></pre>
<p>
Bootstrap’s own variables (button colours, font sizes, spacing scale,
breakpoints) live in
<a
href="https://github.com/ColorlibHQ/AdminLTE/blob/master/src/scss/_bootstrap-variables.scss"
><code>src/scss/_bootstrap-variables.scss</code></a
>. All values use <code>!default</code>, so override them in your own SCSS
file <em>before</em> the import:
</p>
<pre
class="astro-code dark-plus"
style="background-color: #1e1e1e; color: #d4d4d4; overflow-x: auto"
tabindex="0"
data-language="scss"
><code><span class="line"><span style="color:#6A9955">// my-theme.scss</span></span>
<span class="line"></span>
<span class="line"><span style="color:#6A9955">// 1. Your overrides FIRST</span></span>
<span class="line"><span style="color:#9CDCFE">$primary</span><span style="color:#D4D4D4">: </span><span style="color:#CE9178">#6610f2</span><span style="color:#D4D4D4">;</span></span>
<span class="line"><span style="color:#9CDCFE">$lte-sidebar-width</span><span style="color:#D4D4D4">: </span><span style="color:#B5CEA8">280px</span><span style="color:#D4D4D4">;</span></span>
<span class="line"><span style="color:#9CDCFE">$border-radius</span><span style="color:#D4D4D4">: </span><span style="color:#B5CEA8">.25rem</span><span style="color:#D4D4D4">;</span></span>
<span class="line"></span>
<span class="line"><span style="color:#6A9955">// 2. Then import AdminLTE (which imports Bootstrap)</span></span>
<span class="line"><span style="color:#C586C0">@import</span><span style="color:#CE9178"> "node_modules/admin-lte/src/scss/adminlte"</span><span style="color:#D4D4D4">;</span></span></code></pre>
<h5 id="recompiling-scss">Recompiling SCSS</h5>
<p>If you cloned the repo, the build pipeline is already wired:</p>
<pre
class="astro-code dark-plus"
style="background-color: #1e1e1e; color: #d4d4d4; overflow-x: auto"
tabindex="0"
data-language="bash"
><code><span class="line"><span style="color:#DCDCAA">npm</span><span style="color:#CE9178"> install</span></span>
<span class="line"><span style="color:#DCDCAA">npm</span><span style="color:#CE9178"> run</span><span style="color:#CE9178"> css</span><span style="color:#6A9955"> # one-off build → dist/css/</span></span>
<span class="line"><span style="color:#DCDCAA">npm</span><span style="color:#CE9178"> run</span><span style="color:#CE9178"> watch-css-main</span><span style="color:#6A9955"> # rebuild on save during development</span></span></code></pre>
<p>
For a project that uses AdminLTE as a dependency, point your bundler at
<code>node_modules/admin-lte/src/scss/adminlte.scss</code>. Examples:
</p>
<pre
class="astro-code dark-plus"
style="background-color: #1e1e1e; color: #d4d4d4; overflow-x: auto"
tabindex="0"
data-language="js"
><code><span class="line"><span style="color:#6A9955">// Vite / Rollup / Webpack</span></span>
<span class="line"><span style="color:#C586C0">import</span><span style="color:#CE9178"> "admin-lte/src/scss/adminlte.scss"</span></span></code></pre>
<h5 id="custom-sidebar-branding">Custom sidebar branding</h5>
<p>
The <code>.sidebar-brand</code> element accepts text, an image, or both.
Markup:
</p>
<pre
class="astro-code dark-plus"
style="background-color: #1e1e1e; color: #d4d4d4; overflow-x: auto"
tabindex="0"
data-language="html"
><code><span class="line"><span style="color:#808080"><</span><span style="color:#569CD6">div</span><span style="color:#9CDCFE"> class</span><span style="color:#D4D4D4">=</span><span style="color:#CE9178">"sidebar-brand"</span><span style="color:#808080">></span></span>
<span class="line"><span style="color:#808080"> <</span><span style="color:#569CD6">a</span><span style="color:#9CDCFE"> href</span><span style="color:#D4D4D4">=</span><span style="color:#CE9178">"/"</span><span style="color:#9CDCFE"> class</span><span style="color:#D4D4D4">=</span><span style="color:#CE9178">"brand-link"</span><span style="color:#808080">></span></span>
<span class="line"><span style="color:#808080"> <</span><span style="color:#569CD6">img</span><span style="color:#9CDCFE"> src</span><span style="color:#D4D4D4">=</span><span style="color:#CE9178">"/assets/logo.svg"</span><span style="color:#9CDCFE"> alt</span><span style="color:#D4D4D4">=</span><span style="color:#CE9178">"Logo"</span><span style="color:#9CDCFE"> class</span><span style="color:#D4D4D4">=</span><span style="color:#CE9178">"brand-image opacity-75 shadow"</span><span style="color:#808080"> /></span></span>
<span class="line"><span style="color:#808080"> <</span><span style="color:#569CD6">span</span><span style="color:#9CDCFE"> class</span><span style="color:#D4D4D4">=</span><span style="color:#CE9178">"brand-text fw-light"</span><span style="color:#808080">></span><span style="color:#D4D4D4">My Dashboard</span><span style="color:#808080"></</span><span style="color:#569CD6">span</span><span style="color:#808080">></span></span>
<span class="line"><span style="color:#808080"> </</span><span style="color:#569CD6">a</span><span style="color:#808080">></span></span>
<span class="line"><span style="color:#808080"></</span><span style="color:#569CD6">div</span><span style="color:#808080">></span></span></code></pre>
<p>
To swap the logo when the sidebar collapses to its mini state, AdminLTE
provides a built-in pattern — see the
<a href="../layout/logo-switch.html">Logo Switch layout demo</a> for the
markup.
</p>
<h5 id="dark-mode-customization">Dark mode customization</h5>
<p>
AdminLTE follows Bootstrap 5.3’s <code>data-bs-theme</code> attribute system.
To customize dark-mode colours, scope your variables under
<code>[data-bs-theme="dark"]</code>:
</p>
<pre
class="astro-code dark-plus"
style="background-color: #1e1e1e; color: #d4d4d4; overflow-x: auto"
tabindex="0"
data-language="css"
><code><span class="line"><span style="color:#D4D4D4">[</span><span style="color:#9CDCFE">data-bs-theme</span><span style="color:#D4D4D4">=</span><span style="color:#CE9178">"dark"</span><span style="color:#D4D4D4">] {</span></span>
<span class="line"><span style="color:#9CDCFE"> --bs-primary</span><span style="color:#D4D4D4">: </span><span style="color:#CE9178">#4dabf7</span><span style="color:#D4D4D4">; </span><span style="color:#6A9955">/* lighter primary for dark backgrounds */</span></span>
<span class="line"><span style="color:#9CDCFE"> --lte-sidebar-color</span><span style="color:#D4D4D4">: </span><span style="color:#CE9178">#e9ecef</span><span style="color:#D4D4D4">;</span></span>
<span class="line"><span style="color:#9CDCFE"> --lte-sidebar-active-color</span><span style="color:#D4D4D4">: </span><span style="color:#CE9178">#fff</span><span style="color:#D4D4D4">;</span></span>
<span class="line"><span style="color:#D4D4D4">}</span></span></code></pre>
<p>
The <a href="color-mode.html">Color Mode</a> page covers the toggle markup and
JavaScript that switches the attribute.
</p>
<h5 id="custom-sidebar-colour-scheme">Custom sidebar colour scheme</h5>
<p>
AdminLTE ships its sidebar styled for light mode, but the demos apply
<code>data-bs-theme="dark"</code> on <code>.app-sidebar</code> to
get the dark sidebar variant against a light page. You can mix and match:
</p>
<pre
class="astro-code dark-plus"
style="background-color: #1e1e1e; color: #d4d4d4; overflow-x: auto"
tabindex="0"
data-language="html"
><code><span class="line"><span style="color:#6A9955"><!-- Light page, dark sidebar (the demo pattern) --></span></span>
<span class="line"><span style="color:#808080"><</span><span style="color:#569CD6">body</span><span style="color:#9CDCFE"> class</span><span style="color:#D4D4D4">=</span><span style="color:#CE9178">"bg-body-tertiary"</span><span style="color:#808080">></span></span>
<span class="line"><span style="color:#808080"> <</span><span style="color:#569CD6">aside</span><span style="color:#9CDCFE"> class</span><span style="color:#D4D4D4">=</span><span style="color:#CE9178">"app-sidebar bg-body-secondary shadow"</span><span style="color:#9CDCFE"> data-bs-theme</span><span style="color:#D4D4D4">=</span><span style="color:#CE9178">"dark"</span><span style="color:#808080">></span></span>
<span class="line"><span style="color:#D4D4D4"> ...</span></span>
<span class="line"><span style="color:#808080"> </</span><span style="color:#569CD6">aside</span><span style="color:#808080">></span></span>
<span class="line"><span style="color:#808080"></</span><span style="color:#569CD6">body</span><span style="color:#808080">></span></span></code></pre>
<pre
class="astro-code dark-plus"
style="background-color: #1e1e1e; color: #d4d4d4; overflow-x: auto"
tabindex="0"
data-language="html"
><code><span class="line"><span style="color:#6A9955"><!-- Light page, light sidebar --></span></span>
<span class="line"><span style="color:#808080"><</span><span style="color:#569CD6">body</span><span style="color:#9CDCFE"> class</span><span style="color:#D4D4D4">=</span><span style="color:#CE9178">"bg-body-tertiary"</span><span style="color:#808080">></span></span>
<span class="line"><span style="color:#808080"> <</span><span style="color:#569CD6">aside</span><span style="color:#9CDCFE"> class</span><span style="color:#D4D4D4">=</span><span style="color:#CE9178">"app-sidebar bg-body shadow border-end"</span><span style="color:#808080">></span></span>
<span class="line"><span style="color:#D4D4D4"> ...</span></span>
<span class="line"><span style="color:#808080"> </</span><span style="color:#569CD6">aside</span><span style="color:#808080">></span></span>
<span class="line"><span style="color:#808080"></</span><span style="color:#569CD6">body</span><span style="color:#808080">></span></span></code></pre>
<h5 id="compact-mode">Compact mode</h5>
<p>
Add <code>.compact-mode</code> to <code>.app-wrapper</code> (or anywhere up
the tree) to reduce padding throughout the layout — handy for data-dense
dashboards. The dimensions for compact mode come from the
<code>*-compact</code> variables in <code>_variables.scss</code>.
</p>
<pre
class="astro-code dark-plus"
style="background-color: #1e1e1e; color: #d4d4d4; overflow-x: auto"
tabindex="0"
data-language="html"
><code><span class="line"><span style="color:#808080"><</span><span style="color:#569CD6">div</span><span style="color:#9CDCFE"> class</span><span style="color:#D4D4D4">=</span><span style="color:#CE9178">"app-wrapper compact-mode"</span><span style="color:#808080">></span></span>
<span class="line"><span style="color:#6A9955"> <!-- header, sidebar, main content with tighter spacing --></span></span>
<span class="line"><span style="color:#808080"></</span><span style="color:#569CD6">div</span><span style="color:#808080">></span></span></code></pre>
<h5 id="when-to-recompile-vs-override-at-runtime">
When to recompile vs. override at runtime
</h5>
<table>
<thead>
<tr>
<th>Customization</th>
<th>CSS variables</th>
<th>SCSS rebuild</th>
</tr>
</thead>
<tbody>
<tr>
<td>Brand colours</td>
<td>✅</td>
<td>✅</td>
</tr>
<tr>
<td>Body / text colours</td>
<td>✅</td>
<td>✅</td>
</tr>
<tr>
<td>Border radius</td>
<td>✅</td>
<td>✅</td>
</tr>
<tr>
<td>Sidebar width</td>
<td>❌ (not a CSS var)</td>
<td>✅</td>
</tr>
<tr>
<td>Breakpoint changes</td>
<td>❌</td>
<td>✅</td>
</tr>
<tr>
<td>Spacing scale</td>
<td>❌</td>
<td>✅</td>
</tr>
<tr>
<td>Font