Docs/Configuração e automação/Temas

Preto verdadeiro
de fábrica.

O MVCode nasce com o tema maxvision — preto absoluto, vermelho da casa como único acento — e traz uma coleção de temas embarcados, um modo que adapta ao seu terminal e um formato JSON para criar o seu.

Disponível agoraReferência /themes1 min de leitura

01Trocando

dentro da TUI

/themes

Ou fixe no tui.json:

tui.jsonjson

{
  "theme": "maxvision"
}

Truecolor obrigatório

Temas completos exigem 24-bit color. Cheque com echo $COLORTERM — deve responder truecolor ou 24bit. Sem isso, as cores caem para a aproximação de 256.

02O tema maxvision

É a identidade da casa aplicada ao terminal e ao app: canvas em preto verdadeiro, acento #A93636 em seleção, links e execução, sintaxe calibrada para AA sobre preto, e o mesmo par dark/light das demais superfícies. É o default de fábrica — e a referência de como um tema deve se comportar no produto.

03Embarcados

Tema	Nota
maxvision	O default — marca da casa, dark e light.
system	Adapta ao terminal: gera a escala de cinza do seu background e usa as cores ANSI do seu esquema.
tokyonight · catppuccin · gruvbox · nord · kanagawa · everforest · ayu · one-dark · matrix …	Coleção clássica, em expansão contínua.

04Criando o seu

Temas são JSON carregados em cascata — depois vence:

Embarcados no binário
Usuário — ~/.config/<dir>/themes/*.json
Raiz do projeto — .maxvision-code/themes/*.json
Diretório atual — ./.maxvision-code/themes/*.json

.maxvision-code/themes/meu-tema.jsonjson

{
  "$schema": "https://opencode.ai/theme.json",
  "defs": {
    "ink": "#0d0d0d",
    "blood": "#A93636"
  },
  "theme": {
    "primary": { "dark": "blood", "light": "blood" },
    "text": { "dark": "#f5f5f5", "light": "ink" },
    "background": { "dark": "none", "light": "#ffffff" },
    "diffAdded": { "dark": "#5fbf77", "light": "#1d7a3e" }
  }
}

O formato aceita:

Hex ("#ffffff"), ANSI (3, 0–255) e referências às cores de defs.
Variantes dark/light por chave — o tema inteiro acompanha o modo.
"none" — herda a cor default do terminal; a base dos temas que se fundem ao seu esquema.

As chaves cobrem UI (primary, background*, border*), estados (error, warning, success, info), diff (diffAdded, diffRemovedBg, gutter…), markdown (markdownHeading, markdownCode…) e sintaxe (syntaxKeyword, syntaxString…).

05No app e no desktop

Fora do terminal, o tema aparece na grade de swatches em Settings → Aparência — cada tema como um cartão de 4 faixas, com anel vermelho no ativo. Dark e light seguem o sistema ou a sua escolha fixa.

Compatibilidade · schema de tema

O $schema dos arquivos de tema permanece https://opencode.ai/theme.json — validação herdada do núcleo. Temas criados para o opencode funcionam no MVCode sem alteração.