diff --git a/THEMES.md b/THEMES.md
index 1fa8c9c8..e3191f71 100644
--- a/THEMES.md
+++ b/THEMES.md
@@ -144,6 +144,36 @@ font size. Persists alongside theme and skin.
---
+## Typography Tokens
+
+The three font tokens are declared in `static/style.css`:
+
+- `--font-ui`: user interface chrome, controls, composer chrome, labels, and
+ ordinary non-code UI text
+- `--font-conversation`: user/assistant message prose
+- `--font-mono`: code, tool details, logs, identifiers, and terminal text
+
+By default:
+
+```css
+--font-conversation: var(--font-ui);
+--font-mono: ui-monospace,"SFMono-Regular","SF Mono",Menlo,Consolas,"Liberation Mono",monospace;
+```
+
+For CSS-based custom skins and extension stylesheets/scripts, override the three
+font tokens directly (`--font-ui`, `--font-conversation`, `--font-mono`) on the
+skin root (`:root[data-skin="..."]`), including any mode-specific variant.
+`window.registerHermesSkin()` currently accepts only the documented design-token
+allowlist (no `--font-*` tokens), so custom font families should be supplied via
+CSS rather than skin registration.
+
+Leaving `--font-conversation` untouched keeps prose coupled to `--font-ui`;
+override it only when a different reading face is explicitly required. Avoid
+hard-coded selector-level font declarations when one of these tokens already
+expresses the intent.
+
+---
+
## How It Works Internally
1. **Theme:** `document.documentElement.classList.toggle('dark', isDark)` —
diff --git a/docs/UIUX-GUIDE.md b/docs/UIUX-GUIDE.md
index 5791fe3b..0fe44958 100644
--- a/docs/UIUX-GUIDE.md
+++ b/docs/UIUX-GUIDE.md
@@ -96,16 +96,25 @@ unless the code and tests prove it is implemented.
## Typography and content
-Use split typography intentionally:
+Use three explicit font tokens:
-- assistant prose uses the same system sans stack as the rest of the UI by
- default (`--font-ui` in `static/style.css`),
-- editorial serif assistant prose is historical/proposal or skin-scoped only;
- do not reintroduce a global assistant serif without explicit design approval
- plus code and test evidence,
-- user bubbles and functional UI also use the system sans stack unless a scoped
- skin intentionally overrides typography,
-- monospace is for code, file paths, commands, tool names, and compact metadata.
+- `--font-ui`: shell chrome, controls, composer, labels, and ordinary UI text
+- `--font-conversation`: user/assistant message prose; by default this is
+ `var(--font-ui)` in `static/style.css`
+- `--font-mono`: code, file paths, command lines, tool payloads, technical logs,
+ and terminal output
+
+Use semantic tokens for typography. Keep prose on `--font-conversation` by
+default so it tracks `--font-ui` whenever a skin intentionally retunes UI type.
+Override `--font-conversation` only for a skin that intentionally wants a
+distinct prose face.
+Conversation prose must remain the system sans by default. Do not introduce a
+global conversation serif through the `--font-conversation` token or
+selector-level overrides without explicit design approval plus code and test
+evidence; keep distinct editorial prose typography explicitly opt-in or
+skin-scoped.
+Avoid hard-coding selector-level font stacks when a token already carries the
+intent.
Keep scale tight. Avoid introducing near-duplicate one-off font sizes, colors,
radius values, or spacing values when an existing token works.
diff --git a/static/boot.js b/static/boot.js
index e13d35de..c0d50011 100644
--- a/static/boot.js
+++ b/static/boot.js
@@ -3871,5 +3871,5 @@ async function shutdownServer() {
function _showServerStopped() {
var stoppedMsg = (typeof t === 'function' ? t('settings_shutdown_stopped_message') : 'Server stopped. You can close this tab.');
- document.body.innerHTML = '';
+ document.body.innerHTML = '';
}
diff --git a/static/index.html b/static/index.html
index 8e9568de..10e5dc9c 100644
--- a/static/index.html
+++ b/static/index.html
@@ -1718,7 +1718,7 @@
-
+
diff --git a/static/panels.js b/static/panels.js
index f625103c..3024b725 100644
--- a/static/panels.js
+++ b/static/panels.js
@@ -12312,7 +12312,7 @@ function _openAuxAdvancedOptions(taskCfg,cfg){
_auxAdvancedInputHtml('auxAdvancedBaseUrl',t('settings_aux_advanced_base_url')||'Base URL',_auxAdvancedValue(cfg,'base_url'),t('settings_aux_advanced_base_url_desc')||'Optional provider endpoint override.','text','inputmode="url"')+
serviceTierField+
timingFields+
- `${esc(t('settings_aux_advanced_extra_body')||'Extra body JSON')} ${esc(t('settings_aux_advanced_extra_body_desc')||'Optional JSON object merged into the model request body.')} ${esc(t('settings_aux_advanced_extra_body')||'Extra body JSON')} ${esc(t('settings_aux_advanced_extra_body_desc')||'Optional JSON object merged into the model request body.')} ${esc(t('settings_aux_advanced_api_key_clear')||'Clear existing API key override')}
+