QUESTPIE
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

OptionTypeDescription
namestring | Record<string, string>App name shown in the sidebar header. Supports i18n with locale keys.
logostringURL or path to a logo image. Displayed in the sidebar and login page.
faviconstringURL 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.

On this page