Customization

Bulwark is designed to be easily customizable to match your brand.

Theming

Bulwark uses CSS custom properties for theming. Override them to change colors across the entire application.

Light Theme Variables

:root {
  --color-background: #ffffff;
  --color-foreground: #0f172a;
  --color-primary: #3b82f6;
  --color-primary-foreground: #ffffff;
  --color-secondary: #f8fafc;
  --color-secondary-foreground: #0f172a;
  --color-muted: #f1f5f9;
  --color-muted-foreground: #64748b;
  --color-accent: #dbeafe;
  --color-accent-foreground: #1e40af;
  --color-border: #e2e8f0;
  --color-input: #e2e8f0;
  --color-ring: #94a3b8;
}

Dark Theme Variables

.dark {
  --color-background: #0a0a0a;
  --color-foreground: #fafafa;
  --color-primary: #fafafa;
  --color-primary-foreground: #171717;
  --color-secondary: #262626;
  --color-secondary-foreground: #fafafa;
  --color-muted: #262626;
  --color-muted-foreground: #a3a3a3;
  --color-accent: #1e3a8a;
  --color-accent-foreground: #dbeafe;
  --color-border: #262626;
}

Theme Modes

Bulwark supports three theme modes: light, dark, and system (follows OS preference). The selected theme is persisted in localStorage and applied via Zustand state management.

Custom App Name

Change the application name displayed in the UI:

APP_NAME=YourMail

Login Page Branding

Customize the login page with company information:

LOGIN_COMPANY_NAME=Your Company
LOGIN_WEBSITE_URL=https://yourcompany.com
LOGIN_IMPRINT_URL=https://yourcompany.com/imprint
LOGIN_PRIVACY_POLICY_URL=https://yourcompany.com/privacy

In-App Settings

Users can customize their experience from the Settings page:

• Font size — Small, medium, or large
• List density — Compact, regular, or comfortable
• Animations — Enable or disable UI animations
• Date format — Regional, ISO, or custom
• Time format — 12-hour or 24-hour
• First day of week — Sunday or Monday
• External content — Ask, block, or allow by default
• Toolbar position — Top or below subject
• Mark as read delay — Instant, delayed, or never
• Delete action — Move to trash or permanent delete

Structured Logging

Configure log output format and verbosity:

LOG_FORMAT=text   # "text" or "json"
LOG_LEVEL=info    # "debug", "info", "warn", "error"