Skip to content

Themes

OxideTerm’s theme engine produces Rust color tokens for both the terminal painter and native GPUI controls. Selecting a theme updates the workspace without restarting the application.

OxideTerm ships 33 built-in themes. They include dark and light palettes and familiar terminal styles such as Dracula, Solarized, Monokai, Nord, One Dark, Gruvbox, and Tokyo Night.

Open Settings → Appearance and select a color theme to apply it. The preview shows terminal colors and representative UI accents before you continue working.

In Settings → Appearance, choose fixed light, fixed dark, or system appearance. Configure application and terminal themes independently for each light/dark scheme, or save the current appearance into a scheme. Both schemes are available even when not following the system.

The title-bar sun or moon shows the current mode. Click it to switch to the other configured scheme. If the required scheme is missing, OxideTerm asks you to configure it instead of choosing an unrelated theme automatically.

Choose Normal, Fast, Reduced, or Off. Normal and Fast animate sidebars, selection highlights, dialogs, notifications, and controls. Reversing or interrupting a transition continues from its current position. Reduced keeps light fades while omitting movement and rotation; Off updates immediately. Theme/background changes use a restrained transition rather than a bright full-window flash.

Terminal font settings accept an ordered font stack. An unavailable font produces a notice and uses a monospace fallback. Installing a font at the operating-system level does not guarantee that its format is usable by the application; if a bitmap font fails, choose an available outline monospace font and check the preview.

The native theme editor can create a theme from the current or another built-in palette. A custom theme contains:

  • 20 terminal colors
  • 23 application UI colors
  • A display name and stable custom: identifier

Custom themes are stored with OxideTerm settings and can be edited, deleted, imported, or exported.

GroupFields
BaseBackground, foreground, cursor, selection
ANSIBlack, red, green, yellow, blue, magenta, cyan, white
Bright ANSIBright variants of the eight ANSI colors

The terminal painter reads these values directly when it builds GPUI draw output.

GroupExamples
BackgroundsMain, panel, card, hover, active, secondary, elevated, sunken
TextPrimary, muted, secondary, heading
BordersStandard, strong, divider
AccentAccent, hover, accent text, secondary accent
StatusSuccess, warning, error, info

These tokens style native tabs, panels, dialogs, menus, controls, status indicators, and editor surfaces.

The editor can derive a complete application palette from terminal colors. The derivation uses the terminal background, foreground, cursor, and ANSI colors to produce related surfaces, borders, accents, and semantic status colors.

  1. Choose or edit the terminal palette.
  2. Use Auto from Terminal in the UI color section.
  3. Review the generated application colors in the preview.
  4. Adjust individual colors as needed, then save.

Derivation is a starting point, not a lock. Every generated field remains editable.

The native editor includes:

  • Theme name
  • Base-theme selector for new themes
  • Separate Terminal and UI color sections
  • Color swatches and normalized hex values
  • Live preview
  • Save and delete actions

Saving selects the custom theme immediately. Deleting the active custom theme returns the application to a valid built-in fallback.

Use the Appearance page to export a custom theme to a portable JSON document or import a previously exported theme. Import validates the document version, required terminal fields, required UI fields, and color values before changing settings.

Theme files carry color data only. Terminal font family, font size, line height, application font, density, animation, render profile, and background image settings remain ordinary application settings so the same theme can be used with different layout preferences.

Related native appearance controls include:

  • Terminal font family, size, and line height
  • Application UI font family
  • UI density and border radius
  • Animation speed
  • Auto, Quality, Low Power, and Compatibility render profiles
  • Background image, opacity, blur, fit, and per-tab visibility
  • Platform vibrancy options when supported by the render policy

The Compatibility profile can disable expensive effects independently of the selected colors, which helps distinguish a rendering constraint from a theme problem.