Contributing

September 19, 2026 · View on GitHub

Thanks for checking out jevcache.

Dev setup

git clone https://github.com/kushals256/jevcache
cd jevcache
npm install
npm test
npm run build
npm start

Keyless smoke:

MOCK_JEV=1 MOCK_UPSTREAM=1 npm start -- --demo

Guidelines

  • Keep the default path one-command (npx @kushalicious/jevcache@latest).
  • Prefer fail-open: if Jev fails, still call upstream.
  • Don’t commit .env, keys, or local data/.
  • Add or update tests for fingerprint / store behavior when you touch those paths.

Issues

Use the bug template for failures. Include: install method (npx / Docker / source), Node version, and whether /healthz works.