summaryrefslogtreecommitdiffhomepage
diff options
context:
space:
mode:
authorTommy <[email protected]>2025-07-08 15:30:05 -0500
committerGitHub <[email protected]>2025-07-08 15:30:05 -0500
commit9ed187ee52fc74bceed3b6cbd18029dc06a4695c (patch)
treeedd7716218cef196fd0304fd067b50d9b7a8aa42
parent14d81e574b4c4f308c477feca695337447e8cac1 (diff)
downloadopencode-9ed187ee52fc74bceed3b6cbd18029dc06a4695c.tar.gz
opencode-9ed187ee52fc74bceed3b6cbd18029dc06a4695c.zip
docs: add terminal requirements (#708)
-rw-r--r--packages/web/src/content/docs/docs/themes.mdx12
1 files changed, 12 insertions, 0 deletions
diff --git a/packages/web/src/content/docs/docs/themes.mdx b/packages/web/src/content/docs/docs/themes.mdx
index 125591532..3defceaea 100644
--- a/packages/web/src/content/docs/docs/themes.mdx
+++ b/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.