DSH PWA Plugin
PWA plugin for DeepSeek Harness that adds offline support and install-as-app capability.
Features
- Service Worker with smart caching strategy
- PWA Manifest with proper maskable icons
- Automatic updates — silently activates new versions
- Offline-first for static assets
- Official DSH whale icon — derived from the upstream SVG favicon
Installation
1. Add as a dependency
In your DSH web profile's package.json:
{
"dependencies": {
"dsh-pwa-plugin": "file:~/workspace/dsh-pwa-plugin"
}
}
2. Register the plugin
In your profile's cordis.patch.yml:
- insert:
- id: dsh-pwa
name: 'dsh-pwa-plugin'
3. Restart DSH
dsh web
Generate PNG Icons
The plugin ships pre-built PNG icons. To regenerate (requires sharp):
cd dsh-pwa-plugin
node scripts/generate-icons.js
This reads the official public/favicon.svg and produces:
| File | Size | Purpose |
|---|
icon-192.png | 192×192 | Regular (any) |
icon-192-maskable.png | 192×192 | Maskable (20% safe zone) |
icon-512.png | 512×512 | Regular (any) |
icon-512-maskable.png | 512×512 | Maskable (20% safe zone) |
How It Works
- The host plugin serves
/sw.js, /manifest.webmanifest, and icon files
- It injects a service worker registration script into the HTML
- The service worker caches static assets (including icons) for offline use
- The manifest enables installing the app as a PWA
- Updates are detected automatically and silently activated
- DSH's built-in
/favicon.svg is used as-is (not overridden)
Caching Strategy
| Resource Type | Strategy | Description |
|---|
| HTML | Network-first | Always tries to fetch the latest version |
| JS/CSS/Fonts/Images | Cache-first | Serves from cache if available |
| API calls | Not cached | Always goes to the network |
Limitations
- Requires HTTPS to work (except localhost)
- Service worker cannot cache API calls
- Updates require a page reload (automatic after detection)
Project Structure
dsh-pwa-plugin/
├── src/
│ ├── host/
│ │ └── index.js # Host plugin (Node.js)
│ └── sw.js # Service Worker
├── public/
│ ├── manifest.webmanifest # PWA Manifest
│ ├── favicon.svg # DSH whale icon (same as upstream)
│ └── icons/ # PWA icons (maskable + regular)
├── scripts/
│ ├── generate-icons.js # Icon generator (sharp)
│ ├── install.js # Verification script
│ └── verify.js # Verification
├── cordis.patch.yml # Plugin registration
├── LICENSE
└── package.json
License
MIT
