Просмотр исходного кода

docs: add terminal requirements (#708)

Tommy 7 месяцев назад
Родитель
Сommit
9ed187ee52
1 измененных файлов с 12 добавлено и 0 удалено
  1. 12 0
      packages/web/src/content/docs/docs/themes.mdx

+ 12 - 0
packages/web/src/content/docs/docs/themes.mdx

@@ -9,6 +9,18 @@ By default, opencode uses our own `opencode` theme.
 
 ---
 
+## Terminal requirements
+
+For themes to display correctly with their full color palette, your terminal must support **truecolor** (24-bit color). Most modern terminals support this by default, but you may need to enable it:
+
+- **Check support**: Run `echo $COLORTERM` - it should output `truecolor` or `24bit`
+- **Enable truecolor**: Set the environment variable `COLORTERM=truecolor` in your shell profile
+- **Terminal compatibility**: Ensure your terminal emulator supports 24-bit color (most modern terminals like iTerm2, Alacritty, Kitty, Windows Terminal, and recent versions of GNOME Terminal do)
+
+Without truecolor support, themes may appear with reduced color accuracy or fall back to the nearest 256-color approximation.
+
+---
+
 ## Built-in themes
 
 opencode comes with several built-in themes.