Built-in Themes

Ultra ships with the beautiful Catppuccin palette and One Dark

Catppuccin Frappe

Default

A soothing dark theme with pastel colors. Perfect for long coding sessions.

Catppuccin Mocha

The darkest Catppuccin variant. Maximum contrast for OLED displays.

Catppuccin Macchiato

A balanced dark theme between Frappe and Mocha.

Catppuccin Latte

Light theme for daytime coding or bright environments.

One Dark

The iconic Atom theme, now in your terminal.

Changing Your Theme

Switch themes instantly via the command palette or by editing your settings file.

Via Command Palette

  1. Press Ctrl+Shift+P to open the command palette
  2. Type "theme" or "color theme"
  3. Select Preferences: Color Theme
  4. Use arrow keys to preview themes, Enter to select

Via Settings

Edit ~/.ultra/settings.jsonc:

{
  "workbench.colorTheme": "Catppuccin Frappe"
}

Available Theme Names

  • Catppuccin Frappe (default)
  • Catppuccin Mocha
  • Catppuccin Macchiato
  • Catppuccin Latte
  • One Dark

Using Custom Themes

Ultra supports VS Code-compatible theme files. Drop them in your themes folder and they'll appear in the theme picker.

Installing a Theme

  1. Download a VS Code theme JSON file
  2. Place it in ~/.ultra/themes/
  3. Restart Ultra or reload the window
  4. Select the theme from the command palette

Theme File Structure

Themes use the standard VS Code format. Here's a minimal example:

~/.ultra/themes/my-theme.json
{
  "name": "My Custom Theme",
  "type": "dark",
  "colors": {
    "editor.background": "#1a1b26",
    "editor.foreground": "#a9b1d6",
    "activityBar.background": "#16161e",
    "sideBar.background": "#16161e",
    "statusBar.background": "#16161e",
    "terminal.background": "#1a1b26",
    "terminal.foreground": "#a9b1d6"
  },
  "tokenColors": [
    {
      "scope": ["comment"],
      "settings": {
        "foreground": "#565f89",
        "fontStyle": "italic"
      }
    },
    {
      "scope": ["keyword"],
      "settings": {
        "foreground": "#bb9af7"
      }
    },
    {
      "scope": ["string"],
      "settings": {
        "foreground": "#9ece6a"
      }
    }
  ]
}

Popular Themes to Try

UI Customization

Beyond themes, you can customize many aspects of Ultra's appearance.

Editor Settings

{
  // Font settings
  "editor.fontFamily": "JetBrains Mono",
  "editor.fontSize": 14,
  "editor.lineHeight": 1.5,

  // Line numbers
  "editor.lineNumbers": "on",  // "on" | "off" | "relative"

  // Cursor style
  "editor.cursorStyle": "line",  // "line" | "block" | "underline"
  "editor.cursorBlinking": "blink",

  // Minimap
  "editor.minimap": true,
  "editor.minimap.renderCharacters": false,

  // Whitespace
  "editor.renderWhitespace": "selection",

  // Indent guides
  "editor.renderIndentGuides": true,

  // Word wrap
  "editor.wordWrap": "off"  // "off" | "on" | "wordWrapColumn"
}

Workbench Settings

{
  // Sidebar position
  "workbench.sideBar.location": "left",

  // Status bar visibility
  "workbench.statusBar.visible": true,

  // Tab settings
  "workbench.editor.showTabs": true,
  "workbench.editor.tabCloseButton": "right",

  // Icons
  "workbench.iconTheme": "default"
}

Terminal Settings

{
  // Terminal font (inherits from editor if not set)
  "terminal.fontFamily": "JetBrains Mono",
  "terminal.fontSize": 13,

  // Scrollback buffer
  "terminal.scrollback": 1000,

  // Cursor
  "terminal.cursorStyle": "block",
  "terminal.cursorBlink": true
}

Make Ultra yours

Install Ultra and customize it to match your style.