ngrithms-idle

Monorepo for @ngrithms/idle — a signal-first user-inactivity detector for Angular 17+. Standalone, SSR-safe, zero dependencies. Includes multi-tab sync via BroadcastChannel, a sleep watchdog, and an optional @ngrithms/idle/keepalive companion that keeps server-side session expiry in lockstep with the client.

The full API + recipes documentation lives in projects/idle/README.md — that's what npm shows on the package page.

Repository layout

projects/
  idle/             →  publishable library  (@ngrithms/idle)
  idle/keepalive/   →  secondary entry point  (@ngrithms/idle/keepalive)
  demo/             →  showcase app

Development

npm install
npm run build:lib       # build the library into dist/idle
npm run start:demo      # serve the demo on http://localhost:4200
npm test                # run the library test suite

Releasing

Versions are kept in lockstep between the root package.json and projects/idle/package.json:

npm run release:patch   # 0.0.0 → 0.0.1
npm run release:minor   # 0.0.0 → 0.1.0
npm run release:major   # 0.0.0 → 1.0.0

After bumping, commit, tag (v0.x.y), and push — CI publishes to npm with provenance.

License

MIT © Aboud Badra