admin-lte 4.0.2 → 4.1.0

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 (146) hide show
  1. package/ACCESSIBILITY-COMPLIANCE.md +60 -339
  2. package/CHANGELOG.md +66 -0
  3. package/README.md +15 -2
  4. package/dist/css/adminlte-docs.css +878 -0
  5. package/dist/css/adminlte-docs.css.map +1 -0
  6. package/dist/css/adminlte-docs.min.css +7 -0
  7. package/dist/css/adminlte-docs.min.css.map +1 -0
  8. package/dist/css/adminlte-docs.rtl.css +877 -0
  9. package/dist/css/adminlte-docs.rtl.css.map +1 -0
  10. package/dist/css/adminlte-docs.rtl.min.css +7 -0
  11. package/dist/css/adminlte-docs.rtl.min.css.map +1 -0
  12. package/dist/css/adminlte.css +1176 -2718
  13. package/dist/css/adminlte.css.map +1 -1
  14. package/dist/css/adminlte.min.css +2 -2
  15. package/dist/css/adminlte.min.css.map +1 -1
  16. package/dist/css/adminlte.rtl.css +1176 -2718
  17. package/dist/css/adminlte.rtl.css.map +1 -1
  18. package/dist/css/adminlte.rtl.min.css +2 -2
  19. package/dist/css/adminlte.rtl.min.css.map +1 -1
  20. package/dist/js/adminlte.esm.js +1365 -0
  21. package/dist/js/adminlte.esm.js.map +1 -0
  22. package/dist/js/adminlte.esm.min.js +7 -0
  23. package/dist/js/adminlte.esm.min.js.map +1 -0
  24. package/dist/js/adminlte.js +606 -310
  25. package/dist/js/adminlte.js.map +1 -1
  26. package/dist/js/adminlte.min.js +2 -2
  27. package/dist/js/adminlte.min.js.map +1 -1
  28. package/dist/js/types/accessibility.d.ts +46 -0
  29. package/dist/js/types/adminlte.d.ts +9 -0
  30. package/dist/js/types/base-component.d.ts +36 -0
  31. package/dist/js/types/card-widget.d.ts +30 -0
  32. package/dist/js/types/color-mode.d.ts +56 -0
  33. package/dist/js/types/direct-chat.d.ts +19 -0
  34. package/dist/js/types/fullscreen.d.ts +21 -0
  35. package/dist/js/types/layout.d.ts +19 -0
  36. package/dist/js/types/push-menu.d.ts +102 -0
  37. package/dist/js/types/treeview.d.ts +27 -0
  38. package/dist/js/types/util/index.d.ts +42 -0
  39. package/package.json +60 -21
  40. package/src/scss/_app-header.scss +3 -1
  41. package/src/scss/_app-main.scss +4 -0
  42. package/src/scss/_app-sidebar.scss +3 -1
  43. package/src/scss/_bootstrap-overrides.scss +60 -0
  44. package/src/scss/_callouts.scss +13 -3
  45. package/src/scss/_dropdown.scss +3 -1
  46. package/src/scss/_info-box.scss +3 -1
  47. package/src/scss/_progress-bars.scss +3 -1
  48. package/src/scss/_table.scss +4 -2
  49. package/src/scss/adminlte-docs.scss +25 -0
  50. package/src/scss/adminlte.scss +5 -4
  51. package/src/scss/pages/_login_and_register.scss +3 -1
  52. package/src/scss/parts/_core.scss +0 -1
  53. package/src/ts/accessibility.ts +129 -69
  54. package/src/ts/adminlte.ts +3 -1
  55. package/src/ts/base-component.ts +84 -0
  56. package/src/ts/card-widget.ts +134 -85
  57. package/src/ts/color-mode.ts +174 -0
  58. package/src/ts/direct-chat.ts +38 -32
  59. package/src/ts/fullscreen.ts +78 -63
  60. package/src/ts/layout.ts +2 -1
  61. package/src/ts/push-menu.ts +93 -44
  62. package/src/ts/treeview.ts +107 -47
  63. package/src/ts/util/index.ts +114 -29
  64. package/.browserslistrc +0 -17
  65. package/.prettierrc +0 -6
  66. package/CODE_OF_CONDUCT.md +0 -43
  67. package/SECURITY.md +0 -99
  68. package/dist/UI/general.html +0 -2317
  69. package/dist/UI/icons.html +0 -1126
  70. package/dist/UI/timeline.html +0 -1212
  71. package/dist/docs/browser-support.html +0 -826
  72. package/dist/docs/color-mode.html +0 -1142
  73. package/dist/docs/components/main-header.html +0 -1209
  74. package/dist/docs/components/main-sidebar.html +0 -924
  75. package/dist/docs/customization.html +0 -1080
  76. package/dist/docs/deployment.html +0 -1145
  77. package/dist/docs/faq.html +0 -1392
  78. package/dist/docs/getting-started.html +0 -991
  79. package/dist/docs/how-to-contribute.html +0 -890
  80. package/dist/docs/index.html +0 -16
  81. package/dist/docs/integrations.html +0 -1231
  82. package/dist/docs/introduction.html +0 -1008
  83. package/dist/docs/javascript/accessibility.html +0 -949
  84. package/dist/docs/javascript/card-widget.html +0 -1019
  85. package/dist/docs/javascript/direct-chat.html +0 -896
  86. package/dist/docs/javascript/fullscreen.html +0 -905
  87. package/dist/docs/javascript/layout.html +0 -908
  88. package/dist/docs/javascript/plugins-overview.html +0 -1144
  89. package/dist/docs/javascript/pushmenu.html +0 -1045
  90. package/dist/docs/javascript/treeview.html +0 -1024
  91. package/dist/docs/layout-blueprint.html +0 -1087
  92. package/dist/docs/layout.html +0 -842
  93. package/dist/docs/license.html +0 -807
  94. package/dist/docs/migration.html +0 -1149
  95. package/dist/docs/recipes.html +0 -1185
  96. package/dist/docs/rtl.html +0 -957
  97. package/dist/examples/lockscreen.html +0 -249
  98. package/dist/examples/login-v2.html +0 -282
  99. package/dist/examples/login.html +0 -272
  100. package/dist/examples/register-v2.html +0 -291
  101. package/dist/examples/register.html +0 -277
  102. package/dist/forms/elements.html +0 -1405
  103. package/dist/forms/layout.html +0 -1267
  104. package/dist/forms/validation.html +0 -1275
  105. package/dist/forms/wizard.html +0 -1410
  106. package/dist/generate/theme.html +0 -1082
  107. package/dist/index.html +0 -1745
  108. package/dist/index2.html +0 -2277
  109. package/dist/index3.html +0 -1532
  110. package/dist/layout/collapsed-sidebar-without-hover.html +0 -1144
  111. package/dist/layout/collapsed-sidebar.html +0 -1137
  112. package/dist/layout/fixed-complete.html +0 -1138
  113. package/dist/layout/fixed-footer.html +0 -1136
  114. package/dist/layout/fixed-header.html +0 -1136
  115. package/dist/layout/fixed-sidebar.html +0 -1138
  116. package/dist/layout/layout-custom-area.html +0 -1177
  117. package/dist/layout/layout-rtl.html +0 -1137
  118. package/dist/layout/logo-switch.html +0 -683
  119. package/dist/layout/sidebar-mini.html +0 -1137
  120. package/dist/layout/unfixed-sidebar.html +0 -1136
  121. package/dist/mailbox/compose.html +0 -1151
  122. package/dist/mailbox/inbox.html +0 -1509
  123. package/dist/mailbox/read.html +0 -1202
  124. package/dist/pages/404.html +0 -239
  125. package/dist/pages/500.html +0 -227
  126. package/dist/pages/calendar.html +0 -1266
  127. package/dist/pages/chat.html +0 -1427
  128. package/dist/pages/faq.html +0 -1383
  129. package/dist/pages/file-manager.html +0 -1835
  130. package/dist/pages/invoice.html +0 -1199
  131. package/dist/pages/kanban.html +0 -1439
  132. package/dist/pages/maintenance.html +0 -230
  133. package/dist/pages/pricing.html +0 -1279
  134. package/dist/pages/profile.html +0 -1382
  135. package/dist/pages/projects.html +0 -1644
  136. package/dist/pages/settings.html +0 -1387
  137. package/dist/tables/data.html +0 -1319
  138. package/dist/tables/simple.html +0 -1435
  139. package/dist/widgets/cards.html +0 -1356
  140. package/dist/widgets/info-box.html +0 -1429
  141. package/dist/widgets/small-box.html +0 -1225
  142. package/eslint.config.js +0 -82
  143. package/github-issue-response.md +0 -40
  144. package/index.html +0 -12
  145. package/netlify.toml +0 -16
  146. package/src/scss/_bootstrap-variables.scss +0 -1766
@@ -1,1145 +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>Deployment &amp; Performance | 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="Deployment &amp; Performance | 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">
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 active">
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">Deployment &amp; Performance</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">Deployment</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 is a static HTML/CSS/JS template — there’s nothing exotic about
635
- deploying it. But there are a handful of choices that meaningfully change page
636
- weight, time-to-interactive, and CDN reliability. This page documents the ones
637
- worth getting right.
638
- </p>
639
- <h5 id="what-to-deploy">What to deploy</h5>
640
- <p>
641
- The deployable artefact is everything under <code>dist/</code> plus your own
642
- HTML / server-rendered templates:
643
- </p>
644
- <pre
645
- class="astro-code dark-plus"
646
- style="background-color: #1e1e1e; color: #d4d4d4; overflow-x: auto"
647
- tabindex="0"
648
- data-language="text"
649
- ><code><span class="line"><span>dist/</span></span>
650
- <span class="line"><span>├── css/ ← stylesheets (LTR + RTL, dev + minified)</span></span>
651
- <span class="line"><span>│ ├── adminlte.css</span></span>
652
- <span class="line"><span>│ ├── adminlte.min.css</span></span>
653
- <span class="line"><span>│ ├── adminlte.rtl.css</span></span>
654
- <span class="line"><span>│ └── adminlte.rtl.min.css</span></span>
655
- <span class="line"><span>├── js/ ← JavaScript bundle (dev + minified)</span></span>
656
- <span class="line"><span>│ ├── adminlte.js</span></span>
657
- <span class="line"><span>│ └── adminlte.min.js</span></span>
658
- <span class="line"><span>└── assets/ ← demo images / fonts (replace with your own)</span></span></code></pre>
659
- <p>
660
- You don’t ship <code>src/</code>, <code>node_modules/</code>, or the demo HTML
661
- if you’re embedding AdminLTE into your own app.
662
- </p>
663
- <h5 id="always-use-the-min-variants-in-production">
664
- Always use the <code>.min</code> variants in production
665
- </h5>
666
- <p>
667
- The minified builds are the same code with whitespace stripped and identifiers
668
- shortened. For <code>adminlte.css</code> the saving is roughly 15-20%; for
669
- <code>adminlte.js</code> it’s bigger (about 30% after gzip). The non-minified
670
- files are useful in development for readable source-map debugging — never
671
- serve them to users.
672
- </p>
673
-
674
- <table>
675
- <thead>
676
- <tr>
677
- <th>Asset</th>
678
- <th>Dev</th>
679
- <th>Production</th>
680
- </tr>
681
- </thead>
682
- <tbody>
683
- <tr>
684
- <td>Stylesheet</td>
685
- <td><code>dist/css/adminlte.css</code></td>
686
- <td>
687
- <strong><code>dist/css/adminlte.min.css</code></strong>
688
- </td>
689
- </tr>
690
- <tr>
691
- <td>Script</td>
692
- <td><code>dist/js/adminlte.js</code></td>
693
- <td>
694
- <strong><code>dist/js/adminlte.min.js</code></strong>
695
- </td>
696
- </tr>
697
- <tr>
698
- <td>RTL stylesheet</td>
699
- <td><code>dist/css/adminlte.rtl.css</code></td>
700
- <td>
701
- <strong><code>dist/css/adminlte.rtl.min.css</code></strong>
702
- </td>
703
- </tr>
704
- </tbody>
705
- </table>
706
- <h5 id="compression-at-the-edge">Compression at the edge</h5>
707
- <p>
708
- Make sure your web server / CDN gzips (or brotlis) responses for the relevant
709
- content types:
710
- </p>
711
- <pre
712
- class="astro-code dark-plus"
713
- style="background-color: #1e1e1e; color: #d4d4d4; overflow-x: auto"
714
- tabindex="0"
715
- data-language="nginx"
716
- ><code><span class="line"><span style="color:#6A9955"># nginx</span></span>
717
- <span class="line"><span style="color:#569CD6">gzip on</span><span style="color:#D4D4D4">;</span></span>
718
- <span class="line"><span style="color:#569CD6">gzip_types </span><span style="color:#D4D4D4">text/css application/javascript text/html image/svg+xml;</span></span>
719
- <span class="line"><span style="color:#569CD6">gzip_comp_level </span><span style="color:#B5CEA8">6</span><span style="color:#D4D4D4">;</span></span></code></pre>
720
- <pre
721
- class="astro-code dark-plus"
722
- style="background-color: #1e1e1e; color: #d4d4d4; overflow-x: auto"
723
- tabindex="0"
724
- data-language="apache"
725
- ><code><span class="line"><span style="color:#6A9955"># Apache</span></span>
726
- <span class="line"><span style="color:#569CD6">AddOutputFilterByType</span><span style="color:#D4D4D4"> DEFLATE text/css application/javascript text/html image/svg+xml</span></span></code></pre>
727
- <p>
728
- Cloudflare, Vercel, Netlify, and most managed hosting do this automatically.
729
- Verify with
730
- <code>curl -I -H &quot;Accept-Encoding: gzip&quot; your-page-url</code> and
731
- look for <code>content-encoding: gzip</code> in the response.
732
- </p>
733
- <h5 id="cache-headers">Cache headers</h5>
734
- <p>
735
- The dist artefacts have content hashes in their filenames
736
- <em>only if you wire it up via your bundler</em> — AdminLTE itself ships fixed
737
- filenames. Two reasonable strategies:
738
- </p>
739
- <ol>
740
- <li>
741
- <p>
742
- <strong>Short cache + version query string</strong> (simple, works without
743
- a build pipeline):
744
- </p>
745
- <pre
746
- class="astro-code dark-plus"
747
- style="background-color: #1e1e1e; color: #d4d4d4; overflow-x: auto"
748
- tabindex="0"
749
- data-language="html"
750
- ><code><span class="line"><span style="color:#808080">&lt;</span><span style="color:#569CD6">link</span><span style="color:#9CDCFE"> rel</span><span style="color:#D4D4D4">=</span><span style="color:#CE9178">&quot;stylesheet&quot;</span><span style="color:#9CDCFE"> href</span><span style="color:#D4D4D4">=</span><span style="color:#CE9178">&quot;/dist/css/adminlte.min.css?v=4.0.0&quot;</span><span style="color:#808080"> /&gt;</span></span>
751
- <span class="line"><span style="color:#808080">&lt;</span><span style="color:#569CD6">script</span><span style="color:#9CDCFE"> src</span><span style="color:#D4D4D4">=</span><span style="color:#CE9178">&quot;/dist/js/adminlte.min.js?v=4.0.0&quot;</span><span style="color:#808080">&gt;&lt;/</span><span style="color:#569CD6">script</span><span style="color:#808080">&gt;</span></span></code></pre>
752
- <p>
753
- Set <code>Cache-Control: public, max-age=86400</code> (1 day) at the
754
- server. Bump <code>?v=</code> on every release to force cache
755
- invalidation.
756
- </p>
757
- </li>
758
- <li>
759
- <p>
760
- <strong>Fingerprinted filenames</strong> (production-grade, requires a
761
- bundler):
762
- </p>
763
- <p>
764
- Let your bundler emit <code>adminlte.[hash].min.css</code> and reference
765
- that hash in your HTML. Set
766
- <code>Cache-Control: public, max-age=31536000, immutable</code> (1 year).
767
- This is what Vite/Webpack/Rollup do by default if you import AdminLTE
768
- through them.
769
- </p>
770
- </li>
771
- </ol>
772
- <h5 id="cdn-integrity-hashes">CDN integrity hashes</h5>
773
- <p>
774
- If you load AdminLTE from a public CDN (jsDelivr, unpkg), include a
775
- Subresource Integrity (SRI) hash so a compromised CDN can’t serve malicious
776
- JavaScript silently:
777
- </p>
778
- <pre
779
- class="astro-code dark-plus"
780
- style="background-color: #1e1e1e; color: #d4d4d4; overflow-x: auto"
781
- tabindex="0"
782
- data-language="html"
783
- ><code><span class="line"><span style="color:#808080">&lt;</span><span style="color:#569CD6">link</span></span>
784
- <span class="line"><span style="color:#9CDCFE"> rel</span><span style="color:#D4D4D4">=</span><span style="color:#CE9178">&quot;stylesheet&quot;</span></span>
785
- <span class="line"><span style="color:#9CDCFE"> href</span><span style="color:#D4D4D4">=</span><span style="color:#CE9178">&quot;https://cdn.jsdelivr.net/npm/admin-lte@4.0.0/dist/css/adminlte.min.css&quot;</span></span>
786
- <span class="line"><span style="color:#9CDCFE"> integrity</span><span style="color:#D4D4D4">=</span><span style="color:#CE9178">&quot;sha384-PASTE_THE_HASH_HERE&quot;</span></span>
787
- <span class="line"><span style="color:#9CDCFE"> crossorigin</span><span style="color:#D4D4D4">=</span><span style="color:#CE9178">&quot;anonymous&quot;</span></span>
788
- <span class="line"><span style="color:#808080">/&gt;</span></span></code></pre>
789
- <p>
790
- You can get the hash from the
791
- <a href="https://www.jsdelivr.com/package/npm/admin-lte"
792
- >jsDelivr file detail page</a
793
- >
794
- — click any file and copy the “SRI” line. Do the same for Bootstrap, Popper,
795
- OverlayScrollbars, and Bootstrap Icons.
796
- </p>
797
- <p>For private-hosted assets, generate the hash yourself:</p>
798
- <pre
799
- class="astro-code dark-plus"
800
- style="background-color: #1e1e1e; color: #d4d4d4; overflow-x: auto"
801
- tabindex="0"
802
- data-language="bash"
803
- ><code><span class="line"><span style="color:#DCDCAA">openssl</span><span style="color:#CE9178"> dgst</span><span style="color:#569CD6"> -sha384</span><span style="color:#569CD6"> -binary</span><span style="color:#CE9178"> dist/css/adminlte.min.css</span><span style="color:#D4D4D4"> | </span><span style="color:#DCDCAA">openssl</span><span style="color:#CE9178"> base64</span><span style="color:#569CD6"> -A</span></span></code></pre>
804
- <h5 id="loading-order-matters">Loading order matters</h5>
805
- <p>Get the script order right or things break silently:</p>
806
- <pre
807
- class="astro-code dark-plus"
808
- style="background-color: #1e1e1e; color: #d4d4d4; overflow-x: auto"
809
- tabindex="0"
810
- data-language="html"
811
- ><code><span class="line"><span style="color:#808080">&lt;</span><span style="color:#569CD6">head</span><span style="color:#808080">&gt;</span></span>
812
- <span class="line"><span style="color:#6A9955"> &lt;!-- 1. Bootstrap Icons (font CSS) — load first so icons render with the page --&gt;</span></span>
813
- <span class="line"><span style="color:#808080"> &lt;</span><span style="color:#569CD6">link</span><span style="color:#9CDCFE"> rel</span><span style="color:#D4D4D4">=</span><span style="color:#CE9178">&quot;stylesheet&quot;</span><span style="color:#9CDCFE"> href</span><span style="color:#D4D4D4">=</span><span style="color:#CE9178">&quot;https://cdn.jsdelivr.net/npm/bootstrap-icons@1.13.1/font/bootstrap-icons.min.css&quot;</span><span style="color:#808080"> /&gt;</span></span>
814
- <span class="line"></span>
815
- <span class="line"><span style="color:#6A9955"> &lt;!-- 2. OverlayScrollbars (optional, for the sidebar scroller) --&gt;</span></span>
816
- <span class="line"><span style="color:#808080"> &lt;</span><span style="color:#569CD6">link</span><span style="color:#9CDCFE"> rel</span><span style="color:#D4D4D4">=</span><span style="color:#CE9178">&quot;stylesheet&quot;</span><span style="color:#9CDCFE"> href</span><span style="color:#D4D4D4">=</span><span style="color:#CE9178">&quot;https://cdn.jsdelivr.net/npm/overlayscrollbars@2.11.0/styles/overlayscrollbars.min.css&quot;</span><span style="color:#808080"> /&gt;</span></span>
817
- <span class="line"></span>
818
- <span class="line"><span style="color:#6A9955"> &lt;!-- 3. AdminLTE — includes Bootstrap CSS via its imports --&gt;</span></span>
819
- <span class="line"><span style="color:#808080"> &lt;</span><span style="color:#569CD6">link</span><span style="color:#9CDCFE"> rel</span><span style="color:#D4D4D4">=</span><span style="color:#CE9178">&quot;stylesheet&quot;</span><span style="color:#9CDCFE"> href</span><span style="color:#D4D4D4">=</span><span style="color:#CE9178">&quot;https://cdn.jsdelivr.net/npm/admin-lte@4.0.0/dist/css/adminlte.min.css&quot;</span><span style="color:#808080"> /&gt;</span></span>
820
- <span class="line"><span style="color:#808080">&lt;/</span><span style="color:#569CD6">head</span><span style="color:#808080">&gt;</span></span>
821
- <span class="line"></span>
822
- <span class="line"><span style="color:#808080">&lt;</span><span style="color:#569CD6">body</span><span style="color:#808080">&gt;</span></span>
823
- <span class="line"><span style="color:#D4D4D4"> …</span></span>
824
- <span class="line"></span>
825
- <span class="line"><span style="color:#6A9955"> &lt;!-- Scripts at the END of body --&gt;</span></span>
826
- <span class="line"><span style="color:#6A9955"> &lt;!-- 4. Popper (Bootstrap dependency for dropdowns/tooltips/popovers) --&gt;</span></span>
827
- <span class="line"><span style="color:#808080"> &lt;</span><span style="color:#569CD6">script</span><span style="color:#9CDCFE"> src</span><span style="color:#D4D4D4">=</span><span style="color:#CE9178">&quot;https://cdn.jsdelivr.net/npm/@popperjs/core@2.11.8/dist/umd/popper.min.js&quot;</span><span style="color:#808080">&gt;&lt;/</span><span style="color:#569CD6">script</span><span style="color:#808080">&gt;</span></span>
828
- <span class="line"></span>
829
- <span class="line"><span style="color:#6A9955"> &lt;!-- 5. Bootstrap --&gt;</span></span>
830
- <span class="line"><span style="color:#808080"> &lt;</span><span style="color:#569CD6">script</span><span style="color:#9CDCFE"> src</span><span style="color:#D4D4D4">=</span><span style="color:#CE9178">&quot;https://cdn.jsdelivr.net/npm/bootstrap@5.3.8/dist/js/bootstrap.min.js&quot;</span><span style="color:#808080">&gt;&lt;/</span><span style="color:#569CD6">script</span><span style="color:#808080">&gt;</span></span>
831
- <span class="line"></span>
832
- <span class="line"><span style="color:#6A9955"> &lt;!-- 6. OverlayScrollbars --&gt;</span></span>
833
- <span class="line"><span style="color:#808080"> &lt;</span><span style="color:#569CD6">script</span><span style="color:#9CDCFE"> src</span><span style="color:#D4D4D4">=</span><span style="color:#CE9178">&quot;https://cdn.jsdelivr.net/npm/overlayscrollbars@2.11.0/browser/overlayscrollbars.browser.es6.min.js&quot;</span><span style="color:#808080">&gt;&lt;/</span><span style="color:#569CD6">script</span><span style="color:#808080">&gt;</span></span>
834
- <span class="line"></span>
835
- <span class="line"><span style="color:#6A9955"> &lt;!-- 7. AdminLTE — must load AFTER Bootstrap --&gt;</span></span>
836
- <span class="line"><span style="color:#808080"> &lt;</span><span style="color:#569CD6">script</span><span style="color:#9CDCFE"> src</span><span style="color:#D4D4D4">=</span><span style="color:#CE9178">&quot;https://cdn.jsdelivr.net/npm/admin-lte@4.0.0/dist/js/adminlte.min.js&quot;</span><span style="color:#808080">&gt;&lt;/</span><span style="color:#569CD6">script</span><span style="color:#808080">&gt;</span></span>
837
- <span class="line"><span style="color:#808080">&lt;/</span><span style="color:#569CD6">body</span><span style="color:#808080">&gt;</span></span></code></pre>
838
- <h5 id="defer-or-async">Defer or async?</h5>
839
- <p>
840
- The AdminLTE bundle waits for <code>DOMContentLoaded</code> before wiring its
841
- data API, so <code>defer</code> is safe and recommended:
842
- </p>
843
- <pre
844
- class="astro-code dark-plus"
845
- style="background-color: #1e1e1e; color: #d4d4d4; overflow-x: auto"
846
- tabindex="0"
847
- data-language="html"
848
- ><code><span class="line"><span style="color:#808080">&lt;</span><span style="color:#569CD6">script</span><span style="color:#9CDCFE"> defer</span><span style="color:#9CDCFE"> src</span><span style="color:#D4D4D4">=</span><span style="color:#CE9178">&quot;/dist/js/adminlte.min.js&quot;</span><span style="color:#808080">&gt;&lt;/</span><span style="color:#569CD6">script</span><span style="color:#808080">&gt;</span></span></code></pre>
849
- <p>
850
- Don’t use <code>async</code> — the script could execute before its
851
- dependencies (Bootstrap, Popper) have parsed, and listeners would attach to
852
- elements that don’t exist yet.
853
- </p>
854
- <h5 id="critical-css">Critical CSS</h5>
855
- <p>
856
- For sub-1-second first paint, inline the styles that the above-the-fold layout
857
- uses (header + brand + first visible content) and load the rest of
858
- <code>adminlte.min.css</code> asynchronously:
859
- </p>
860
- <pre
861
- class="astro-code dark-plus"
862
- style="background-color: #1e1e1e; color: #d4d4d4; overflow-x: auto"
863
- tabindex="0"
864
- data-language="html"
865
- ><code><span class="line"><span style="color:#808080">&lt;</span><span style="color:#569CD6">style</span><span style="color:#808080">&gt;</span><span style="color:#6A9955">/* extracted critical CSS for /dashboard */</span><span style="color:#808080">&lt;/</span><span style="color:#569CD6">style</span><span style="color:#808080">&gt;</span></span>
866
- <span class="line"></span>
867
- <span class="line"><span style="color:#808080">&lt;</span><span style="color:#569CD6">link</span></span>
868
- <span class="line"><span style="color:#9CDCFE"> rel</span><span style="color:#D4D4D4">=</span><span style="color:#CE9178">&quot;preload&quot;</span></span>
869
- <span class="line"><span style="color:#9CDCFE"> as</span><span style="color:#D4D4D4">=</span><span style="color:#CE9178">&quot;style&quot;</span></span>
870
- <span class="line"><span style="color:#9CDCFE"> href</span><span style="color:#D4D4D4">=</span><span style="color:#CE9178">&quot;/dist/css/adminlte.min.css&quot;</span></span>
871
- <span class="line"><span style="color:#9CDCFE"> onload</span><span style="color:#D4D4D4">=</span><span style="color:#CE9178">&quot;</span><span style="color:#569CD6">this</span><span style="color:#CE9178">.</span><span style="color:#9CDCFE">onload</span><span style="color:#D4D4D4">=</span><span style="color:#569CD6">null</span><span style="color:#CE9178">;</span><span style="color:#569CD6">this</span><span style="color:#CE9178">.</span><span style="color:#9CDCFE">rel</span><span style="color:#D4D4D4">=</span><span style="color:#CE9178">&#39;stylesheet&#39;&quot;</span></span>
872
- <span class="line"><span style="color:#808080">/&gt;</span></span>
873
- <span class="line"><span style="color:#808080">&lt;</span><span style="color:#569CD6">noscript</span><span style="color:#808080">&gt;&lt;</span><span style="color:#569CD6">link</span><span style="color:#9CDCFE"> rel</span><span style="color:#D4D4D4">=</span><span style="color:#CE9178">&quot;stylesheet&quot;</span><span style="color:#9CDCFE"> href</span><span style="color:#D4D4D4">=</span><span style="color:#CE9178">&quot;/dist/css/adminlte.min.css&quot;</span><span style="color:#808080"> /&gt;&lt;/</span><span style="color:#569CD6">noscript</span><span style="color:#808080">&gt;</span></span></code></pre>
874
- <p>
875
- Extract critical CSS with a tool like
876
- <a href="https://github.com/GoogleChromeLabs/critters">Critters</a> or
877
- <a href="https://github.com/pocketjoso/penthouse">Penthouse</a> as part of
878
- your build. For dashboards behind a login (where first-load speed matters less
879
- than for marketing pages), this is usually overkill.
880
- </p>
881
- <h5 id="preload-key-assets">Preload key assets</h5>
882
- <p>
883
- Push critical resources to the browser before it discovers them in the HTML:
884
- </p>
885
- <pre
886
- class="astro-code dark-plus"
887
- style="background-color: #1e1e1e; color: #d4d4d4; overflow-x: auto"
888
- tabindex="0"
889
- data-language="html"
890
- ><code><span class="line"><span style="color:#808080">&lt;</span><span style="color:#569CD6">link</span><span style="color:#9CDCFE"> rel</span><span style="color:#D4D4D4">=</span><span style="color:#CE9178">&quot;preload&quot;</span><span style="color:#9CDCFE"> as</span><span style="color:#D4D4D4">=</span><span style="color:#CE9178">&quot;style&quot;</span><span style="color:#9CDCFE"> href</span><span style="color:#D4D4D4">=</span><span style="color:#CE9178">&quot;/dist/css/adminlte.min.css&quot;</span><span style="color:#808080"> /&gt;</span></span>
891
- <span class="line"><span style="color:#808080">&lt;</span><span style="color:#569CD6">link</span><span style="color:#9CDCFE"> rel</span><span style="color:#D4D4D4">=</span><span style="color:#CE9178">&quot;preload&quot;</span><span style="color:#9CDCFE"> as</span><span style="color:#D4D4D4">=</span><span style="color:#CE9178">&quot;font&quot;</span><span style="color:#9CDCFE"> href</span><span style="color:#D4D4D4">=</span><span style="color:#CE9178">&quot;/fonts/source-sans-3.woff2&quot;</span><span style="color:#9CDCFE"> type</span><span style="color:#D4D4D4">=</span><span style="color:#CE9178">&quot;font/woff2&quot;</span><span style="color:#9CDCFE"> crossorigin</span><span style="color:#808080"> /&gt;</span></span>
892
- <span class="line"><span style="color:#808080">&lt;</span><span style="color:#569CD6">link</span><span style="color:#9CDCFE"> rel</span><span style="color:#D4D4D4">=</span><span style="color:#CE9178">&quot;preconnect&quot;</span><span style="color:#9CDCFE"> href</span><span style="color:#D4D4D4">=</span><span style="color:#CE9178">&quot;https://cdn.jsdelivr.net&quot;</span><span style="color:#9CDCFE"> crossorigin</span><span style="color:#808080"> /&gt;</span></span></code></pre>
893
- <p>
894
- Only preload what’s used on every page. Preloading per-route assets in a
895
- shared layout wastes bandwidth.
896
- </p>
897
- <h5 id="lazy-loading-sub-pages">Lazy-loading sub-pages</h5>
898
- <p>
899
- If your dashboard has many routes and the JS is server-rendered HTML per
900
- route, prefer per-route CSS imports rather than one mega-stylesheet.
901
- AdminLTE’s core CSS is small (~44KB gzipped) but page-specific styles (charts,
902
- calendars, tables) can add up — only load them where they’re used.
903
- </p>
904
- <p>For SPAs, code-split heavy integrations:</p>
905
- <pre
906
- class="astro-code dark-plus"
907
- style="background-color: #1e1e1e; color: #d4d4d4; overflow-x: auto"
908
- tabindex="0"
909
- data-language="js"
910
- ><code><span class="line"><span style="color:#6A9955">// Don&#39;t bundle the calendar app into the main chunk</span></span>
911
- <span class="line"><span style="color:#569CD6">const</span><span style="color:#DCDCAA"> Calendar</span><span style="color:#D4D4D4"> = () </span><span style="color:#569CD6">=&gt;</span><span style="color:#569CD6"> import</span><span style="color:#D4D4D4">(</span><span style="color:#CE9178">&quot;./Calendar.vue&quot;</span><span style="color:#D4D4D4">)</span></span></code></pre>
912
- <h5 id="bundle-size-budget">Bundle size budget</h5>
913
- <p>The current published <code>dist/</code> artefacts gzip to:</p>
914
-
915
- <table>
916
- <thead>
917
- <tr>
918
- <th>Asset</th>
919
- <th>Size (gzip)</th>
920
- </tr>
921
- </thead>
922
- <tbody>
923
- <tr>
924
- <td><code>adminlte.min.css</code></td>
925
- <td>~40 KB</td>
926
- </tr>
927
- <tr>
928
- <td><code>adminlte.rtl.min.css</code></td>
929
- <td>~40 KB</td>
930
- </tr>
931
- <tr>
932
- <td><code>adminlte.min.js</code></td>
933
- <td>~5 KB</td>
934
- </tr>
935
- </tbody>
936
- </table>
937
- <p>
938
- The full first-page payload (HTML + Bootstrap + AdminLTE + Bootstrap Icons +
939
- Popper + OverlayScrollbars) is around <strong>180 KB gzipped</strong> when
940
- loaded from CDN. The CI build enforces a <code>bundlewatch</code> check that
941
- fails if any asset crosses its budget.
942
- </p>
943
- <h5 id="service-workers--offline-support">Service workers / offline support</h5>
944
- <p>
945
- AdminLTE is just static files — caching them in a service worker works without
946
- changes. A minimal Workbox config:
947
- </p>
948
- <pre
949
- class="astro-code dark-plus"
950
- style="background-color: #1e1e1e; color: #d4d4d4; overflow-x: auto"
951
- tabindex="0"
952
- data-language="js"
953
- ><code><span class="line"><span style="color:#C586C0">import</span><span style="color:#D4D4D4"> { </span><span style="color:#9CDCFE">precacheAndRoute</span><span style="color:#D4D4D4"> } </span><span style="color:#C586C0">from</span><span style="color:#CE9178"> &quot;workbox-precaching&quot;</span></span>
954
- <span class="line"></span>
955
- <span class="line"><span style="color:#DCDCAA">precacheAndRoute</span><span style="color:#D4D4D4">([</span></span>
956
- <span class="line"><span style="color:#D4D4D4"> { </span><span style="color:#9CDCFE">url:</span><span style="color:#CE9178"> &quot;/dist/css/adminlte.min.css&quot;</span><span style="color:#D4D4D4">, </span><span style="color:#9CDCFE">revision:</span><span style="color:#CE9178"> &quot;4.0.0&quot;</span><span style="color:#D4D4D4"> },</span></span>
957
- <span class="line"><span style="color:#D4D4D4"> { </span><span style="color:#9CDCFE">url:</span><span style="color:#CE9178"> &quot;/dist/js/adminlte.min.js&quot;</span><span style="color:#D4D4D4">, </span><span style="color:#9CDCFE">revision:</span><span style="color:#CE9178"> &quot;4.0.0&quot;</span><span style="color:#D4D4D4"> },</span></span>
958
- <span class="line"><span style="color:#6A9955"> // ...your own pages</span></span>
959
- <span class="line"><span style="color:#D4D4D4">])</span></span></code></pre>
960
- <h5 id="removing-dev-only-files-before-deploy">
961
- Removing dev-only files before deploy
962
- </h5>
963
- <p>
964
- If you’re deploying the demo <code>dist/</code> folder verbatim, strip these
965
- patterns from the upload:
966
- </p>
967
- <ul>
968
- <li>
969
- <code>*.map</code> (source maps — leak source code to anyone who opens
970
- devtools)
971
- </li>
972
- <li><code>**/html/</code> (the Astro intermediate build, if present)</li>
973
- <li><code>**/.astro/</code> (Astro cache)</li>
974
- </ul>
975
- <p>For <code>rclone</code> / <code>rsync</code>:</p>
976
- <pre
977
- class="astro-code dark-plus"
978
- style="background-color: #1e1e1e; color: #d4d4d4; overflow-x: auto"
979
- tabindex="0"
980
- data-language="bash"
981
- ><code><span class="line"><span style="color:#DCDCAA">rsync</span><span style="color:#569CD6"> -avz</span><span style="color:#569CD6"> --delete</span><span style="color:#D7BA7D"> \</span></span>
982
- <span class="line"><span style="color:#569CD6"> --exclude=</span><span style="color:#CE9178">&#39;*.map&#39;</span><span style="color:#D7BA7D"> \</span></span>
983
- <span class="line"><span style="color:#569CD6"> --exclude=</span><span style="color:#CE9178">&#39;html/&#39;</span><span style="color:#D7BA7D"> \</span></span>
984
- <span class="line"><span style="color:#569CD6"> --exclude=</span><span style="color:#CE9178">&#39;.astro/&#39;</span><span style="color:#D7BA7D"> \</span></span>
985
- <span class="line"><span style="color:#CE9178"> dist/</span><span style="color:#CE9178"> user@server:/var/www/your-app/</span></span></code></pre>
986
- <h5 id="a-note-on-cloudflare-cache">A note on Cloudflare cache</h5>
987
- <p>
988
- Cloudflare’s default Browser Cache TTL is 4 hours. If you push a new release
989
- and want users to see it immediately,
990
- <a href="https://developers.cloudflare.com/cache/how-to/purge-cache/"
991
- >purge the affected paths</a
992
- >
993
- from the Cloudflare dashboard or API. Otherwise, users on cached pages will
994
- see your old CSS / JS for up to four hours.
995
- </p>
996
- <h5 id="where-to-next">Where to next</h5>
997
- <ul>
998
- <li>
999
- <a href="customization.html">Customization</a> — change colours, sidebar
1000
- width, breakpoints before you deploy
1001
- </li>
1002
- <li>
1003
- <a href="integrations.html">Recommended Integrations</a> — pick lightweight
1004
- libraries for the things AdminLTE doesn’t bundle
1005
- </li>
1006
- <li>
1007
- <a href="javascript/accessibility.html">Accessibility</a> — make sure your
1008
- deployed pages keep their a11y guarantees
1009
- </li>
1010
- </ul>
1011
- </div>
1012
- </div>
1013
- </div>
1014
- </div>
1015
- </div>
1016
- </div>
1017
- </main>
1018
- <!--begin::Footer-->
1019
- <footer class="app-footer">
1020
- <!--begin::To the end-->
1021
- <div class="float-end d-none d-sm-inline">Anything you want</div>
1022
- <!--end::To the end-->
1023
- <!--begin::Copyright-->
1024
- <strong>
1025
- Copyright &copy; 2014-2026&nbsp;
1026
- <a href="https://adminlte.io" class="text-decoration-none">AdminLTE.io</a>.
1027
- </strong>
1028
- All rights reserved.
1029
- <!--end::Copyright-->
1030
- </footer>
1031
- <!--end::Footer-->
1032
- </div>
1033
- <!--begin::Third Party Plugin(OverlayScrollbars)-->
1034
- <script
1035
- src="https://cdn.jsdelivr.net/npm/overlayscrollbars@2.11.0/browser/overlayscrollbars.browser.es6.min.js"
1036
- crossorigin="anonymous"
1037
- ></script>
1038
- <!--end::Third Party Plugin(OverlayScrollbars)--><!--begin::Required Plugin(popperjs for Bootstrap 5)-->
1039
- <script
1040
- src="https://cdn.jsdelivr.net/npm/@popperjs/core@2.11.8/dist/umd/popper.min.js"
1041
- crossorigin="anonymous"
1042
- ></script>
1043
- <!--end::Required Plugin(popperjs for Bootstrap 5)--><!--begin::Required Plugin(Bootstrap 5)-->
1044
- <script
1045
- src="https://cdn.jsdelivr.net/npm/bootstrap@5.3.7/dist/js/bootstrap.min.js"
1046
- crossorigin="anonymous"
1047
- ></script>
1048
- <!--end::Required Plugin(Bootstrap 5)--><!--begin::Required Plugin(AdminLTE)-->
1049
- <script src="../js/adminlte.js"></script>
1050
- <!--end::Required Plugin(AdminLTE)--><!--begin::OverlayScrollbars Configure-->
1051
- <script>
1052
- const SELECTOR_SIDEBAR_WRAPPER = '.sidebar-wrapper';
1053
- const Default = {
1054
- scrollbarTheme: 'os-theme-light',
1055
- scrollbarAutoHide: 'leave',
1056
- scrollbarClickScroll: true,
1057
- };
1058
- document.addEventListener('DOMContentLoaded', function () {
1059
- const sidebarWrapper = document.querySelector(SELECTOR_SIDEBAR_WRAPPER);
1060
-
1061
- // Disable OverlayScrollbars on mobile devices to prevent touch interference
1062
- const isMobile = window.innerWidth <= 992;
1063
-
1064
- if (
1065
- sidebarWrapper &&
1066
- OverlayScrollbarsGlobal?.OverlayScrollbars !== undefined &&
1067
- !isMobile
1068
- ) {
1069
- OverlayScrollbarsGlobal.OverlayScrollbars(sidebarWrapper, {
1070
- scrollbars: {
1071
- theme: Default.scrollbarTheme,
1072
- autoHide: Default.scrollbarAutoHide,
1073
- clickScroll: Default.scrollbarClickScroll,
1074
- },
1075
- });
1076
- }
1077
- });
1078
- </script>
1079
- <!--end::OverlayScrollbars Configure--><!--begin::Color Mode Toggle (#6010)-->
1080
- <script>
1081
- (() => {
1082
- 'use strict';
1083
-
1084
- const STORAGE_KEY = 'lte-theme';
1085
-
1086
- const getStoredTheme = () => localStorage.getItem(STORAGE_KEY);
1087
- const setStoredTheme = (theme) => localStorage.setItem(STORAGE_KEY, theme);
1088
-
1089
- const prefersDark = () => globalThis.matchMedia('(prefers-color-scheme: dark)').matches;
1090
-
1091
- const getPreferredTheme = () => {
1092
- const stored = getStoredTheme();
1093
- if (stored) return stored;
1094
- return prefersDark() ? 'dark' : 'light';
1095
- };
1096
-
1097
- const setTheme = (theme) => {
1098
- const resolved = theme === 'auto' ? (prefersDark() ? 'dark' : 'light') : theme;
1099
- document.documentElement.setAttribute('data-bs-theme', resolved);
1100
- };
1101
-
1102
- setTheme(getPreferredTheme());
1103
-
1104
- const showActiveTheme = (theme) => {
1105
- // Highlight the active dropdown option
1106
- document.querySelectorAll('[data-bs-theme-value]').forEach((el) => {
1107
- el.classList.remove('active');
1108
- el.setAttribute('aria-pressed', 'false');
1109
- const check = el.querySelector('.bi-check-lg');
1110
- if (check) check.classList.add('d-none');
1111
- });
1112
- const active = document.querySelector(`[data-bs-theme-value="${theme}"]`);
1113
- if (active) {
1114
- active.classList.add('active');
1115
- active.setAttribute('aria-pressed', 'true');
1116
- const check = active.querySelector('.bi-check-lg');
1117
- if (check) check.classList.remove('d-none');
1118
- }
1119
- // Sync the topbar trigger icon
1120
- document.querySelectorAll('[data-lte-theme-icon]').forEach((icon) => {
1121
- icon.classList.toggle('d-none', icon.dataset.lteThemeIcon !== theme);
1122
- });
1123
- };
1124
-
1125
- globalThis.matchMedia('(prefers-color-scheme: dark)').addEventListener('change', () => {
1126
- const stored = getStoredTheme();
1127
- if (!stored || stored === 'auto') setTheme(getPreferredTheme());
1128
- });
1129
-
1130
- document.addEventListener('DOMContentLoaded', () => {
1131
- showActiveTheme(getPreferredTheme());
1132
- document.querySelectorAll('[data-bs-theme-value]').forEach((toggle) => {
1133
- toggle.addEventListener('click', () => {
1134
- const theme = toggle.getAttribute('data-bs-theme-value');
1135
- setStoredTheme(theme);
1136
- setTheme(theme);
1137
- showActiveTheme(theme);
1138
- });
1139
- });
1140
- });
1141
- })();
1142
- </script>
1143
- <!--end::Color Mode Toggle-->
1144
- </body>
1145
- </html>