Themes

​

Quick start

​

Builtin themes

​

Dark

​

Light

​

Config

{
  "theme": {
    "name": "catppuccin",
    "transparent": true,
    "userMessageOpacity": 70,
    "diffOpacity": 30,
    "borderStrength": "strong"
  }
}

​

Theme picker controls

​

Custom themes

mkdir -p ~/.soulforge/themes

​

Example

{
  "_extends": "dark",
  "_label": "My Theme",
  "_description": "A custom dark theme",
  "_variant": "dark",
  "brand": "#ff6600",
  "brand-secondary": "#ff0040",
  "bg-primary": "#1a1a2e",
  "bg-elevated": "#16213e",
  "text-primary": "#e0e0e0",
  "success": "#00ff88",
  "error": "#ff4444"
}

​

Metadata fields

​

Token reference

• Brand: brand, brand-secondary, brand-dim, brand-alt
• Text: text-primary, text-secondary, text-muted, text-dim, text-faint, text-subtle
• Backgrounds: bg-app, bg-primary, bg-secondary, bg-elevated, bg-popup, bg-popup-highlight, bg-overlay, bg-input, bg-banner, bg-banner-error, bg-user
• Borders: border, border-focused, border-active, border-slash
• Status: success, error, warning, info, amber
• Diff: diff-added-bg, diff-removed-bg, diff-added-sign, diff-removed-sign
• Accents: accent-user, accent-assistant, accent-system

​

Legacy format

{
  "my-theme": {
    "_extends": "dark",
    "brand": "#ff6600"
  },
  "another-theme": {
    "_extends": "light",
    "brand": "#0066ff"
  }
}

​

Hot reload