Skip to main content

Theme and colours

The panel uses Bootstrap 5.3 with the Super Admin theme. Its colours are CSS variables, so your app can apply its brand without replacing the package views.

Apply your brand​

Put the variables in a stylesheet and list it in UI:Stylesheets. It then loads on the sign-in page, the built-in pages and Blazor pages with <SuperAdminHead />:

"SuperAdmin": { "UI": { "Stylesheets": [ "~/css/admin-brand.css" ], "ColorMode": "Auto" } }
/* wwwroot/css/admin-brand.css */
:root {
--sa-accent: #e11d48; /* primary buttons, checkboxes, pagination, active menu bar */
--sa-sidebar-bg: #1f2937; /* sidebar, logo area, user menu header */
}

Variables​

VariableDefault (light)Used for
--sa-accent#3a96ff.btn-primary, .btn-outline-primary, checked checkboxes, pagination, pills, active menu bar
--sa-sidebar-bg / --sa-sidebar-active-bg / --sa-sidebar-darker-bg#263544 / #212d3a / #1c2631Sidebar, logo area and its hover
--sa-sidebar-text / --sa-sidebar-text-hover / --sa-sidebar-link-active#a7a7be / #fff / #72afd2Menu links
--sa-sidebar-border#424d5aLine next to sub-menus
--sa-main-bg#ecf0f5Page background
--sa-surface-bgbody backgroundCards, tables, header
--sa-hover-bg#f8f8f8Header item hover
--sa-text-color#515151Table text
--sa-table-border-color, --sa-input-border-color, --sa-check-border-colorTable, input and checkbox borders
--sa-menu-width / --sa-menu-closed-width280px / 55pxSidebar width, open and collapsed

The old names (--menu-bg, --main-bg, ...) from before 0.2.2 still work.

Dark mode​

UI:ColorMode = Dark or Auto switches Bootstrap's data-bs-theme. Every --sa-* variable has a dark value. To change a colour in dark mode only:

[data-bs-theme=dark] { --sa-main-bg: #111; }

Deeper changes​

Other Bootstrap colours (.btn-success, .text-bg-warning, ...) are compiled in. The theme is built from theme/ in the repository (npm install && npm run build). Edit theme/_settings.scss there for deeper changes.