dsh-hero-theme
Manifest validHeroUI 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
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
Preview renders of the generated light and dark palettes in a representative DSH layout.
Highlights
| Seven live controls | Accent (hue / chroma / lightness + vibrant), Base chroma, Font Family, Radius, Radius Form, Theme presets, Light / Dark / System. |
| 167 tokens × 2 schemes | Every alias, specific, Shiki, radius, shadow and timing token is regenerated from the config. |
| HeroUI builder formulas | Accent oklch(62.04% 0.195 hue), neutral chroma scaling, semantic hue rotation, radius scale. |
| Component geometry | HeroUI Slider, Tabs, Select, Button, MenuSurface, Dialog and Tooltip geometry plus enter/exit motion. |
| No rebuild loop | Changes apply through one ctx.theme.overrideTokens() layer and persist to the profile Cordis patch. |
| Reduced motion aware | All added transitions and enter/exit animations stop under prefers-reduced-motion: reduce. |
Theme builder
Settings → General → HeroUI theme. The color slider, color disc, preset pickers and appearance tabs mirror the HeroUI themes page.
| Control | Range | Default | What it changes |
|---|---|---|---|
| Accent | hue 0–360 · chroma 0–0.4 · lightness 0–1 | #0485F7 | Rainbow slider with an expandable color-disc panel (swatches, hex, shuffle); drives accent tokens, focus ring and gradient start |
| Base | chroma 0–0.02 | 0.0015 | Chroma of every neutral (background, surfaces, text, borders) |
| Font Family | Inter / System UI / Geist / Manrope / IBM Plex Sans / JetBrains Mono | Inter | --dsw-font-family and the brand stack |
| Radius | XS / S / M / L / XL | M (8px) | HeroUI radius scale and card radius (3×) |
| Radius Form | XS / S / M / L / XL | L (12px) | Inputs and form fields |
| Theme | 11 presets | Default | One-click brand palettes: Sky, Lavender, Mint, Netflix, Uber, Spotify, Coinbase, Airbnb, Discord, Rabbit |
| Light / Dark / System | — | Dark | Base 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:
| Token | Light | Dark |
|---|---|---|
| background | oklch(97.02% base hue) | oklch(12.00% base hue) |
| foreground | oklch(21.03% base hue) | oklch(99.11% base hue) |
| surface | oklch(100% 0.53×base hue) | oklch(21.03% 2×base hue) |
| surface-secondary | oklch(95.24% 0.8×base hue) | oklch(25.70% 1.53×base hue) |
| accent | oklch(62.04% 0.195 hue) | same |
| success / warning / danger | HeroUI semantic hues, rotated by 12% of the accent hue delta | same |
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 underprefers-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: roundover 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]
- The Host declares six volatile Config fields:
theme,accentHue,baseChroma,fontFamily,radius,fieldRadius. - The browser half reads that config and calls
buildAllTokens()to generate both light and dark palettes. - The result is applied as one
ctx.theme.overrideTokens()layer;ctx.theme.setTheme(config.theme)switches the built-in base scheme. - The settings row writes each field through ConfigForms (range writes are debounced by 180ms).
- 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
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.
★ 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.
★ 1
↓ 119/wk
MIT
TypeScript
Aug 23, 2026
dsh plugin --profile web add dsh-skin-token-dashboardby STA-running
Lightweight UI tint plugin for DeepSeek Harness desktop (deepseek-harness-desktop): per-region colors, presets, vividness, scheme-adaptive tints
★ 0
MIT
TypeScript
Aug 15, 2026
dsh plugin --profile web add @deepseek-ai/dsh-client-ui-anime-themeby 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
★ 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.
★ 8
↓ 2.2k/wk
NOASSERTION
JavaScript
Nov 16, 2026
dsh plugin --profile web add dsh-arknights-themeLight/dark theme with APTX logo and optional artwork panels for official DeepSeek Harness Web
★ 0
MIT
JavaScript
dsh plugin --profile web add dsh-workbench-theme
