Contributing

August 14, 2026 · View on GitHub

Thanks for improving dsh-usage-chart.

Development workflow

  1. Use Node.js 20 or newer and install dependencies with npm ci.
  2. Keep Host-only code in src/index.ts and browser code in src/client/.
  3. Add or update tests for behavior changes.
  4. Run npm run verify and npm pack --dry-run before opening a pull request.
  5. Update CHANGELOG.md for user-visible changes.

Pull requests should be focused and should not include generated lib/, local profiles, API keys, logs, or screenshots containing account information.

For UI changes, run the visual probe scripts against a running DSH Web before opening a PR: node scripts/verify-render.mjs (plus shot.mjs, probe-panel.mjs, probe-popover.mjs). They resolve Chrome, target URL, session, and screenshot output through DSH_PROBE_* environment variables — see the README's development section for the table.

Compatibility

This plugin follows DSH 0.1.x Host/Client bundle conventions. Changes to injected services, slots, module-loader externals, or cordis.patch.yml must include an installation smoke test against a clean Web profile.