SupremeTechnopriest/react-idle-timer

Health v2 · maintenance only

Adoption not part of the score

1205 stars · 144 forks observed · 2026-08-28

What it is AI-extracted, prompt v1, taxonomy v1, 2026-08-30, confidence not recorded

React Idle Timer is a React hook and component for detecting user activity and idle states in web applications. It provides configurable idle timeouts, debounced or throttled activity callbacks, a built-in 'are you still there' confirm prompt, cross-tab synchronization via BroadcastChannel, and WebWorker-offloaded timers to avoid background tab throttling.

Use cases

• log out inactive users in a react app
• detect when a user goes idle and becomes active again
• show an 'are you still there' prompt with a countdown before session timeout
• sync idle state across multiple browser tabs
• track and react to user activity events like mouse and keyboard input
• keep timers accurate when the tab is in the background

When to choose

• you are building a React app and need reliable idle/active presence detection
• you need cross-tab or multi-window synchronization with leader election
• you want a built-in confirm prompt flow before firing the idle event
• you need a battle-tested solution with high download volume, full test coverage, and TypeScript support

When to avoid

• your project is not React-based (e.g., Vue, Angular, vanilla JS) since the API is React-specific
• you only need a simple one-tab timeout that a plain setTimeout with event listeners can cover
• you need idle detection on a server or in non-browser environments

Facets

library · maturity stable

ui-components state-management frontend web-development browser react react-hook idle-detection activity-detection timer cross-tab web-worker user-presence session-timeout typescript confirm-prompt broadcast-channel

Member repositories

For agents

markdown · JSON · MCP: product_card(name="SupremeTechnopriest/react-idle-timer")