dsh-bloom-theme

📌 Desktop-first — a note about the DSH Web UI

Short version: Bloom's next iterations target the DSH desktop app first. The Web UI is no longer actively supported and will fade out.

(0.16.0 and earlier were built against the DSH Web UI. 0.17.0 is the desktop-ready release — it brings the DSH 0.2.0 selector adaptation plus a drift gate that catches this class of breakage automatically.) On desktop app 0.2.1-rc.5, the switcher's version display uses the desktop app version rather than an older bundled DSH package version; the drift gate also targets the locally installed desktop release.

DSH now ships a desktop app, and it is what I use every day. A theme's value lives on top of a UI — when the host changes its interface, the palettes and the glass have to follow — so that is where the work goes now.

What this means for you:

Two clarifications, so you do not have to guess from the heading:

• Installed versions keep working. What stops is "growing with the new UI", not "breaking what you have".
• If the Web UI is your only option, please open an issue and describe your setup — real demand changes my judgement. That is not a formality.

What the previous version (0.16.0) changed: running steps now take on the theme color (the sweep went from grey to the three Bloom tones); the round-status spectrum is wired back up (it vanished silently when DSH was renamed); the message-bubble glass edge that never drew in light mode is fixed; substring-selector self-overlap ("box inside a box", the square black chip) is fixed; the pill background on running steps is gone — state should not have to shout from a box.

The gist

A glass + Morandi theme for DeepSeek Harness. Eight light/dark palettes, adaptive by light/dark; panels are real frosted glass (semi-transparent + backdrop blur + glass edges); colors are low-saturation Morandi (OKLCH, WCAG AA); restrained, consistent micro-interactions; zero runtime deps; TypeScript front-end.

The Morandi character does not live in --accent. It lives in --accent-rgb.

Quick start

• DSH desktop app: install from the in-app plugin manager and reload — a 「黛蓝 ▾」 button appears in the top bar to switch between the 10 palettes, light/dark, and wallpapers.
• Custom profiles (CLI / server / web): dsh plugin --profile <profile> add dsh-bloom-theme, wire it into the boot graph, restart DSH — see Install below.

Screenshots

10 palettes (light): click any one and the whole accent / background / glass / motion hue switches together.

Every palette has a dark variant too (example: Amber · dark):

Install

Desktop app: install and update from the plugin manager inside the app. The desktop profile is owned exclusively by the application — running dsh plugin --profile desktop ... from a shell fails with profile "desktop" is managed exclusively by the Electron application. That is by design, not a permissions problem.

Only Node.js is required — no global dsh install; upstream's official entry is npx @deepseek-ai/dsh. If dsh is installed globally, use dsh instead.

# 1) install into your profile (use your own profile name)
npx @deepseek-ai/dsh plugin --profile <your-profile> add dsh-bloom-theme

# 2) wire it into the boot graph: add "dsh-bloom-theme" to the
#    dsh.profile.bundles array in ~/.dsh/profiles/<your-profile>/package.json

# 3) restart DSH

Refresh the page and a "Mist ▾" theme button appears top-right. Click it to switch between 10 palettes; the current version sits at the bottom of the dropdown, and a ↑ vX badge lights up when a newer version is on npm (jump to the Releases page).

Features

Design: two-track colors

Bloom's point was never "swap the colors" — it is a complete Morandi design language: low-saturation ambient gradients, cool-toned hairlines, long soft shadows, restrained radii and spacing.

The easiest thing to get wrong (and most often done wrong) is the two-track color:

• Readable track --bloom-accent — deliberately deepened to pass WCAG; for text / buttons / selected states;
• Mood track --accent-rgb — the real Morandi color (low-saturation, grayed); used only for large ambient gradients and cool hairlines.

All 14 gradient usages in the original use the mood track, never the readable track. When you paint a large area with the readable color, Petal goes from lotus pink to fluorescent magenta and the Morandi feel dies. This plugin ports both tracks intact, and the sibling tool contrast-guard keeps accent/background contrast honest.

Develop / build (TypeScript)

npm install
npm run typecheck    # tsc --noEmit, full type check
npm run build        # typecheck → tsc emits lib/index.js → esbuild emits lib/client.js
npm run deploy       # one-click deploy to local DSH (sync-version → build → rsync)
npm run preview      # deploy to desktop-local (the desktop host is an app, not a browser tab)
npm run dev          # build + watch (recompile+deploy on src change)
npm run package      # one-click package (npm pack → .tgz)
npm run check        # 6 static gates + contrast-guard (runs on every commit)
npm run preflight    # pre-release: version consistency / git state / listing sync

src/ is 10 modules (meta · appearance · palette · tokens · css/ · dom · drag · version · switcher · client); DSH loads the artifacts in lib/.

The build is dual-track — the two halves want opposite module formats:

So the browser-side source can be split freely, but the artifact must bundle back into one self-contained file.

The version number is bumped by release-please inside the release PR, alongside package.json (via the x-release-please-version marker at the end of the line in src/meta.ts). scripts/sync-version.mjs is only a local-dev fallback and is not part of the publish path. See CONTRIBUTING.

FAQ

Theme not applying? Hard-refresh once (Cmd/Ctrl + Shift + R). If the page says Failed to load plugins, the client failed to register — re-run npx @deepseek-ai/dsh plugin --profile <your-profile> add dsh-bloom-theme or upgrade to the latest version.

Can I customize colors? For now you pick a whole palette via variants; per-color customization is on the roadmap.

Contribute / open source

• Add a new palette: add one entry to PALETTE / VARIANTS / VARIANT_LABELS in src/client.ts — glass, motion, selected state and the contrast guardrail all follow automatically.
• Run npm run build && npm run check and make sure contrast-guard passes before opening a PR.
• Issues, PRs and ideas are all welcome.

Support

If Bloom makes your DSH nicer to use, drop a ⭐ or buy me a coffee (sponsor link below and one entry in the panel menu).

DSH plugin suite

Install both with Node.js, then restart DSH (replace your-profile with your profile name):

PROFILE=your-profile
npx -y @deepseek-ai/dsh plugin --profile "$PROFILE" add dsh-bloom-theme @dsh-plugins/dsh-llm-hub && PROFILE="$PROFILE" node -e 'const f=(process.env.DSH_HOME||require("os").homedir()+"/.dsh")+"/profiles/"+process.env.PROFILE+"/package.json",p=require(f),b=p.dsh.profile.bundles;for(const n of Object.keys(p.dependencies))if(/^(dsh-bloom-theme|@dsh-plugins\/)/.test(n)&&!b.includes(n))b.push(n);require("fs").writeFileSync(f,JSON.stringify(p,null,2)+"\n")'

License

MIT — keep the copyright notice on borrow/modify. Palette inspiration from typora-Bloom-theme.