Futuristic themes for DeepSeek Harness Desktop
Four cinematic themes for DeepSeek Harness, built from the four original design briefs and
the concept rendering in docs/design-briefs/, and delivered as one
installable plugin for DeepSeek Harness Desktop.
| Nostromo Amber | Omni-tool | Pure Reflection | Renaissance Steel |
|---|---|---|---|
![]() |
![]() |
![]() |
![]() |
Settings → General → Futuristic themes — the row the plugin adds, shown with Nostromo Amber
and Pure Reflection active:
| Nostromo Amber active | Pure Reflection active |
|---|---|
![]() |
![]() |
The three dark themes applied to the real app:
![]() |
![]() |
![]() |
What is here
| Path | What it is |
|---|---|
dsh-futuristic-themes/ |
the plugin: four registered themes, one Appearance row, optional decorative layer |
docs/THEME-CONTRACT.md |
authoring contract: palette roles, token derivation, effects rules, preview loop |
docs/INSTALL.md |
Desktop install (plugin manager or manual profile edit) and rollback |
docs/qa/ |
independent audit harness output + end-to-end verification reports and screenshots |
tools/ |
WKWebView screenshot harness, independent theme audit, Desktop installer |
docs/design-briefs/ |
the original design briefs for each theme (Russian, verbatim) + the concept rendering, with English digests |
The four themes
Nostromo Amber — retro CRT terminal
Original brief: docs/design-briefs/Nostromo-Amber.md
Almost-black warm metal (#0B0804), amber phosphor (#FFB000 accents, #FFD98A text),
1 px amber bezels, monospace type, restrained CRT layer (fine scanlines, phosphor halo, heavy
vignette). Hot #FF4A1C warnings and #7FBF3F OK states. No glow on long-form text; long
sessions stay readable.
Omni-tool — holographic HUD
Original brief: docs/design-briefs/Omni-tool.md
Dark blue glass (#0A0D12, four glass surface steps), orange action accent (#FF9A1F),
cold cyan secondary signals (#3FD0FF reserved for informational states), warm #F2E3C9
text, thin warm frames. Decorative layer: top-fading cyan/warm projection grid + corner glows.
Orange commands actions; cyan never competes with it.
Pure Reflection — sterile white architecture
Original brief: docs/design-briefs/Pure-Reflection.md
The light theme of the set: off-white canvas (#F4F5F2), pure white panels (#FFFFFF),
near-white dialogs and inputs (#F7F8F5), cold grey borders (#D3D7D3) and hover surfaces
(#E9EBE8), almost-black text (#202426), and a single saturated red accent (#E53935,
hover #FF514A). Muted green #568C72 and burnt orange #D25C28 are reserved for states;
error text is a darker #C62828. Inter for interface copy, IBM Plex Mono for logs, code,
identifiers and metrics. Decorative layer: overhead daylight wash, two red hairline corner
marks, a chamfered bottom-right corner and a restrained vignette — no scanlines, noise, glow
or motion. Red is dosed: selection markers, the primary action and focus, never success,
warning or long text.
Renaissance Steel — cold industrial console
Original brief: docs/design-briefs/Renaissance-Steel.md
Flat steel surfaces (#07090C / #0E1318), 1 px blue-grey frames (#26323D), #5FB4E6
accent, #BCD0E0 text, #5FD3B0 success, #E2553F warning. Almost no glow: a faint overhead
light, a hairline steel bezel and a soft corner vignette — the calmest dark theme of the set.
All four replace the complete semantic --dsw-* token set (127 derived tokens each; Pure
Reflection adds two light-mode tokens and registers 129). The three dark themes switch the
interface to a monospace stack; Pure Reflection uses Inter for interface copy and keeps IBM
Plex Mono for technical roles. The decorative layer can be disabled in one click and respects
prefers-reduced-motion. The three dark themes are dark-only by design; Pure Reflection is
the light counterpart.
How it works
- The plugin registers four theme definitions through the host's official third-party theme
extension point (
ctx.theme.register) and contributes onesettings.general.itemrow. - A compact palette (15 roles + optional per-token overrides) is expanded by
scripts/lib/derive.mjsinto the full token set, so every theme is complete by construction; the build fails on missing required tokens and warns on contrast regressions. The derivation is optimised for dark surfaces, so the light theme carries a small, documented set of overrides (white labels on accent fills and the switch thumb, dark tooltips/toasts, a darker error red, a readable caption, a lighter modal scrim). ui-theme.preferenceonly acceptslight|dark|system, so a theme id is never written there (that would crash the next boot withtheme registry lost). The selected theme lives inlocalStorageand is re-applied after the host settings document loads; the durable preference stays a built-in value, which keeps the first paint stable.- Choosing the host's built-in Light/Dark/System appearance exits the theme deliberately and does not resurrect it on reload.
- Nothing host-side is registered: no services, routes, tools or settings namespaces. The
browser half imports only
react+ the host services it declares. Decorations are a single pointer-events-transparent overlay.
Verification
- Static audit (
tools/audit-themes.mjs, independent of the build): 197/197 checks PASS, 0 failures, 0 warnings — package shape, four theme definitions, 127/127/129/127-token derivation, full WCAG contrast matrix, effects-CSS discipline, built-bundle truth. - End-to-end verification for the three dark themes on a live
dsh webinstance (docs/qa/verification-report.md): 8/8 items PASS — all three themes via the row and via persisted reload, live body tokens byte-identical to the derived sets (127/127 × 3), persistence with no palette flash, clean exit path, effects switch (pixel-diff confined to the overlay), menus/composer/settings regressions clean, live contrast body 12.6–15.4:1 and composer 11.2–13.1:1. - Pure Reflection live check on a private
dsh webinstance (2026-11-13,docs/qa/pure-reflection-verification.md): registers as a light theme with all 129 tokens inline,color-scheme: light; five-card row with the Pure Reflection card active; settings dialog and empty state checked in English (account menu and onboarding dialog in the Russian locale); effects switch pixel-diff 4.7 % confined to the overlay; live contrast 14.3:1 body, 14.0:1 composer, 13.7:1 sidebar, zero low-contrast text in the DOM scan. - Two LOW defects found by the dark-theme verifier (boot-restore grace race; missing explicit
:focus-visiblering) are fixed and re-verified; details and evidence (28+ screenshots, reproducible step scripts) are indocs/qa/.
Install / use
The canonical source is this GitHub repository — the installable package is the
dsh-futuristic-themes/ folder, and the Desktop profile installs it
straight from GitHub (pinned per commit):
git clone https://github.com/ihodorchenko/dsh-futuristic-themes.git
cd dsh-futuristic-themes
tools/install-desktop.sh # install into the Desktop profile
tools/install-desktop.sh --update # update to the latest GitHub commit
tools/install-desktop.sh --local # development: link the working copy instead
Then open Settings → General → Futuristic themes. In-app plugin manager, dsh web
installs, the manual profile edit and rollback are documented in
docs/INSTALL.md.
Develop
NODE="$HOME/.dsh/dsh-runtimes/dsh-primary-runtime/dependencies/node/bin/node"
cd dsh-futuristic-themes
$NODE scripts/build.mjs # derive tokens from src/themes/*.json → lib/client.js
$NODE scripts/build.mjs --check # validate only
$NODE scripts/preview.mjs # build/preview.html + one mock per theme
$NODE ../tools/audit-themes.mjs # independent 197-check audit
lib/client.js is committed (no build step on the user's machine); the source template and
per-theme data are in src/.
Compatibility
DeepSeek Harness Desktop 0.2.1-rc.5 and the matching dsh web; also smoke-tested on
Desktop 0.2.2-rc.2. Requires the host theme extension point (@deepseek-ai/dsh-client-ui-theme)
and the settings.general.item slot. Tested in this environment only.
License
MIT © 2026 Ihar Khadorchanka.
The original design briefs in docs/design-briefs/ and the concept
rendering are part of this repository and covered by the same license.









No comments yet. Be the first to write one.