color-schemes
A color-scheme plugin for the DSH web GUI. It registers a set of themes,
selectable from Settings > General > Color Scheme, and keeps hover popups
(tooltips, hover cards) consistent with the active theme.
Features:
- Seven built-in schemes: Catppuccin (Latte, Frappe, Macchiato, Mocha),
Everforest (Dark, Light), Nord. - The selected scheme persists across refresh and restart (localStorage,
keydsh.color-schemes.state). - Schemes are typed TypeScript data files in
schemes/; a script rebuilds
the client bundle. No UI code is touched when adding a scheme.
Install
The package is a bundle: package.json declares dsh.bundle.patch
(./cordis.patch.yml), so installing it in any profile activates the
plugin row automatically.
The package is not published to an npm registry yet. Two current
sources:
Git:
dsh plugin --profile web add github:hatanokokosa/dsh-colorschemes
Tarball (offline or self-hosted; generated with pnpm pack in the package
directory):
dsh plugin --profile web add ./color-schemes-1.0.0.tgz
Then restart dsh web; the Color Scheme row appears in
Settings > General. The built lib/ is committed in the repository, so
neither form needs a build step or build permission (a git install runs no
prepare script, so no pnpm allowBuilds is required).
Remove with dsh plugin --profile web remove color-schemes.
Local development
Inside a profile (as in this repository) the package is linked as a file
dependency instead:
- Put this package at
web/ext/color-schemes. - Add to
web/package.json:
"color-schemes": "file:./ext/color-schemes"
- Add to
web/cordis.patch.yml:
- insert:
- id: color-schemes
name: 'color-schemes'
- Link the package into
web/node_modules(or run the profile's
package manager), then restartdsh web.
Add a scheme
See schemes/README.md. The short version: create
a new scheme file in schemes/, register it in schemes/index.ts, run
npm run build.
lib/client.js is generated and committed; running it requires no build
tooling. Building it requires Node >= 23.6 (native TypeScript type stripping)
plus the dev dependencies (npm install inside this package): npm run build
type-checks the sources with tsc and bundles src/client.ts + schemes/*.ts
with esbuild into the loader bundle.
Uninstall
For a bundle install: dsh plugin --profile web remove color-schemes.
For a file-dependency install: remove the patch row from the profile's
cordis.patch.yml, the color-schemes entry from web/package.json, and
the web/node_modules/color-schemes link. The localStorage entry is inert
once the plugin is gone.
License
BSD-2-Clause
