From 9ed187ee52fc74bceed3b6cbd18029dc06a4695c Mon Sep 17 00:00:00 2001
From: Tommy <54511349+typeofTommy@users.noreply.github.com>
Date: Tue, 8 Jul 2025 15:30:05 -0500
Subject: [PATCH] docs: add terminal requirements (#708)

---
 packages/web/src/content/docs/docs/themes.mdx | 12 ++++++++++++
 1 file changed, 12 insertions(+)

diff --git a/packages/web/src/content/docs/docs/themes.mdx b/packages/web/src/content/docs/docs/themes.mdx
index 12559153..3defceae 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.