Build Your Workspace
Branding
Customize the admin panel name, logo, and appearance.
Configure the admin panel's branding using the config/admin.ts file convention. This controls the app name, logo, and visual identity shown in the sidebar and login page.
Basic Setup
Add a branding property to your config/admin.ts:
src/questpie/server/config/admin.ts
import { adminConfig } from "@questpie/admin/server";
export default adminConfig({
branding: {
name: { en: "My CMS", sk: "Moj CMS" },
},
// sidebar, dashboard, locale can also go here
});The file is auto-discovered by codegen — no manual registration needed.
Options
| Option | Type | Description |
|---|---|---|
name | string | Record<string, string> | App name shown in the sidebar header. Supports i18n with locale keys. |
logo | string | URL or path to a logo image. Displayed in the sidebar and login page. |
favicon | string | URL or path to the favicon. |
Full Example
src/questpie/server/config/admin.ts
import { adminConfig } from "@questpie/admin/server";
export default adminConfig({
branding: {
name: { en: "Barbershop Admin", sk: "Barbershop Admin" },
logo: "/images/logo.svg",
favicon: "/images/favicon.ico",
},
sidebar: { /* ... */ },
});Localized Names
The name field accepts a locale-keyed object. The admin panel shows the name matching the current UI locale:
branding: {
name: {
en: "Content Management",
sk: "Sprava obsahu",
de: "Inhaltsverwaltung",
},
}If the current locale isn't in the object, it falls back to the first key.
Logo Placement
The logo appears in:
- Sidebar header — next to the app name
- Login page — above the login form
- Collapsed sidebar — icon-only mode shows just the logo
Use an SVG for best results across light/dark themes.
Theming
For deeper customization of colors, typography, and layout, see the Theming guide and the admin package's THEMING.md.
Related Pages
- Sidebar — Navigation structure
- Setup — Admin panel setup
- Localization — UI locale configuration