Themes

Perceptron includes a built-in theme editor and some pre-installed themes. All themes use a 14-color palette.

Built-in Themes

The following themes are installed by default:

catppuccin-mocha — Default dark theme (mauve accents)
catppuccin-latte — Light theme
carbon — IBM Carbon-inspired cool gray theme
ayu — Warm orange-yellow accents

Theme Editor

Open the theme editor from the Settings page by selecting “Configure Theme”. The editor displays all 14 color fields of the currently active theme as editable hex values with live preview swatches.

Field	Default	Purpose
Background	`#1e1e2e`	Main background (leave empty for a transparent background)
Primary	`#cba6f7`	Focused/editing borders, active elements
Secondary	`#cdd6f4`	Data values, table rows
Success	`#a6e3a1`	Connected status, positive states
Error	`#f38ba8`	Failed states, errors
Warning	`#f9e2af`	Pending states, cautions
Muted	`#7f849c`	Inactive sidebar items, key hints
Surface	`#45475a`	Inactive borders, separators
Accent	`#74c7ec`	Addresses, links, highlights
Text	`#bac2de`	Form titles, section headers
Highlight	`#fab387`	Table headers, active items
Dim	`#585b70`	Placeholder text, disabled elements
Mantle	`#181825`	Modal/popup background
Crust	`#11111b`	Deepest background layer

Editing a Theme

Open the theme editor from the Settings page
Edit any color field (hex format, e.g. #ff00aa)
Press the “Save Theme” button at the bottom of the page
The theme is saved as custom.json in ~/.perceptron/themes/

Loading a Theme

In the Theme Editor, press the “Load Theme” button
Select a theme from the list
The theme is applied immediately

Creating Custom Themes

Themes are stored as JSON files in ~/.perceptron/themes/. Each file contains the 14 color hexadecimal fields:

{
  "background": "#1e1e2e",
  "primary": "#cba6f7",
  "secondary": "#cdd6f4",
  "success": "#a6e3a1",
  "error": "#f38ba8",
  "warning": "#f9e2af",
  "muted": "#7f849c",
  "surface": "#45475a",
  "accent": "#74c7ec",
  "text": "#bac2de",
  "highlight": "#fab387",
  "dim": "#585b70",
  "mantle": "#181825",
  "crust": "#11111b"
}

The background field can be empty ("") to use the terminal’s default background color (transparent).