@gang-of-beads/pi-web-themes
More themes for PI WEB: Pro, PI WEB and Clay light/dark pairs, plus Classic, Night, Paper and High Contrast.
Package details
Install @gang-of-beads/pi-web-themes from npm and Pi will load the resources declared by the package manifest.
$ pi install npm:@gang-of-beads/pi-web-themes- Package
@gang-of-beads/pi-web-themes- Version
0.1.1- Published
- Oct 16, 2026
- Downloads
- 364/mo · 36/wk
- Author
- hanxiaodu
- License
- MIT
- Types
- theme
- Size
- 27.7 KB
- Dependencies
- 0 dependencies · 0 peers
Security note
Pi packages can execute code and influence agent behavior. Review the source before installing third-party packages.
README
pi-web-themes
A theme pack for PI WEB. It adds more looks to Settings → Appearance, each built from PI WEB's theme tokens through the plugin contract:
| Pair (follows the system light/dark setting) | Light | Dark |
|---|---|---|
| PI WEB | PI WEB Light | PI WEB Dark |
| Clay | Clay Paper | Clay |
| Material | Material Light | Material Dark |
| Pro | Pro Light | Pro |
Single themes: PI WEB Classic, Night, Paper, High Contrast.
Pro is the flat mono look PI WEB used to ship as its built-in appearance. On PI WEB releases whose built-in appearance is Material, the pack's Material entries give way to the built-in ones, so Material is listed once.
Every theme sets the same tokens as PI WEB's own themes, so text, borders, status colours and the label colour on accent fills keep their contrast. contrast.test.ts checks it.
Install
pi install npm:@gang-of-beads/pi-web-themesTo follow main instead of releases, install git:github.com/Gang-of-Beads/pi-web-themes. It needs PI WEB 2.202609.0 or later; earlier releases bundle their own copy of this plugin.
Then reload the PI WEB page and pick a theme in Settings → Appearance. The plugin is browser-only: no session daemon restart is needed. To turn it off, use Settings → PI WEB plugins (plugin id themes).
For local development, link the folder into PI WEB's local plugin directory instead:
ln -s "$PWD" ~/.pi-web/plugins/themesDevelop
npm install
npm run checknpm run check type-checks, runs the theme shape and contrast tests, and bundles pi-web-plugin.ts (with Lit inlined) into pi-web-plugin.js, which the package ships. The bundle is committed so that a git install works without a build step, and the check fails when it is out of date.
Releasing
Update version in package.json and package-lock.json, give CHANGELOG.md a section for it, commit, and push a matching v<version> tag. The release workflow checks the package, publishes it to npm, and creates the GitHub Release from that CHANGELOG section.
License
MIT.