Files
Dragon 300bde4ca3 feat: English translation fork of math-lrz/dsh-theme-pack
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.
2026-09-11 11:37:01 -06:00

6.6 KiB
Raw Permalink Blame History

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.

16-theme gallery


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 in src/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'
  1. Refresh the browser page (the patch layer hot-reloads, so dsh web usually 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:

  1. ctx.theme.register(...) × 16 (each registration hangs off ctx.effect and is unwound in reverse order when the plugin unloads);
  2. injects the theme picker component into the settings.general.item slot (reusing the built-in Appearance row's store / locale / inject patterns);
  3. registers the settings.themePack labels.

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.preference settings schema only accepts light / 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.