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.
Built-in Themes
Section titled “Built-in Themes”OxideTerm ships 31 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.
Custom Themes
Section titled “Custom Themes”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.
Terminal Colors
Section titled “Terminal Colors”| Group | Fields |
|---|---|
| Base | Background, foreground, cursor, selection |
| ANSI | Black, red, green, yellow, blue, magenta, cyan, white |
| Bright ANSI | Bright variants of the eight ANSI colors |
The terminal painter reads these values directly when it builds GPUI draw output.
Application Colors
Section titled “Application Colors”| Group | Examples |
|---|---|
| Backgrounds | Main, panel, card, hover, active, secondary, elevated, sunken |
| Text | Primary, muted, secondary, heading |
| Borders | Standard, strong, divider |
| Accent | Accent, hover, accent text, secondary accent |
| Status | Success, warning, error, info |
These tokens style native tabs, panels, dialogs, menus, controls, status indicators, and editor surfaces.
Derive UI Colors
Section titled “Derive UI Colors”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.
- Choose or edit the terminal palette.
- Use Auto from Terminal in the UI color section.
- Review the generated application colors in the preview.
- Adjust individual colors as needed, then save.
Derivation is a starting point, not a lock. Every generated field remains editable.
Theme Editor
Section titled “Theme Editor”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.
Import and Export
Section titled “Import and Export”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.
Fonts and Appearance
Section titled “Fonts and Appearance”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.