Translate all UI strings, docs, comments and preview pages to English; single English locale dictionary; theme labels carry one name each. Add scripts/render-previews.mjs (deterministic preview renders via playwright-core) and re-render all 17 preview PNGs at 1440x860. Palettes, token mapping and plugin behavior unchanged from upstream.
6.6 KiB
dsh-theme-pack
16 community theme skins for the DeepSeek Harness (DSH) Web GUI.
English fork of math-lrz/dsh-theme-pack — all documentation, UI strings and preview pages translated to English, structure and palettes unchanged. Catppuccin, Gruvbox, Everforest, Rosé Pine, Solarized, Kanagawa, Tokyo Night, Night Owl, Nord, Dracula, One Dark, with both dark and light variants where the source palette defines them.
Themes
| # | Theme | id | Scheme |
|---|---|---|---|
| 1 | Catppuccin Mocha | catppuccin-mocha |
dark |
| 2 | Catppuccin Latte | catppuccin-latte |
light |
| 3 | Gruvbox Dark | gruvbox-dark |
dark |
| 4 | Gruvbox Light | gruvbox-light |
light |
| 5 | Everforest | everforest |
dark |
| 6 | Rosé Pine | rose-pine |
dark |
| 7 | Rosé Pine Dawn | rose-pine-dawn |
light |
| 8 | Solarized Dark | solarized-dark |
dark |
| 9 | Solarized Light | solarized-light |
light |
| 10 | Kanagawa Wave | kanagawa |
dark |
| 11 | Tokyo Night | tokyo-night |
dark |
| 12 | Tokyo Night Storm | tokyo-storm |
dark |
| 13 | Night Owl | night-owl |
dark |
| 14 | Nord | nord |
dark |
| 15 | Dracula | dracula |
dark |
| 16 | One Dark | one-dark |
dark |
Per-theme preview images live in the previews/ directory (1440×860, headless renders of the simulated GUI page).
Features
- Zero intrusion: no stylesheets are rewritten; the skins only override the
--dsw-alias-*/--dsw-specific-*semantic tokens exposed by the DSH theme contract (80 per theme). Tokens that are not overridden fall back to the built-in palette, so skins never fight the base stylesheets. - No build chain required: the client bundle is a hand-writable lazy CJS module (
window.__ModuleLoader__.load), directly loadable without tsdown/vite. - Built-in picker: injects a "Theme skins (16)" panel under Settings → General; click a swatch cube to switch skins instantly.
- Single data source: the colors of all 16 themes derive from the one palette file
src/palettes.mjs; the mapping rules are centralized insrc/tokens.mjs.
Install
Prerequisite: a working DSH install with the web profile (dsh web available).
# 1) Install this repo into the web profile (git dependency)
dsh plugin --profile web add git+https://git.rewr.ca/Dragon/dsh-theme-pack.git
# 2) Append one loader insert to ~/.dsh/profiles/web/cordis.patch.yml:
# (the name must be the package name, not a file:/// path, otherwise the
# client-modules scanner cannot resolve the client bundle)
- insert:
- id: dsh-theme-pack
name: 'dsh-theme-pack'
- Refresh the browser page (the patch layer hot-reloads, so
dsh webusually does not need a restart).
Usage
Settings → General → "Theme skins (16)" appears below the built-in Appearance section: 16 swatch cubes (four-dot quick view of background / accent / success / error), click one to switch skins instantly. The built-in Light / Dark / Follow system options stay available, so you can always switch back.
How it works
The DSH theme contract is defined by @deepseek-ai/dsh-client-ui-theme:
ThemeRuntime.register({ id, colorScheme, tokens }) // register a third-party theme
│ tokens: { '--dsw-alias-*': '<css color>', ... }
▼
ui-layout's ThemePresenter writes the tokens as inline styles on <body>,
and sets body[data-ds-dark-theme] and color-scheme according to colorScheme
This plugin's client bundle does three things:
ctx.theme.register(...)× 16 (each registration hangs offctx.effectand is unwound in reverse order when the plugin unloads);- injects the theme picker component into the
settings.general.itemslot (reusing the built-in Appearance row's store / locale / inject patterns); - registers the
settings.themePacklabels.
The host half (lib/index.mjs) is a no-op plugin — it exists only to give the cordis Loader a loadable entry, so the dsh-client-modules scanner resolves the package name into the client boot graph, and the browser then fetches the real bundle from /plugins/dsh-theme-pack/client.js.
Repo structure
src/palettes.mjs the 16 palette primaries (single source of truth; change colors / add themes here)
src/tokens.mjs palette → 80 semantic token mapper
scripts/build.mjs generator: themes.json + client.js + preview/*.html
scripts/smoke.mjs smoke test: simulated cordis ctx validates 16 theme registrations + slot injection
scripts/render-previews.mjs re-shoots previews/*.png from preview/*.html (playwright-core)
lib/themes.json machine-readable theme definitions (id / colorScheme / label / swatches / tokens)
lib/client.js generated client bundle (do not edit by hand)
lib/index.mjs host-half no-op entry
preview/ per-theme GUI preview pages (screenshot sources)
previews/ rendered PNG preview images
Development
node scripts/build.mjs # after editing palettes.mjs, regenerate all artifacts
node scripts/smoke.mjs # smoke test (16 themes × 80 tokens, slot, dictionary)
Re-render the preview PNGs (deterministic, uses playwright-core):
node scripts/render-previews.mjs # picks up $CHROMIUM_PATH or ~/.cache/ms-playwright
Adding a new theme: append one palette object to src/palettes.mjs (id / scheme / bg / blue / status colors / syn syntax highlighting), run node scripts/build.mjs, and the token mapping, picker entry, labels and preview pages are derived automatically.
Known limitations
- Theme selection does not persist (upstream limitation): the built-in
ui-theme.preferencesettings schema only acceptslight / dark / system, so a third-party theme id is valid within the running process only (see the dsh-client-ui-theme README "Known Limitations"). After a page reload you land back on the built-in appearance and need to re-click the swatch. - A remote (non-localhost) browser can also select the themes, but likewise without persistence.
- Mask tokens (
--dsw-alias-bg-mask-*) deliberately keep the built-in defaults and are not part of the skin mapping.
License
MIT © 2026 math-lrz — this repository is an English translation fork.
Each theme's palette remains the property of its original theme authors (the maintainers of the Catppuccin, Gruvbox, Everforest, Rosé Pine, Solarized, Kanagawa, Tokyo Night, Night Owl, Nord, Dracula, One Dark and other open-source color schemes); this repo only does token mapping and packaging.
