DSH Plugins Marketplace

DSH Plugins

Plugins

/

Themes & Skins

/

dsh-hero-theme

d

dsh-hero-theme

Manifest valid

HeroUI v3 theme builder for DeepSeek Harness Web and Desktop: live Accent hue, Base tint, font family, radius, form radius and light/dark controls, applied as one token-override layer with HeroUI Slid

UI (client)hasBundlePatch

dsh-hero-theme — HeroUI v3 theme builder for DeepSeek Harness

GitHub stars npm version npm downloads MIT license DSH ^0.2.2-rc.1 HeroUI v3 Theme builder PRs welcome

dsh-hero-theme

A HeroUI v3 theme builder for DeepSeek Harness Web and the embedded Desktop workspace.
Live controls and brand presets regenerate the complete DSH token layer — no rebuild, no profile restart.

English · 中文

Preview

HeroUI light theme preview HeroUI dark theme preview

Preview renders of the generated light and dark palettes in a representative DSH layout.

Highlights

Seven live controlsAccent (hue / chroma / lightness + vibrant), Base chroma, Font Family, Radius, Radius Form, Theme presets, Light / Dark / System.
167 tokens × 2 schemesEvery alias, specific, Shiki, radius, shadow and timing token is regenerated from the config.
HeroUI builder formulasAccent oklch(62.04% 0.195 hue), neutral chroma scaling, semantic hue rotation, radius scale.
Component geometryHeroUI Slider, Tabs, Select, Button, MenuSurface, Dialog and Tooltip geometry plus enter/exit motion.
No rebuild loopChanges apply through one ctx.theme.overrideTokens() layer and persist to the profile Cordis patch.
Reduced motion awareAll added transitions and enter/exit animations stop under prefers-reduced-motion: reduce.

Theme builder

HeroUI theme builder in light mode HeroUI theme builder in dark mode

Settings → General → HeroUI theme. The color slider, color disc, preset pickers and appearance tabs mirror the HeroUI themes page.

ControlRangeDefaultWhat it changes
Accenthue 0–360 · chroma 0–0.4 · lightness 0–1#0485F7Rainbow slider with an expandable color-disc panel (swatches, hex, shuffle); drives accent tokens, focus ring and gradient start
Basechroma 0–0.020.0015Chroma of every neutral (background, surfaces, text, borders)
Font FamilyInter / System UI / Geist / Manrope / IBM Plex Sans / JetBrains MonoInter--dsw-font-family and the brand stack
RadiusXS / S / M / L / XLM (8px)HeroUI radius scale and card radius (3×)
Radius FormXS / S / M / L / XLL (12px)Inputs and form fields
Theme11 presetsDefaultOne-click brand palettes: Sky, Lavender, Mint, Netflix, Uber, Spotify, Coinbase, Airbnb, Discord, Rabbit
Light / Dark / System—DarkBase color scheme and ctx.theme.setTheme()

The default accent is HeroUI blue #0485F7 at oklch(62.04% 0.195 253.83); the secondary gradient color is generated 31.67° around the wheel toward the HeroUI violet. Vibrant boosts accent chroma ×1.1 and neutral chroma ×1.8. Fonts must be installed locally — the stack falls back to System UI.

Generated palette

The generator mirrors the HeroUI v3 theme builder formulas:

TokenLightDark
backgroundoklch(97.02% base hue)oklch(12.00% base hue)
foregroundoklch(21.03% base hue)oklch(99.11% base hue)
surfaceoklch(100% 0.53×base hue)oklch(21.03% 2×base hue)
surface-secondaryoklch(95.24% 0.8×base hue)oklch(25.70% 1.53×base hue)
accentoklch(62.04% 0.195 hue)same
success / warning / dangerHeroUI semantic hues, rotated by 12% of the accent hue deltasame

Radii: HeroUI component tokens use 3× (cards), 2.5× (tabs), 2× + 6px (popovers) and a separate form radius. DSH's semantic scale is xs 0.5× / sm 1× / md 1.5× / lg 2× / xl-panel 3×, so native rows, menus and cards keep their intended proportions.

Brand layer

On top of the generated tokens, src/hero.css adds the recognizable HeroUI details:

  • Gradient primary actions — accent → accent + 31.67° (blue → violet at the default) with a soft glow.
  • Aurora wash — accent/violet gradients on the conversation canvas and sidebar.
  • HeroUI surfaces — composer and dialogs use the card radius; Dropdown/Select menu popovers use the 22px dropdown radius. Bubbles, selected sessions, menus and overlays never show the page through.
  • HeroUI controls — 36px secondary buttons with the 0.97 press scale, a sliding-indicator Tabs switch for the appearance, and a Select with a rotating chevron, 150ms scale/fade popover, 100ms exit and a stroke-drawn check.
  • HeroUI component layer — two-layer primary tables, borderless cards, 36px ListBox menus, Select triggers, flat kbd badges, tags and the right-side sheet follow the HeroUI v3 component CSS geometry.
  • HeroUI color sliders — 160×24 rainbow/chroma tracks with a 16px thumb and white ring; an invisible native range input keeps pointer, keyboard and aria semantics.
  • Motion — button scale(0.97), popover/dialog/tooltip enter scales, 2s skeleton shimmer, user-message entrance; all disabled under prefers-reduced-motion.

Install

# DSH Web
dsh plugin --profile web add dsh-hero-theme
# DSH Desktop
dsh plugin --profile desktop add dsh-hero-theme

Or install manually into the Web profile:

cd ~/.dsh/profiles/web
pnpm add dsh-hero-theme

Add "dsh-hero-theme" to dsh.profile.bundles in that profile's package.json and restart the profile.

Then open Settings → General → HeroUI theme. Pick an accent on the color slider or the disc panel, choose Radius presets, a theme preset and a font; every change applies immediately and is saved into the active profile's Cordis patch. Reset returns to the builder defaults.

Changelog

0.2.16 — 2026-11-14

  • Appearance tabs and the live-preview pill now hug their content instead of stretching across the whole settings column.
  • Fixed theme switches bouncing old → new → old: the builder ignores stale echoes of its own pending writes, and skips theme adoption while its scheme write is still in flight.

0.2.15 — 2026-11-13

  • Theme builder rebuilt to match the HeroUI themes page: rainbow Accent slider with an expandable color-disc panel (chroma / lightness / vibrant, swatches, hex, shuffle), Radius & Radius Form preset pickers, and an 11-preset Theme gallery (Default, Sky, Lavender, Mint, Netflix, Uber, Spotify, Coinbase, Airbnb, Discord, Rabbit).
  • HeroUI component layer across DSH surfaces: two-layer primary tables, borderless cards, 36px ListBox menu items with end-aligned checks, Select triggers, flat kbd badges, tags, a field-shell search focus ring, and the right-side sheet.
  • Select triggers, switch, kbd, table, tag, card, disclosure and empty-state geometry aligned with HeroUI v3 component CSS.

0.2.14 — 2026-11-13

  • Restored true capsule shapes for slider tracks, thumbs and tabs — corner-shape: round over the host's global superellipse default, with inline capsule radii for slider and tab controls.

0.2.13 and earlier

  • HeroUI v3 token generator (167 tokens × light/dark), six-control builder, brand gradient layer, aurora wash and HeroUI motion. See the commit history.

How it works

flowchart LR
  A[Profile Config<br/>6 volatile fields] --> B[src/palette.js]
  B --> C[167 tokens<br/>light + dark]
  C --> D[ctx.theme.overrideTokens]
  D --> E[DSH Web / Desktop UI]
  1. The Host declares six volatile Config fields: theme, accentHue, baseChroma, fontFamily, radius, fieldRadius.
  2. The browser half reads that config and calls buildAllTokens() to generate both light and dark palettes.
  3. The result is applied as one ctx.theme.overrideTokens() layer; ctx.theme.setTheme(config.theme) switches the built-in base scheme.
  4. The settings row writes each field through ConfigForms (range writes are debounced by 180ms).
  5. An external change to the built-in Appearance row is adopted into theme, so reloads keep the same appearance.

The override disposer is deferred with queueMicrotask so removing the layer never re-enters the theme/change dispatch.

Platform compatibility

dsh-hero-theme is a Web client plugin (dsh.client.platform: "web"). DSH Desktop embeds the Web application, so the theme applies there through the Web client plugin loader; Desktop has its own profile. This package styles the embedded workspace only — it does not add native menu, tray, or window-shell UI.

Requires DSH ^0.2.2-rc.1.

Develop

npm run build   # regenerates lib/client.js + lib/index.js
npm run check   # build, syntax, API contract, palette and contrast checks

src/palette.js is the single source of truth for colors, radii and fonts. It is injected into the client bundle at build time; its default output is covered by contrast and token-set checks.

Repository layout

dsh-hero-theme/
├── package.json          # dsh.bundle.patch + dsh.client manifest
├── cordis.patch.yml      # loader entry insert (id: dsh-hero-theme)
├── src/
│   ├── index.js          # Host Config schema (six volatile fields)
│   ├── palette.js        # HeroUI v3 palette generator
│   ├── client.tpl.js     # browser half: builder row + token application
│   └── hero.css          # brand gradient, aurora, opaque surfaces, motion
├── scripts/
│   ├── build.mjs         # zero-dependency build
│   └── check-compat.mjs  # DSH API, palette, contrast and CSS contract
├── .github/asset/        # README banner and preview renders
├── LICENSES/             # Apache-2.0 text for the HeroUI-derived material
└── lib/                  # generated artifacts (rebuilt on install/pack)

Attribution and license

The plugin code is MIT-licensed (see LICENSE). Design tokens and interaction values are derived from HeroUI, which is Apache-2.0 licensed; see NOTICE and LICENSES/Apache-2.0.txt.

This is an independent theme. It is not affiliated with or endorsed by HeroUI.

Comments

Loading…

Similar plugins

dsh-theme-studio

by marselarts

Theme Studio for the DeepSeek Harness Web UI: edit the design-system color tokens and fonts per light/dark scheme, in Settings or in a movable panel over the app.

Manifest valid

★ 0

MIT

JavaScript

Oct 1, 2026

dsh plugin --profile web add dsh-theme-studio

✦

No screenshots

by Smith-yue

Adds two switchable themes, built-in and local-folder background slideshows, and per-session token usage details to DeepSeek Harness Web and Desktop.

Themes & SkinsUI & ExperienceManifest valid

★ 1

↓ 119/wk

MIT

TypeScript

Aug 23, 2026

dsh plugin --profile web add dsh-skin-token-dashboard

by STA-running

Lightweight UI tint plugin for DeepSeek Harness desktop (deepseek-harness-desktop): per-region colors, presets, vividness, scheme-adaptive tints

Manifest valid

★ 0

MIT

TypeScript

Aug 15, 2026

dsh plugin --profile web add @deepseek-ai/dsh-client-ui-anime-theme
dsh-style-hub3

No screenshots

by Au1314

Theme studio for the DeepSeek Harness web GUI: eight switchable preset styles, accent and panel-translucency fine-tuning, host-side wallpapers painted on the first frame, and a one-click fix when the

Themes & SkinsManifest valid

★ 0

MIT

TypeScript

Sep 26, 2026

dsh plugin --profile web add dsh-style-hub

✦

No screenshots

by Theflowyears

Arknights theme pack for the DeepSeek Harness Web GUI: wallpapers with saturation-driven edge blur, an acrylic sidebar, and a one-click wallpaper picker.

Themes & SkinsDevelopment & InfrastructureManifest valid

★ 8

↓ 2.2k/wk

NOASSERTION

JavaScript

Nov 16, 2026

dsh plugin --profile web add dsh-arknights-theme
dsh-workbench-theme5

No screenshots

Light/dark theme with APTX logo and optional artwork panels for official DeepSeek Harness Web

Themes & SkinsManifest valid

★ 0

MIT

JavaScript

dsh plugin --profile web add dsh-workbench-theme