admin-lte 4.0.1 → 4.0.4

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (110) hide show
  1. package/ACCESSIBILITY-COMPLIANCE.md +60 -339
  2. package/CHANGELOG.md +53 -0
  3. package/README.md +15 -2
  4. package/dist/css/adminlte.css +24 -786
  5. package/dist/css/adminlte.css.map +1 -1
  6. package/dist/css/adminlte.min.css +2 -2
  7. package/dist/css/adminlte.min.css.map +1 -1
  8. package/dist/css/adminlte.rtl.css +24 -786
  9. package/dist/css/adminlte.rtl.css.map +1 -1
  10. package/dist/css/adminlte.rtl.min.css +2 -2
  11. package/dist/css/adminlte.rtl.min.css.map +1 -1
  12. package/dist/js/adminlte.js +233 -128
  13. package/dist/js/adminlte.js.map +1 -1
  14. package/dist/js/adminlte.min.js +2 -2
  15. package/dist/js/adminlte.min.js.map +1 -1
  16. package/package.json +30 -17
  17. package/src/scss/_callouts.scss +13 -3
  18. package/src/scss/_dropdown.scss +3 -1
  19. package/src/scss/adminlte.scss +1 -1
  20. package/src/scss/parts/_core.scss +0 -1
  21. package/src/ts/accessibility.ts +129 -69
  22. package/src/ts/adminlte.ts +1 -1
  23. package/src/ts/card-widget.ts +33 -8
  24. package/src/ts/fullscreen.ts +48 -42
  25. package/src/ts/layout.ts +2 -1
  26. package/src/ts/push-menu.ts +24 -8
  27. package/src/ts/treeview.ts +27 -1
  28. package/src/ts/util/index.ts +114 -29
  29. package/.browserslistrc +0 -17
  30. package/.prettierrc +0 -6
  31. package/CODE_OF_CONDUCT.md +0 -43
  32. package/SECURITY.md +0 -99
  33. package/dist/UI/general.html +0 -2317
  34. package/dist/UI/icons.html +0 -1126
  35. package/dist/UI/timeline.html +0 -1212
  36. package/dist/docs/browser-support.html +0 -826
  37. package/dist/docs/color-mode.html +0 -1142
  38. package/dist/docs/components/main-header.html +0 -1209
  39. package/dist/docs/components/main-sidebar.html +0 -924
  40. package/dist/docs/customization.html +0 -1080
  41. package/dist/docs/deployment.html +0 -1145
  42. package/dist/docs/faq.html +0 -1392
  43. package/dist/docs/getting-started.html +0 -991
  44. package/dist/docs/how-to-contribute.html +0 -890
  45. package/dist/docs/index.html +0 -16
  46. package/dist/docs/integrations.html +0 -1231
  47. package/dist/docs/introduction.html +0 -1008
  48. package/dist/docs/javascript/accessibility.html +0 -949
  49. package/dist/docs/javascript/card-widget.html +0 -1019
  50. package/dist/docs/javascript/direct-chat.html +0 -896
  51. package/dist/docs/javascript/fullscreen.html +0 -905
  52. package/dist/docs/javascript/layout.html +0 -908
  53. package/dist/docs/javascript/plugins-overview.html +0 -1144
  54. package/dist/docs/javascript/pushmenu.html +0 -1045
  55. package/dist/docs/javascript/treeview.html +0 -1024
  56. package/dist/docs/layout-blueprint.html +0 -1087
  57. package/dist/docs/layout.html +0 -842
  58. package/dist/docs/license.html +0 -807
  59. package/dist/docs/migration.html +0 -1149
  60. package/dist/docs/recipes.html +0 -1185
  61. package/dist/docs/rtl.html +0 -957
  62. package/dist/examples/lockscreen.html +0 -249
  63. package/dist/examples/login-v2.html +0 -282
  64. package/dist/examples/login.html +0 -272
  65. package/dist/examples/register-v2.html +0 -291
  66. package/dist/examples/register.html +0 -277
  67. package/dist/forms/elements.html +0 -1405
  68. package/dist/forms/layout.html +0 -1267
  69. package/dist/forms/validation.html +0 -1275
  70. package/dist/forms/wizard.html +0 -1410
  71. package/dist/generate/theme.html +0 -1082
  72. package/dist/index.html +0 -1745
  73. package/dist/index2.html +0 -2277
  74. package/dist/index3.html +0 -1532
  75. package/dist/layout/collapsed-sidebar-without-hover.html +0 -1144
  76. package/dist/layout/collapsed-sidebar.html +0 -1137
  77. package/dist/layout/fixed-complete.html +0 -1138
  78. package/dist/layout/fixed-footer.html +0 -1136
  79. package/dist/layout/fixed-header.html +0 -1136
  80. package/dist/layout/fixed-sidebar.html +0 -1138
  81. package/dist/layout/layout-custom-area.html +0 -1177
  82. package/dist/layout/layout-rtl.html +0 -1137
  83. package/dist/layout/logo-switch.html +0 -683
  84. package/dist/layout/sidebar-mini.html +0 -1137
  85. package/dist/layout/unfixed-sidebar.html +0 -1136
  86. package/dist/mailbox/compose.html +0 -1151
  87. package/dist/mailbox/inbox.html +0 -1509
  88. package/dist/mailbox/read.html +0 -1202
  89. package/dist/pages/404.html +0 -239
  90. package/dist/pages/500.html +0 -227
  91. package/dist/pages/calendar.html +0 -1266
  92. package/dist/pages/chat.html +0 -1427
  93. package/dist/pages/faq.html +0 -1383
  94. package/dist/pages/file-manager.html +0 -1835
  95. package/dist/pages/invoice.html +0 -1199
  96. package/dist/pages/kanban.html +0 -1439
  97. package/dist/pages/maintenance.html +0 -230
  98. package/dist/pages/pricing.html +0 -1279
  99. package/dist/pages/profile.html +0 -1382
  100. package/dist/pages/projects.html +0 -1644
  101. package/dist/pages/settings.html +0 -1387
  102. package/dist/tables/data.html +0 -1319
  103. package/dist/tables/simple.html +0 -1435
  104. package/dist/widgets/cards.html +0 -1356
  105. package/dist/widgets/info-box.html +0 -1429
  106. package/dist/widgets/small-box.html +0 -1225
  107. package/eslint.config.js +0 -82
  108. package/github-issue-response.md +0 -40
  109. package/index.html +0 -12
  110. package/netlify.toml +0 -16
package/dist/docs/customization.html DELETED
@@ -1,1080 +0,0 @@
1
- <!doctype html>
2
- <html lang="en">
3
- <head>
4
- <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
5
- <title>Customization &amp; Theming | AdminLTE 4</title>
6
-
7
- <!--begin::Theme Init (prevents flash of incorrect theme on load, #6043)-->
8
- <script>
9
- (() => {
10
- 'use strict';
11
- const STORAGE_KEY = 'lte-theme';
12
- let stored = null;
13
- try {
14
- stored = localStorage.getItem(STORAGE_KEY);
15
- } catch {
16
- // localStorage may be unavailable (private mode, sandboxed iframe).
17
- }
18
- const prefersDark = globalThis.matchMedia('(prefers-color-scheme: dark)').matches;
19
- // Mirror the resolution in _scripts.astro: explicit "dark"/"light" win,
20
- // otherwise ("auto" or unset) fall back to the OS preference.
21
- let resolved = 'light';
22
- if (stored === 'dark' || stored === 'light') {
23
- resolved = stored;
24
- } else if (prefersDark) {
25
- resolved = 'dark';
26
- }
27
- document.documentElement.setAttribute('data-bs-theme', resolved);
28
- document.documentElement.style.colorScheme = resolved;
29
- })();
30
- </script>
31
- <!--end::Theme Init-->
32
-
33
- <!--begin::Accessibility Meta Tags-->
34
- <meta name="viewport" content="width=device-width, initial-scale=1.0, user-scalable=yes" />
35
- <meta name="color-scheme" content="light dark" />
36
- <meta name="theme-color" content="#007bff" media="(prefers-color-scheme: light)" />
37
- <meta name="theme-color" content="#1a1a1a" media="(prefers-color-scheme: dark)" />
38
- <!--end::Accessibility Meta Tags-->
39
-
40
- <!--begin::Primary Meta Tags-->
41
- <meta name="title" content="Customization &amp; Theming | AdminLTE 4" />
42
- <meta name="author" content="ColorlibHQ" />
43
- <meta
44
- name="description"
45
- content="AdminLTE is a Free Bootstrap 5 Admin Dashboard, 30 example pages using Vanilla JS. Fully accessible with WCAG 2.1 AA compliance."
46
- />
47
- <meta
48
- name="keywords"
49
- 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"
50
- />
51
- <!--end::Primary Meta Tags-->
52
-
53
- <!--begin::Accessibility Features-->
54
- <!-- Skip links will be dynamically added by accessibility.js -->
55
- <meta name="supported-color-schemes" content="light dark" />
56
- <link rel="preload" href="../css/adminlte.css" as="style" />
57
- <!--end::Accessibility Features-->
58
-
59
- <!--begin::Fonts-->
60
- <link
61
- rel="stylesheet"
62
- href="https://cdn.jsdelivr.net/npm/@fontsource/source-sans-3@5.0.12/index.css"
63
- integrity="sha256-tXJfXfp6Ewt1ilPzLDtQnJV4hclT9XuaZUKyUvmyr+Q="
64
- crossorigin="anonymous"
65
- media="print"
66
- onload="this.media = 'all'"
67
- />
68
- <!--end::Fonts-->
69
-
70
- <!--begin::Third Party Plugin(OverlayScrollbars)-->
71
- <link
72
- rel="stylesheet"
73
- href="https://cdn.jsdelivr.net/npm/overlayscrollbars@2.11.0/styles/overlayscrollbars.min.css"
74
- crossorigin="anonymous"
75
- />
76
- <!--end::Third Party Plugin(OverlayScrollbars)-->
77
-
78
- <!--begin::Third Party Plugin(Bootstrap Icons)-->
79
- <link
80
- rel="stylesheet"
81
- href="https://cdn.jsdelivr.net/npm/bootstrap-icons@1.13.1/font/bootstrap-icons.min.css"
82
- crossorigin="anonymous"
83
- />
84
- <!--end::Third Party Plugin(Bootstrap Icons)-->
85
-
86
- <!--begin::Required Plugin(AdminLTE)-->
87
- <link rel="stylesheet" href="../css/adminlte.css" />
88
- <!--end::Required Plugin(AdminLTE)-->
89
- </head>
90
- <body class="layout-fixed sidebar-expand-lg bg-body-tertiary docs-page">
91
- <div class="app-wrapper">
92
- <!--begin::Header-->
93
- <nav class="app-header navbar navbar-expand bg-body">
94
- <!--begin::Container-->
95
- <div class="container-fluid">
96
- <!--begin::Start Navbar Links-->
97
- <ul class="navbar-nav">
98
- <li class="nav-item">
99
- <a class="nav-link" data-lte-toggle="sidebar" href="#" role="button">
100
- <i class="bi bi-list"></i>
101
- </a>
102
- </li>
103
-
104
- <li class="nav-item d-none d-md-block">
105
- <a href="../docs/introduction.html" class="nav-link">
106
- <i class="bi bi-book me-1" aria-hidden="true"></i>
107
- Documentation
108
- </a>
109
- </li>
110
- <li class="nav-item d-none d-md-block">
111
- <a href="../index.html" class="nav-link">
112
- <i class="bi bi-arrow-left me-1" aria-hidden="true"></i>
113
- Back to live preview
114
- </a>
115
- </li>
116
- </ul>
117
- <!--end::Start Navbar Links-->
118
-
119
- <!--begin::End Navbar Links-->
120
- <ul class="navbar-nav ms-auto">
121
- <!--begin::Navbar Search-->
122
- <li class="nav-item">
123
- <a class="nav-link" data-widget="navbar-search" href="#" role="button">
124
- <i class="bi bi-search"></i>
125
- </a>
126
- </li>
127
- <!--end::Navbar Search-->
128
-
129
- <!--begin::Messages Dropdown Menu-->
130
- <li class="nav-item dropdown">
131
- <a class="nav-link" data-bs-toggle="dropdown" href="#">
132
- <i class="bi bi-chat-text"></i>
133
- <span class="navbar-badge badge text-bg-danger">3</span>
134
- </a>
135
- <div class="dropdown-menu dropdown-menu-lg dropdown-menu-end">
136
- <a href="#" class="dropdown-item">
137
- <!--begin::Message-->
138
- <div class="d-flex">
139
- <div class="flex-shrink-0">
140
- <img
141
- src="../assets/img/user1-128x128.jpg"
142
- alt="User Avatar"
143
- class="img-size-50 rounded-circle me-3"
144
- />
145
- </div>
146
- <div class="flex-grow-1">
147
- <h3 class="dropdown-item-title">
148
- Brad Diesel
149
- <span class="float-end fs-7 text-danger"
150
- ><i class="bi bi-star-fill"></i
151
- ></span>
152
- </h3>
153
- <p class="fs-7">Call me whenever you can...</p>
154
- <p class="fs-7 text-secondary">
155
- <i class="bi bi-clock-fill me-1"></i> 4 Hours Ago
156
- </p>
157
- </div>
158
- </div>
159
- <!--end::Message-->
160
- </a>
161
- <div class="dropdown-divider"></div>
162
- <a href="#" class="dropdown-item">
163
- <!--begin::Message-->
164
- <div class="d-flex">
165
- <div class="flex-shrink-0">
166
- <img
167
- src="../assets/img/user8-128x128.jpg"
168
- alt="User Avatar"
169
- class="img-size-50 rounded-circle me-3"
170
- />
171
- </div>
172
- <div class="flex-grow-1">
173
- <h3 class="dropdown-item-title">
174
- John Pierce
175
- <span class="float-end fs-7 text-secondary">
176
- <i class="bi bi-star-fill"></i>
177
- </span>
178
- </h3>
179
- <p class="fs-7">I got your message bro</p>
180
- <p class="fs-7 text-secondary">
181
- <i class="bi bi-clock-fill me-1"></i> 4 Hours Ago
182
- </p>
183
- </div>
184
- </div>
185
- <!--end::Message-->
186
- </a>
187
- <div class="dropdown-divider"></div>
188
- <a href="#" class="dropdown-item">
189
- <!--begin::Message-->
190
- <div class="d-flex">
191
- <div class="flex-shrink-0">
192
- <img
193
- src="../assets/img/user3-128x128.jpg"
194
- alt="User Avatar"
195
- class="img-size-50 rounded-circle me-3"
196
- />
197
- </div>
198
- <div class="flex-grow-1">
199
- <h3 class="dropdown-item-title">
200
- Nora Silvester
201
- <span class="float-end fs-7 text-warning">
202
- <i class="bi bi-star-fill"></i>
203
- </span>
204
- </h3>
205
- <p class="fs-7">The subject goes here</p>
206
- <p class="fs-7 text-secondary">
207
- <i class="bi bi-clock-fill me-1"></i> 4 Hours Ago
208
- </p>
209
- </div>
210
- </div>
211
- <!--end::Message-->
212
- </a>
213
- <div class="dropdown-divider"></div>
214
- <a href="#" class="dropdown-item dropdown-footer">See All Messages</a>
215
- </div>
216
- </li>
217
- <!--end::Messages Dropdown Menu-->
218
-
219
- <!--begin::Notifications Dropdown Menu-->
220
- <li class="nav-item dropdown">
221
- <a class="nav-link" data-bs-toggle="dropdown" href="#">
222
- <i class="bi bi-bell-fill"></i>
223
- <span class="navbar-badge badge text-bg-warning">15</span>
224
- </a>
225
- <div class="dropdown-menu dropdown-menu-lg dropdown-menu-end">
226
- <span class="dropdown-item dropdown-header">15 Notifications</span>
227
- <div class="dropdown-divider"></div>
228
- <a href="#" class="dropdown-item">
229
- <i class="bi bi-envelope me-2"></i> 4 new messages
230
- <span class="float-end text-secondary fs-7">3 mins</span>
231
- </a>
232
- <div class="dropdown-divider"></div>
233
- <a href="#" class="dropdown-item">
234
- <i class="bi bi-people-fill me-2"></i> 8 friend requests
235
- <span class="float-end text-secondary fs-7">12 hours</span>
236
- </a>
237
- <div class="dropdown-divider"></div>
238
- <a href="#" class="dropdown-item">
239
- <i class="bi bi-file-earmark-fill me-2"></i> 3 new reports
240
- <span class="float-end text-secondary fs-7">2 days</span>
241
- </a>
242
- <div class="dropdown-divider"></div>
243
- <a href="#" class="dropdown-item dropdown-footer"> See All Notifications </a>
244
- </div>
245
- </li>
246
- <!--end::Notifications Dropdown Menu-->
247
-
248
- <!--begin::Fullscreen Toggle-->
249
- <li class="nav-item">
250
- <a class="nav-link" href="#" data-lte-toggle="fullscreen">
251
- <i data-lte-icon="maximize" class="bi bi-arrows-fullscreen"></i>
252
- <i data-lte-icon="minimize" class="bi bi-fullscreen-exit d-none"></i>
253
- </a>
254
- </li>
255
- <!--end::Fullscreen Toggle-->
256
-
257
- <!--begin::Color Mode Toggle (#6010)-->
258
- <li class="nav-item dropdown">
259
- <a
260
- class="nav-link"
261
- href="#"
262
- id="bd-theme"
263
- aria-label="Toggle color scheme"
264
- data-bs-toggle="dropdown"
265
- aria-expanded="false"
266
- >
267
- <i class="bi bi-sun-fill" data-lte-theme-icon="light"></i>
268
- <i class="bi bi-moon-fill d-none" data-lte-theme-icon="dark"></i>
269
- <i class="bi bi-circle-half d-none" data-lte-theme-icon="auto"></i>
270
- </a>
271
- <ul
272
- class="dropdown-menu dropdown-menu-end"
273
- aria-labelledby="bd-theme"
274
- style="--bs-dropdown-min-width: 8rem"
275
- >
276
- <li>
277
- <button
278
- type="button"
279
- class="dropdown-item d-flex align-items-center"
280
- data-bs-theme-value="light"
281
- aria-pressed="false"
282
- >
283
- <i class="bi bi-sun-fill me-2"></i>
284
- Light
285
- <i class="bi bi-check-lg ms-auto d-none"></i>
286
- </button>
287
- </li>
288
- <li>
289
- <button
290
- type="button"
291
- class="dropdown-item d-flex align-items-center"
292
- data-bs-theme-value="dark"
293
- aria-pressed="false"
294
- >
295
- <i class="bi bi-moon-fill me-2"></i>
296
- Dark
297
- <i class="bi bi-check-lg ms-auto d-none"></i>
298
- </button>
299
- </li>
300
- <li>
301
- <button
302
- type="button"
303
- class="dropdown-item d-flex align-items-center active"
304
- data-bs-theme-value="auto"
305
- aria-pressed="true"
306
- >
307
- <i class="bi bi-circle-half me-2"></i>
308
- Auto
309
- <i class="bi bi-check-lg ms-auto d-none"></i>
310
- </button>
311
- </li>
312
- </ul>
313
- </li>
314
- <!--end::Color Mode Toggle-->
315
-
316
- <!--begin::User Menu Dropdown-->
317
- <li class="nav-item dropdown user-menu">
318
- <a href="#" class="nav-link dropdown-toggle" data-bs-toggle="dropdown">
319
- <img
320
- src="../assets/img/user2-160x160.jpg"
321
- class="user-image rounded-circle shadow"
322
- alt="User Image"
323
- />
324
- <span class="d-none d-md-inline">Alexander Pierce</span>
325
- </a>
326
- <ul class="dropdown-menu dropdown-menu-lg dropdown-menu-end">
327
- <!--begin::User Image-->
328
- <li class="user-header text-bg-primary">
329
- <img
330
- src="../assets/img/user2-160x160.jpg"
331
- class="rounded-circle shadow"
332
- alt="User Image"
333
- />
334
- <p>
335
- Alexander Pierce - Web Developer
336
- <small>Member since Nov. 2023</small>
337
- </p>
338
- </li>
339
- <!--end::User Image-->
340
- <!--begin::Menu Body-->
341
- <li class="user-body">
342
- <!--begin::Row-->
343
- <div class="row">
344
- <div class="col-4 text-center">
345
- <a href="#">Followers</a>
346
- </div>
347
- <div class="col-4 text-center">
348
- <a href="#">Sales</a>
349
- </div>
350
- <div class="col-4 text-center">
351
- <a href="#">Friends</a>
352
- </div>
353
- </div>
354
- <!--end::Row-->
355
- </li>
356
- <!--end::Menu Body-->
357
- <!--begin::Menu Footer-->
358
- <li class="user-footer">
359
- <a href="#" class="btn btn-outline-secondary">Profile</a>
360
- <a href="#" class="btn btn-outline-danger float-end">Sign out</a>
361
- </li>
362
- <!--end::Menu Footer-->
363
- </ul>
364
- </li>
365
- <!--end::User Menu Dropdown-->
366
- </ul>
367
- <!--end::End Navbar Links-->
368
- </div>
369
- <!--end::Container-->
370
- </nav>
371
- <!--end::Header-->
372
- <!--begin::Sidebar (docs mode)-->
373
- <aside class="app-sidebar bg-body-secondary shadow" data-bs-theme="dark">
374
- <!--begin::Sidebar Brand-->
375
- <div class="sidebar-brand">
376
- <a href="../docs/introduction.html" class="brand-link">
377
- <img
378
- src="../assets/img/AdminLTELogo.png"
379
- alt="AdminLTE Logo"
380
- class="brand-image opacity-75 shadow"
381
- />
382
- <span class="brand-text fw-light">
383
- AdminLTE 4 <span class="opacity-75">&middot; Docs</span>
384
- </span>
385
- </a>
386
- </div>
387
- <!--end::Sidebar Brand-->
388
- <!--begin::Sidebar Wrapper-->
389
- <div class="sidebar-wrapper">
390
- <nav class="mt-2" aria-label="Documentation navigation">
391
- <!--begin::Sidebar Menu-->
392
- <ul
393
- class="nav sidebar-menu flex-column"
394
- data-lte-toggle="treeview"
395
- data-accordion="false"
396
- id="docs-navigation"
397
- >
398
- <li class="nav-header">START HERE</li>
399
- <li class="nav-item">
400
- <a href="../docs/introduction.html" class="nav-link">
401
- <i class="nav-icon bi bi-download"></i>
402
- <p>Installation</p>
403
- </a>
404
- </li>
405
- <li class="nav-item">
406
- <a href="../docs/getting-started.html" class="nav-link">
407
- <i class="nav-icon bi bi-rocket-takeoff"></i>
408
- <p>Getting Started</p>
409
- </a>
410
- </li>
411
-
412
- <li class="nav-header">FOUNDATIONS</li>
413
- <li class="nav-item">
414
- <a href="../docs/layout.html" class="nav-link">
415
- <i class="nav-icon bi bi-grip-horizontal"></i>
416
- <p>Layout Classes</p>
417
- </a>
418
- </li>
419
- <li class="nav-item">
420
- <a href="../docs/layout-blueprint.html" class="nav-link">
421
- <i class="nav-icon bi bi-diagram-3"></i>
422
- <p>Layout Blueprint</p>
423
- </a>
424
- </li>
425
- <li class="nav-item">
426
- <a href="../docs/customization.html" class="nav-link active">
427
- <i class="nav-icon bi bi-palette"></i>
428
- <p>Customization</p>
429
- </a>
430
- </li>
431
- <li class="nav-item">
432
- <a href="../docs/color-mode.html" class="nav-link">
433
- <i class="nav-icon bi bi-star-half"></i>
434
- <p>Color Mode</p>
435
- </a>
436
- </li>
437
- <li class="nav-item">
438
- <a href="../docs/rtl.html" class="nav-link">
439
- <i class="nav-icon bi bi-text-paragraph"></i>
440
- <p>RTL Support</p>
441
- </a>
442
- </li>
443
-
444
- <li class="nav-header">BUILDING</li>
445
- <li class="nav-item">
446
- <a href="../docs/recipes.html" class="nav-link">
447
- <i class="nav-icon bi bi-clipboard-check"></i>
448
- <p>Recipes</p>
449
- </a>
450
- </li>
451
- <li class="nav-item">
452
- <a href="#" class="nav-link">
453
- <i class="nav-icon bi bi-ui-checks-grid"></i>
454
- <p>
455
- Components
456
- <i class="nav-arrow bi bi-chevron-right"></i>
457
- </p>
458
- </a>
459
- <ul class="nav nav-treeview">
460
- <li class="nav-item">
461
- <a href="../docs/components/main-header.html" class="nav-link">
462
- <i class="nav-icon bi bi-circle"></i>
463
- <p>Main Header</p>
464
- </a>
465
- </li>
466
- <li class="nav-item">
467
- <a href="../docs/components/main-sidebar.html" class="nav-link">
468
- <i class="nav-icon bi bi-circle"></i>
469
- <p>Main Sidebar</p>
470
- </a>
471
- </li>
472
- </ul>
473
- </li>
474
- <li class="nav-item">
475
- <a href="#" class="nav-link">
476
- <i class="nav-icon bi bi-filetype-js"></i>
477
- <p>
478
- JavaScript Plugins
479
- <i class="nav-arrow bi bi-chevron-right"></i>
480
- </p>
481
- </a>
482
- <ul class="nav nav-treeview">
483
- <li class="nav-item">
484
- <a href="../docs/javascript/plugins-overview.html" class="nav-link">
485
- <i class="nav-icon bi bi-circle"></i>
486
- <p>Overview</p>
487
- </a>
488
- </li>
489
- <li class="nav-item">
490
- <a href="../docs/javascript/layout.html" class="nav-link">
491
- <i class="nav-icon bi bi-circle"></i>
492
- <p>Layout</p>
493
- </a>
494
- </li>
495
- <li class="nav-item">
496
- <a href="../docs/javascript/pushmenu.html" class="nav-link">
497
- <i class="nav-icon bi bi-circle"></i>
498
- <p>PushMenu</p>
499
- </a>
500
- </li>
501
- <li class="nav-item">
502
- <a href="../docs/javascript/treeview.html" class="nav-link">
503
- <i class="nav-icon bi bi-circle"></i>
504
- <p>Treeview</p>
505
- </a>
506
- </li>
507
- <li class="nav-item">
508
- <a href="../docs/javascript/card-widget.html" class="nav-link">
509
- <i class="nav-icon bi bi-circle"></i>
510
- <p>Card Widget</p>
511
- </a>
512
- </li>
513
- <li class="nav-item">
514
- <a href="../docs/javascript/direct-chat.html" class="nav-link">
515
- <i class="nav-icon bi bi-circle"></i>
516
- <p>Direct Chat</p>
517
- </a>
518
- </li>
519
- <li class="nav-item">
520
- <a href="../docs/javascript/fullscreen.html" class="nav-link">
521
- <i class="nav-icon bi bi-circle"></i>
522
- <p>Fullscreen</p>
523
- </a>
524
- </li>
525
- <li class="nav-item">
526
- <a href="../docs/javascript/accessibility.html" class="nav-link">
527
- <i class="nav-icon bi bi-circle"></i>
528
- <p>Accessibility</p>
529
- </a>
530
- </li>
531
- </ul>
532
- </li>
533
- <li class="nav-item">
534
- <a href="../docs/integrations.html" class="nav-link">
535
- <i class="nav-icon bi bi-puzzle"></i>
536
- <p>Integrations</p>
537
- </a>
538
- </li>
539
-
540
- <li class="nav-header">SHIPPING</li>
541
- <li class="nav-item">
542
- <a href="../docs/migration.html" class="nav-link">
543
- <i class="nav-icon bi bi-arrow-up-right-square"></i>
544
- <p>Migration from v3</p>
545
- </a>
546
- </li>
547
- <li class="nav-item">
548
- <a href="../docs/deployment.html" class="nav-link">
549
- <i class="nav-icon bi bi-cloud-upload"></i>
550
- <p>Deployment</p>
551
- </a>
552
- </li>
553
- <li class="nav-item">
554
- <a href="../docs/browser-support.html" class="nav-link">
555
- <i class="nav-icon bi bi-browser-chrome"></i>
556
- <p>Browser Support</p>
557
- </a>
558
- </li>
559
-
560
- <li class="nav-header">RESOURCES</li>
561
- <li class="nav-item">
562
- <a href="../docs/faq.html" class="nav-link">
563
- <i class="nav-icon bi bi-question-circle"></i>
564
- <p>FAQ</p>
565
- </a>
566
- </li>
567
- <li class="nav-item">
568
- <a href="../docs/how-to-contribute.html" class="nav-link">
569
- <i class="nav-icon bi bi-people"></i>
570
- <p>Contributing</p>
571
- </a>
572
- </li>
573
- <li class="nav-item">
574
- <a href="../docs/license.html" class="nav-link">
575
- <i class="nav-icon bi bi-patch-check"></i>
576
- <p>License</p>
577
- </a>
578
- </li>
579
- <li class="nav-item">
580
- <a
581
- href="https://github.com/ColorlibHQ/AdminLTE"
582
- target="_blank"
583
- rel="noopener"
584
- class="nav-link"
585
- >
586
- <i class="nav-icon bi bi-github"></i>
587
- <p>
588
- GitHub
589
- <i class="bi bi-box-arrow-up-right ms-1" aria-hidden="true"></i>
590
- </p>
591
- </a>
592
- </li>
593
- </ul>
594
- <!--end::Sidebar Menu-->
595
-
596
- <!-- Back to preview CTA (bottom of sidebar) -->
597
- <div class="p-3 mt-3 border-top border-secondary border-opacity-25">
598
- <a
599
- href="../index.html"
600
- class="btn btn-sm btn-outline-light w-100 d-flex align-items-center justify-content-center gap-2"
601
- >
602
- <i class="bi bi-arrow-left" aria-hidden="true"></i>
603
- Back to live preview
604
- </a>
605
- </div>
606
- </nav>
607
- </div>
608
- <!--end::Sidebar Wrapper-->
609
- </aside>
610
- <!--end::Sidebar (docs mode)-->
611
- <main class="app-main">
612
- <div class="app-content-header">
613
- <div class="container-fluid">
614
- <div class="row">
615
- <div class="col-sm-6">
616
- <h3 class="mb-0">Customization &amp; Theming</h3>
617
- </div>
618
- <div class="col-sm-6">
619
- <ol class="breadcrumb float-sm-end">
620
- <li class="breadcrumb-item"><a href="#">Docs</a></li>
621
- <li class="breadcrumb-item active" aria-current="page">Customization</li>
622
- </ol>
623
- </div>
624
- </div>
625
- </div>
626
- </div>
627
- <div class="app-content">
628
- <div class="container-fluid">
629
- <div class="row">
630
- <div class="col-12">
631
- <div class="card">
632
- <div class="card-body">
633
- <p>
634
- AdminLTE inherits Bootstrap 5.3’s CSS-custom-properties theming model and adds
635
- its own layer of SCSS variables on top. You can customize the look two ways:
636
- </p>
637
- <ol>
638
- <li>
639
- <strong>CSS custom properties</strong> — quick, no build step, works on
640
- prebuilt CSS.
641
- </li>
642
- <li>
643
- <strong>SCSS variables</strong> — slower (requires a build), but lets you
644
- change anything including grid breakpoints and sidebar width.
645
- </li>
646
- </ol>
647
- <h5 id="quick-wins-with-css-variables">Quick wins with CSS variables</h5>
648
- <p>
649
- Bootstrap and AdminLTE expose dozens of CSS custom properties on
650
- <code>:root</code>. Override them in your own stylesheet to retheme without
651
- rebuilding:
652
- </p>
653
- <pre
654
- class="astro-code dark-plus"
655
- style="background-color: #1e1e1e; color: #d4d4d4; overflow-x: auto"
656
- tabindex="0"
657
- data-language="css"
658
- ><code><span class="line"><span style="color:#D7BA7D">:root</span><span style="color:#D4D4D4">,</span></span>
659
- <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">&quot;light&quot;</span><span style="color:#D4D4D4">] {</span></span>
660
- <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&#39;s blue for purple */</span></span>
661
- <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>
662
- <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>
663
- <span class="line"><span style="color:#D4D4D4">}</span></span>
664
- <span class="line"></span>
665
- <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">&quot;dark&quot;</span><span style="color:#D4D4D4">] {</span></span>
666
- <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&#39;s default */</span></span>
667
- <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>
668
- <span class="line"><span style="color:#D4D4D4">}</span></span></code></pre>
669
- <p>
670
- Components built on <code>var(--bs-primary)</code> (most of AdminLTE’s chrome)
671
- pick this up automatically.
672
- </p>
673
- <h6 id="common-variables-worth-knowing">Common variables worth knowing</h6>
674
-
675
- <table>
676
- <thead>
677
- <tr>
678
- <th>Variable</th>
679
- <th>Default</th>
680
- <th>What it controls</th>
681
- </tr>
682
- </thead>
683
- <tbody>
684
- <tr>
685
- <td><code>--bs-primary</code></td>
686
- <td><code>#0d6efd</code></td>
687
- <td>Brand colour, used in active sidebar items, primary buttons</td>
688
- </tr>
689
- <tr>
690
- <td><code>--bs-body-bg</code></td>
691
- <td><code>#fff</code> (light) / <code>#212529</code> (dark)</td>
692
- <td>Page background</td>
693
- </tr>
694
- <tr>
695
- <td><code>--bs-body-color</code></td>
696
- <td><code>#212529</code></td>
697
- <td>Default text colour</td>
698
- </tr>
699
- <tr>
700
- <td><code>--bs-border-color</code></td>
701
- <td><code>#dee2e6</code></td>
702
- <td>All hairline borders</td>
703
- </tr>
704
- <tr>
705
- <td><code>--bs-border-radius</code></td>
706
- <td><code>.375rem</code></td>
707
- <td>Default radius for cards, buttons, inputs</td>
708
- </tr>
709
- <tr>
710
- <td><code>--bs-border-radius-lg</code></td>
711
- <td><code>.5rem</code></td>
712
- <td>Larger radius, used for modals</td>
713
- </tr>
714
- <tr>
715
- <td><code>--bs-font-sans-serif</code></td>
716
- <td><code>system-ui, ...</code></td>
717
- <td>Default font stack</td>
718
- </tr>
719
- </tbody>
720
- </table>
721
- <p>
722
- For the full list, see
723
- <a href="https://getbootstrap.com/docs/5.3/customize/css-variables/"
724
- >Bootstrap CSS variables</a
725
- >.
726
- </p>
727
- <h5 id="scss-variables">SCSS variables</h5>
728
- <p>
729
- If you’re building from source (cloned the repo or installed via npm + your
730
- own bundler), edit
731
- <a
732
- href="https://github.com/ColorlibHQ/AdminLTE/blob/master/src/scss/_variables.scss"
733
- ><code>src/scss/_variables.scss</code></a
734
- >
735
- and recompile.
736
- </p>
737
- <p>The most-overridden variables, with their defaults:</p>
738
- <pre
739
- class="astro-code dark-plus"
740
- style="background-color: #1e1e1e; color: #d4d4d4; overflow-x: auto"
741
- tabindex="0"
742
- data-language="scss"
743
- ><code><span class="line"><span style="color:#6A9955">// Sidebar</span></span>
744
- <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>
745
- <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>
746
- <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>
747
- <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>
748
- <span class="line"></span>
749
- <span class="line"><span style="color:#6A9955">// Sidebar colours (light theme)</span></span>
750
- <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>
751
- <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>
752
- <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>
753
- <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>
754
- <span class="line"></span>
755
- <span class="line"><span style="color:#6A9955">// Header</span></span>
756
- <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>
757
- <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>
758
- <span class="line"></span>
759
- <span class="line"><span style="color:#6A9955">// Transitions</span></span>
760
- <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>
761
- <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>
762
- <p>
763
- Bootstrap’s own variables (button colours, font sizes, spacing scale,
764
- breakpoints) live in
765
- <a
766
- href="https://github.com/ColorlibHQ/AdminLTE/blob/master/src/scss/_bootstrap-variables.scss"
767
- ><code>src/scss/_bootstrap-variables.scss</code></a
768
- >. All values use <code>!default</code>, so override them in your own SCSS
769
- file <em>before</em> the import:
770
- </p>
771
- <pre
772
- class="astro-code dark-plus"
773
- style="background-color: #1e1e1e; color: #d4d4d4; overflow-x: auto"
774
- tabindex="0"
775
- data-language="scss"
776
- ><code><span class="line"><span style="color:#6A9955">// my-theme.scss</span></span>
777
- <span class="line"></span>
778
- <span class="line"><span style="color:#6A9955">// 1. Your overrides FIRST</span></span>
779
- <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>
780
- <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>
781
- <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>
782
- <span class="line"></span>
783
- <span class="line"><span style="color:#6A9955">// 2. Then import AdminLTE (which imports Bootstrap)</span></span>
784
- <span class="line"><span style="color:#C586C0">@import</span><span style="color:#CE9178"> &quot;node_modules/admin-lte/src/scss/adminlte&quot;</span><span style="color:#D4D4D4">;</span></span></code></pre>
785
- <h5 id="recompiling-scss">Recompiling SCSS</h5>
786
- <p>If you cloned the repo, the build pipeline is already wired:</p>
787
- <pre
788
- class="astro-code dark-plus"
789
- style="background-color: #1e1e1e; color: #d4d4d4; overflow-x: auto"
790
- tabindex="0"
791
- data-language="bash"
792
- ><code><span class="line"><span style="color:#DCDCAA">npm</span><span style="color:#CE9178"> install</span></span>
793
- <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>
794
- <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>
795
- <p>
796
- For a project that uses AdminLTE as a dependency, point your bundler at
797
- <code>node_modules/admin-lte/src/scss/adminlte.scss</code>. Examples:
798
- </p>
799
- <pre
800
- class="astro-code dark-plus"
801
- style="background-color: #1e1e1e; color: #d4d4d4; overflow-x: auto"
802
- tabindex="0"
803
- data-language="js"
804
- ><code><span class="line"><span style="color:#6A9955">// Vite / Rollup / Webpack</span></span>
805
- <span class="line"><span style="color:#C586C0">import</span><span style="color:#CE9178"> &quot;admin-lte/src/scss/adminlte.scss&quot;</span></span></code></pre>
806
- <h5 id="custom-sidebar-branding">Custom sidebar branding</h5>
807
- <p>
808
- The <code>.sidebar-brand</code> element accepts text, an image, or both.
809
- Markup:
810
- </p>
811
- <pre
812
- class="astro-code dark-plus"
813
- style="background-color: #1e1e1e; color: #d4d4d4; overflow-x: auto"
814
- tabindex="0"
815
- data-language="html"
816
- ><code><span class="line"><span style="color:#808080">&lt;</span><span style="color:#569CD6">div</span><span style="color:#9CDCFE"> class</span><span style="color:#D4D4D4">=</span><span style="color:#CE9178">&quot;sidebar-brand&quot;</span><span style="color:#808080">&gt;</span></span>
817
- <span class="line"><span style="color:#808080"> &lt;</span><span style="color:#569CD6">a</span><span style="color:#9CDCFE"> href</span><span style="color:#D4D4D4">=</span><span style="color:#CE9178">&quot;/&quot;</span><span style="color:#9CDCFE"> class</span><span style="color:#D4D4D4">=</span><span style="color:#CE9178">&quot;brand-link&quot;</span><span style="color:#808080">&gt;</span></span>
818
- <span class="line"><span style="color:#808080"> &lt;</span><span style="color:#569CD6">img</span><span style="color:#9CDCFE"> src</span><span style="color:#D4D4D4">=</span><span style="color:#CE9178">&quot;/assets/logo.svg&quot;</span><span style="color:#9CDCFE"> alt</span><span style="color:#D4D4D4">=</span><span style="color:#CE9178">&quot;Logo&quot;</span><span style="color:#9CDCFE"> class</span><span style="color:#D4D4D4">=</span><span style="color:#CE9178">&quot;brand-image opacity-75 shadow&quot;</span><span style="color:#808080"> /&gt;</span></span>
819
- <span class="line"><span style="color:#808080"> &lt;</span><span style="color:#569CD6">span</span><span style="color:#9CDCFE"> class</span><span style="color:#D4D4D4">=</span><span style="color:#CE9178">&quot;brand-text fw-light&quot;</span><span style="color:#808080">&gt;</span><span style="color:#D4D4D4">My Dashboard</span><span style="color:#808080">&lt;/</span><span style="color:#569CD6">span</span><span style="color:#808080">&gt;</span></span>
820
- <span class="line"><span style="color:#808080"> &lt;/</span><span style="color:#569CD6">a</span><span style="color:#808080">&gt;</span></span>
821
- <span class="line"><span style="color:#808080">&lt;/</span><span style="color:#569CD6">div</span><span style="color:#808080">&gt;</span></span></code></pre>
822
- <p>
823
- To swap the logo when the sidebar collapses to its mini state, AdminLTE
824
- provides a built-in pattern — see the
825
- <a href="../layout/logo-switch.html">Logo Switch layout demo</a> for the
826
- markup.
827
- </p>
828
- <h5 id="dark-mode-customization">Dark mode customization</h5>
829
- <p>
830
- AdminLTE follows Bootstrap 5.3’s <code>data-bs-theme</code> attribute system.
831
- To customize dark-mode colours, scope your variables under
832
- <code>[data-bs-theme=&quot;dark&quot;]</code>:
833
- </p>
834
- <pre
835
- class="astro-code dark-plus"
836
- style="background-color: #1e1e1e; color: #d4d4d4; overflow-x: auto"
837
- tabindex="0"
838
- data-language="css"
839
- ><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">&quot;dark&quot;</span><span style="color:#D4D4D4">] {</span></span>
840
- <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>
841
- <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>
842
- <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>
843
- <span class="line"><span style="color:#D4D4D4">}</span></span></code></pre>
844
- <p>
845
- The <a href="color-mode.html">Color Mode</a> page covers the toggle markup and
846
- JavaScript that switches the attribute.
847
- </p>
848
- <h5 id="custom-sidebar-colour-scheme">Custom sidebar colour scheme</h5>
849
- <p>
850
- AdminLTE ships its sidebar styled for light mode, but the demos apply
851
- <code>data-bs-theme=&quot;dark&quot;</code> on <code>.app-sidebar</code> to
852
- get the dark sidebar variant against a light page. You can mix and match:
853
- </p>
854
- <pre
855
- class="astro-code dark-plus"
856
- style="background-color: #1e1e1e; color: #d4d4d4; overflow-x: auto"
857
- tabindex="0"
858
- data-language="html"
859
- ><code><span class="line"><span style="color:#6A9955">&lt;!-- Light page, dark sidebar (the demo pattern) --&gt;</span></span>
860
- <span class="line"><span style="color:#808080">&lt;</span><span style="color:#569CD6">body</span><span style="color:#9CDCFE"> class</span><span style="color:#D4D4D4">=</span><span style="color:#CE9178">&quot;bg-body-tertiary&quot;</span><span style="color:#808080">&gt;</span></span>
861
- <span class="line"><span style="color:#808080"> &lt;</span><span style="color:#569CD6">aside</span><span style="color:#9CDCFE"> class</span><span style="color:#D4D4D4">=</span><span style="color:#CE9178">&quot;app-sidebar bg-body-secondary shadow&quot;</span><span style="color:#9CDCFE"> data-bs-theme</span><span style="color:#D4D4D4">=</span><span style="color:#CE9178">&quot;dark&quot;</span><span style="color:#808080">&gt;</span></span>
862
- <span class="line"><span style="color:#D4D4D4"> ...</span></span>
863
- <span class="line"><span style="color:#808080"> &lt;/</span><span style="color:#569CD6">aside</span><span style="color:#808080">&gt;</span></span>
864
- <span class="line"><span style="color:#808080">&lt;/</span><span style="color:#569CD6">body</span><span style="color:#808080">&gt;</span></span></code></pre>
865
- <pre
866
- class="astro-code dark-plus"
867
- style="background-color: #1e1e1e; color: #d4d4d4; overflow-x: auto"
868
- tabindex="0"
869
- data-language="html"
870
- ><code><span class="line"><span style="color:#6A9955">&lt;!-- Light page, light sidebar --&gt;</span></span>
871
- <span class="line"><span style="color:#808080">&lt;</span><span style="color:#569CD6">body</span><span style="color:#9CDCFE"> class</span><span style="color:#D4D4D4">=</span><span style="color:#CE9178">&quot;bg-body-tertiary&quot;</span><span style="color:#808080">&gt;</span></span>
872
- <span class="line"><span style="color:#808080"> &lt;</span><span style="color:#569CD6">aside</span><span style="color:#9CDCFE"> class</span><span style="color:#D4D4D4">=</span><span style="color:#CE9178">&quot;app-sidebar bg-body shadow border-end&quot;</span><span style="color:#808080">&gt;</span></span>
873
- <span class="line"><span style="color:#D4D4D4"> ...</span></span>
874
- <span class="line"><span style="color:#808080"> &lt;/</span><span style="color:#569CD6">aside</span><span style="color:#808080">&gt;</span></span>
875
- <span class="line"><span style="color:#808080">&lt;/</span><span style="color:#569CD6">body</span><span style="color:#808080">&gt;</span></span></code></pre>
876
- <h5 id="compact-mode">Compact mode</h5>
877
- <p>
878
- Add <code>.compact-mode</code> to <code>.app-wrapper</code> (or anywhere up
879
- the tree) to reduce padding throughout the layout — handy for data-dense
880
- dashboards. The dimensions for compact mode come from the
881
- <code>*-compact</code> variables in <code>_variables.scss</code>.
882
- </p>
883
- <pre
884
- class="astro-code dark-plus"
885
- style="background-color: #1e1e1e; color: #d4d4d4; overflow-x: auto"
886
- tabindex="0"
887
- data-language="html"
888
- ><code><span class="line"><span style="color:#808080">&lt;</span><span style="color:#569CD6">div</span><span style="color:#9CDCFE"> class</span><span style="color:#D4D4D4">=</span><span style="color:#CE9178">&quot;app-wrapper compact-mode&quot;</span><span style="color:#808080">&gt;</span></span>
889
- <span class="line"><span style="color:#6A9955"> &lt;!-- header, sidebar, main content with tighter spacing --&gt;</span></span>
890
- <span class="line"><span style="color:#808080">&lt;/</span><span style="color:#569CD6">div</span><span style="color:#808080">&gt;</span></span></code></pre>
891
- <h5 id="when-to-recompile-vs-override-at-runtime">
892
- When to recompile vs. override at runtime
893
- </h5>
894
-
895
- <table>
896
- <thead>
897
- <tr>
898
- <th>Customization</th>
899
- <th>CSS variables</th>
900
- <th>SCSS rebuild</th>
901
- </tr>
902
- </thead>
903
- <tbody>
904
- <tr>
905
- <td>Brand colours</td>
906
- <td>✅</td>
907
- <td>✅</td>
908
- </tr>
909
- <tr>
910
- <td>Body / text colours</td>
911
- <td>✅</td>
912
- <td>✅</td>
913
- </tr>
914
- <tr>
915
- <td>Border radius</td>
916
- <td>✅</td>
917
- <td>✅</td>
918
- </tr>
919
- <tr>
920
- <td>Sidebar width</td>
921
- <td>❌ (not a CSS var)</td>
922
- <td>✅</td>
923
- </tr>
924
- <tr>
925
- <td>Breakpoint changes</td>
926
- <td>❌</td>
927
- <td>✅</td>
928
- </tr>
929
- <tr>
930
- <td>Spacing scale</td>
931
- <td>❌</td>
932
- <td>✅</td>
933
- </tr>
934
- <tr>
935
- <td>Font sizes</td>
936
- <td>partial</td>
937
- <td>✅ (full control)</td>
938
- </tr>
939
- </tbody>
940
- </table>
941
- <p>
942
- Use CSS variables for everything you can — it survives AdminLTE upgrades
943
- without merge conflicts. Reserve SCSS overrides for structural changes
944
- (sidebar width, breakpoints) that CSS variables don’t cover.
945
- </p>
946
- </div>
947
- </div>
948
- </div>
949
- </div>
950
- </div>
951
- </div>
952
- </main>
953
- <!--begin::Footer-->
954
- <footer class="app-footer">
955
- <!--begin::To the end-->
956
- <div class="float-end d-none d-sm-inline">Anything you want</div>
957
- <!--end::To the end-->
958
- <!--begin::Copyright-->
959
- <strong>
960
- Copyright &copy; 2014-2026&nbsp;
961
- <a href="https://adminlte.io" class="text-decoration-none">AdminLTE.io</a>.
962
- </strong>
963
- All rights reserved.
964
- <!--end::Copyright-->
965
- </footer>
966
- <!--end::Footer-->
967
- </div>
968
- <!--begin::Third Party Plugin(OverlayScrollbars)-->
969
- <script
970
- src="https://cdn.jsdelivr.net/npm/overlayscrollbars@2.11.0/browser/overlayscrollbars.browser.es6.min.js"
971
- crossorigin="anonymous"
972
- ></script>
973
- <!--end::Third Party Plugin(OverlayScrollbars)--><!--begin::Required Plugin(popperjs for Bootstrap 5)-->
974
- <script
975
- src="https://cdn.jsdelivr.net/npm/@popperjs/core@2.11.8/dist/umd/popper.min.js"
976
- crossorigin="anonymous"
977
- ></script>
978
- <!--end::Required Plugin(popperjs for Bootstrap 5)--><!--begin::Required Plugin(Bootstrap 5)-->
979
- <script
980
- src="https://cdn.jsdelivr.net/npm/bootstrap@5.3.7/dist/js/bootstrap.min.js"
981
- crossorigin="anonymous"
982
- ></script>
983
- <!--end::Required Plugin(Bootstrap 5)--><!--begin::Required Plugin(AdminLTE)-->
984
- <script src="../js/adminlte.js"></script>
985
- <!--end::Required Plugin(AdminLTE)--><!--begin::OverlayScrollbars Configure-->
986
- <script>
987
- const SELECTOR_SIDEBAR_WRAPPER = '.sidebar-wrapper';
988
- const Default = {
989
- scrollbarTheme: 'os-theme-light',
990
- scrollbarAutoHide: 'leave',
991
- scrollbarClickScroll: true,
992
- };
993
- document.addEventListener('DOMContentLoaded', function () {
994
- const sidebarWrapper = document.querySelector(SELECTOR_SIDEBAR_WRAPPER);
995
-
996
- // Disable OverlayScrollbars on mobile devices to prevent touch interference
997
- const isMobile = window.innerWidth <= 992;
998
-
999
- if (
1000
- sidebarWrapper &&
1001
- OverlayScrollbarsGlobal?.OverlayScrollbars !== undefined &&
1002
- !isMobile
1003
- ) {
1004
- OverlayScrollbarsGlobal.OverlayScrollbars(sidebarWrapper, {
1005
- scrollbars: {
1006
- theme: Default.scrollbarTheme,
1007
- autoHide: Default.scrollbarAutoHide,
1008
- clickScroll: Default.scrollbarClickScroll,
1009
- },
1010
- });
1011
- }
1012
- });
1013
- </script>
1014
- <!--end::OverlayScrollbars Configure--><!--begin::Color Mode Toggle (#6010)-->
1015
- <script>
1016
- (() => {
1017
- 'use strict';
1018
-
1019
- const STORAGE_KEY = 'lte-theme';
1020
-
1021
- const getStoredTheme = () => localStorage.getItem(STORAGE_KEY);
1022
- const setStoredTheme = (theme) => localStorage.setItem(STORAGE_KEY, theme);
1023
-
1024
- const prefersDark = () => globalThis.matchMedia('(prefers-color-scheme: dark)').matches;
1025
-
1026
- const getPreferredTheme = () => {
1027
- const stored = getStoredTheme();
1028
- if (stored) return stored;
1029
- return prefersDark() ? 'dark' : 'light';
1030
- };
1031
-
1032
- const setTheme = (theme) => {
1033
- const resolved = theme === 'auto' ? (prefersDark() ? 'dark' : 'light') : theme;
1034
- document.documentElement.setAttribute('data-bs-theme', resolved);
1035
- };
1036
-
1037
- setTheme(getPreferredTheme());
1038
-
1039
- const showActiveTheme = (theme) => {
1040
- // Highlight the active dropdown option
1041
- document.querySelectorAll('[data-bs-theme-value]').forEach((el) => {
1042
- el.classList.remove('active');
1043
- el.setAttribute('aria-pressed', 'false');
1044
- const check = el.querySelector('.bi-check-lg');
1045
- if (check) check.classList.add('d-none');
1046
- });
1047
- const active = document.querySelector(`[data-bs-theme-value="${theme}"]`);
1048
- if (active) {
1049
- active.classList.add('active');
1050
- active.setAttribute('aria-pressed', 'true');
1051
- const check = active.querySelector('.bi-check-lg');
1052
- if (check) check.classList.remove('d-none');
1053
- }
1054
- // Sync the topbar trigger icon
1055
- document.querySelectorAll('[data-lte-theme-icon]').forEach((icon) => {
1056
- icon.classList.toggle('d-none', icon.dataset.lteThemeIcon !== theme);
1057
- });
1058
- };
1059
-
1060
- globalThis.matchMedia('(prefers-color-scheme: dark)').addEventListener('change', () => {
1061
- const stored = getStoredTheme();
1062
- if (!stored || stored === 'auto') setTheme(getPreferredTheme());
1063
- });
1064
-
1065
- document.addEventListener('DOMContentLoaded', () => {
1066
- showActiveTheme(getPreferredTheme());
1067
- document.querySelectorAll('[data-bs-theme-value]').forEach((toggle) => {
1068
- toggle.addEventListener('click', () => {
1069
- const theme = toggle.getAttribute('data-bs-theme-value');
1070
- setStoredTheme(theme);
1071
- setTheme(theme);
1072
- showActiveTheme(theme);
1073
- });
1074
- });
1075
- });
1076
- })();
1077
- </script>
1078
- <!--end::Color Mode Toggle-->
1079
- </body>
1080
- </html>