react-proctor

A configurable, extensible proctoring and integrity enforcement library for React applications. Provides route-level control over restrictions like copy prevention, tab-switch detection, devtools blocking, and more — with a plugin architecture that makes adding new restrictions trivial.

Full Documentation

Installation

npm install @rishikesh7258/react-proctor

Quick Start

import { AntiCheatProvider } from '@rishikesh7258/react-proctor';

const config = {
  restrictions: {
    disableCopy: { enabled: true },
    disableRightClick: { enabled: true },
    detectTabSwitch: { enabled: true, maxViolations: 3 },
    detectDevTools: { enabled: true },
  },
  onViolation: (violation) => {
    console.warn(`Violation: ${violation.type}`, violation);
  },
};

function App() {
  return (
    <AntiCheatProvider config={config}>
      <YourApp />
    </AntiCheatProvider>
  );
}

Using Presets

import { AntiCheatProvider, presets } from '@rishikesh7258/react-proctor';

function ExamApp() {
  return (
    <AntiCheatProvider config={{ restrictions: presets.exam }}>
      <ExamContent />
    </AntiCheatProvider>
  );
}

Available presets: exam, quiz, contentProtection, minimal

Features

• 12 built-in restrictions — copy, paste, cut, text selection, right-click, tab switch, devtools, fullscreen, keyboard shortcuts, drag-drop, print screen, idle detection
• Route-level control — different restrictions per page via config or zone components
• Plugin API — register custom restrictions with the same interface as built-ins
• TypeScript-first — full type definitions and autocompletion
• React hooks — useAntiCheat for control, useViolationLog for monitoring
• SSR-safe — works with Next.js / Remix
• Auto-lockout — lock users out after N violations

Peer Dependencies

• react >= 16.8.0
• react-dom >= 16.8.0

Documentation

For the full API reference, restriction options, presets, custom plugins, and advanced usage, visit the documentation site.

License

MIT