¶ Reference

Branding

Make the installer feel like a part of your product. All branding lives under the branding key in painda.config.ts.

Example

painda.config.ts
branding: {
  primaryColor: "#4f46e5",
  accentColor: "#a855f7",
  logo: "./installer-assets/logo.png",
  icon: "./installer-assets/icon.ico",
  backgroundImage: "./installer-assets/welcome-bg.jpg",
  fontFamily: "'Inter', system-ui, sans-serif",
  theme: "dark",
},

Colors

primaryColor

Drives buttons, focus rings, progress bars, and accent highlights. Hex format: #rrggbb or #rgb. Default: #4f46e5.

accentColor

Optional secondary accent for gradients and decorative details. If omitted, only primaryColor is used.

TipPick colors with enough contrast against the wizard background. The renderer doesn't auto-correct contrast — that's your call.

Logo

Square PNG, ideally 256×256 or larger, shown in the wizard header. Transparent background recommended.

painda.config.ts
logo: "./installer-assets/logo.png",

Installer icon (.ico)

The icon embedded into the installer .exe file — what shows in Windows Explorer and on the desktop after the user downloads it. Multi-resolution .ico recommended: 16, 32, 48, 64, 128, 256.

painda.config.ts
icon: "./installer-assets/icon.ico",
TipWithout an icon, Windows uses a generic EXE icon that looks unprofessional. Always set this for production releases.

Background image

Optional welcome / sidebar artwork. JPG or PNG, 600×400 or larger, landscape. Used as a backdrop on the Welcome page.

Font

Custom font family CSS value. Use a system font, or bundle your own webfont and reference it. Default is a system sans-serif stack.

painda.config.ts
fontFamily: "'Inter', -apple-system, BlinkMacSystemFont, sans-serif",

Theme

Choose the wizard's visual mode:

  • "light" — light background, dark text
  • "dark" — dark background, light text
  • "auto" — follows the user's Windows theme (default)
painda.config.ts
theme: "auto",