# Themes

Themes control colors and readability in the interactive TUI. Voxcode ships with 11 built-in themes (default: `midnight`) and supports custom user themes.

## Available Themes

Built-in themes include `midnight`, `solarized-light`, `solarized-dark`, `dracula`, `nord`, `monokai`, `github-light`, `github-dark`, `one-light`, `one-dark`, and `minimal`.

## Custom Themes

Place custom theme JSON files in `~/.config/voxcode/themes/`. Themes use a TypeBox-validated schema with 55+ color tokens:

```json
{
  "name": "my-theme",
  "type": "dark",
  "colors": {
    "bg": "#1a1b26",
    "fg": "#c0caf5",
    "accent": "#7aa2f7",
    "error": "#f7768e",
    "warning": "#e0af68",
    "success": "#9ece6a",
    "info": "#7dcfff",
    "border": "#3b4261",
    "selection": "#33467c"
  }
}
```

Select a theme via settings:

```json
{
  "theme": "my-theme"
}
```

Or via the TUI theme selector in interactive mode.

## OSC 11 Terminal Detection

Voxcode auto-detects terminal background color via OSC 11 escape sequences and adapts theme selection accordingly.

## Theme Guidelines

- Ensure high contrast for code and diagnostics
- Prefer stable palettes across light and dark terminals
- Keep semantic colors consistent (error, warning, success, info)

## Team Tip

Standardize one default theme in team onboarding docs.
