Plugin Markets & Managers

dsh-theme-switch

kinmat-A/dsh-theme-switch · ★ 1

kinmat-ACurated

One-click skin switching for DSH Web settings: auto-detects installed themes, keeps exactly one active at a time, and falls back to the official look when all are off. Changes apply instantly and survive restarts.

License
BSD-3-Clause
Added
2026-08-16
Maintenance
active
Install kind
github
Manifest details
Manifest status
Declared
Manifest path
package.json#dsh
Manifest checked
2026-08-19
Lifecycle scripts
None found

Static manifest checks report declarations only; they are not compatibility or security review.

安装

dsh plugin --profile web add github:kinmat-A/dsh-theme-switch

GitHub 源码安装:首次需按提示配置 allowBuilds 构建授权后重试

For install and environment setup, plus plugin development tutorials, see DSH community docs ↗

README

Source README · body: en · Read Chinese README

Table of contents
  1. Install
  2. Usage
  3. Screenshots
  4. Features
  5. Development
  6. Structure

DSH theme switch: auto-detects installed skin/theme plugins and offers one-click, official-style switching under Settings → Plugins → Skins.

中文说明

Install

dsh plugin --profile web add github:kinmat-A/dsh-theme-switch

Restart dsh web afterwards (or install it from the dsh-market plugin, which hot-activates it), then open Settings → Plugins → Skins.

Usage

Switch skins from Settings → Plugins → Skins; after switching, refresh the browser page (Ctrl+F5) for the new skin to appear.

Screenshots

The skins tab (Settings → Plugins → Skins), dark theme:

dsh-theme-switch skins tab

Note: the themes shown in the screenshot are for display only.

Features

  • Auto-detection: scans the profile's dependencies and bundles, recognizing skins by package name / skin.json / bundle-patch rows. Missed skins can be added via config.themes.
  • Mutually exclusive switching: clicking a skin's button enables it and disables all the others; clicking it again disables it.
  • Official fallback: when every skin is off, the official DSH look applies automatically (the panel's "Official DSH skin" row has a matching button).
  • Instant and restart-proof: switches are written to the home-layer patch ~/.dsh/cordis.patch.yml, which the dsh boot flow watches live and replays on every startup — no restart needed.

Development

pnpm install          # first time (needs network)
pnpm run build:client # build the client (tsdown)

Structure

  • lib/index.js — host entry (plain ESM, zero dependencies): skin detection, home-patch read/write, HTTP API.
  • src/client/index.tsx → lib/client.js — official-style settings tab (--dsw-alias-* tokens + primitives).
  • API: GET /@dsh-external/dsh-theme-switch/api/themes, POST …/api/toggle {id} (id: "__official__" disables every skin).

License: BSD-3-Clause