single-session-browser-tab-lock

React hook to allow only one active browser tab/window at a time using localStorage locking and heartbeat.

Features

• Prevents multiple active sessions across tabs/windows
• Recovers automatically from crashes or force-closed tabs
• Works with React and Next.js (JS & TypeScript)
• SSR-safe (guards against window usage)
• Zero dependencies

Install

npm install single-session-browser-tab-lock

Usage

import { useSingleSession } from "single-session-browser-tab-lock";

function App() {
  const { isBlocked } = useSingleSession();

  if (isBlocked) {
    return <h2>App already open in another tab</h2>;
  }

  return <Dashboard />;
}