Feature/keyboard shortcuts

[Daksh7785]

✨ feat: Interactive Keyboard Shortcuts for Rapid Admin Dashboard Navigation

Closes #640

---

🎯 Overview

This PR implements global keyboard shortcuts for the HELPDESK.AI dashboard, enabling support team leads, admins, and users to navigate rapidly between major modules without touching the mouse — inspired by Gmail-style hotkey sequences.

---

🛠️ What's Changed

1. Frontend/src/hooks/useKeyboardShortcuts.js (New File)

• Custom React hook that registers a global keydown listener on window
• Implements Gmail-style sequential key detection (G → key within 1 second)
• Role-aware routing — redirects to the correct path based on the logged-in user's role (admin, super_admin, master_admin, or standard user)
• Typing protection — shortcuts are automatically suppressed when the user is focused inside any <input>, <textarea>, or contentEditable element to prevent accidental navigation
• Cleans up event listeners on component unmount

2. Frontend/src/App.jsx (Modified)

• Imports and calls useKeyboardShortcuts() inside AppLayout
• Hook is active globally across all authenticated routes (user, admin, master admin portals)

3. Frontend/src/user/pages/Help.jsx (Modified)

• Adds a "Keyboard Shortcuts" sidebar card with a trigger button
• Adds a premium modal overlay listing all available shortcuts with styled <kbd> keycap indicators
• Modal is dismissible via the × button or the "Got it" button

---

⌨️ Available Shortcuts

Shortcut	Action	Role Routing
G → D	Go to Dashboard	Admin → /admin/dashboard · User → /dashboard
G → T	Go to Tickets	Admin → /admin/tickets · User → /my-tickets
G → H	Go to Help	All roles → /help
Ctrl + F / ⌘ F	Focus Search Input	Focuses & selects the nearest search field

---

✅ Testing

• Build passes with zero errors (vite build — 3660 modules transformed)
• G + D navigates correctly for admin and user roles
• G + T navigates correctly for admin and user roles
• G + H navigates to /help for all roles
• Ctrl + F focuses the visible search input without triggering browser native search
• Shortcuts are not triggered while typing inside form inputs or textareas
• Shortcuts modal renders and dismisses correctly on the Help page

[vercel]

@Daksh7785 is attempting to deploy a commit to the ritesh Team on Vercel.

A member of the Team first needs to authorize it.

[coderabbitai]

Important

Review skipped

Auto reviews are disabled on base/target branches other than the default branch.

Please check the settings in the CodeRabbit UI or the .coderabbit.yaml file in this repository. To trigger a single review, invoke the @coderabbitai review command.

⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro

Run ID: 83c8befa-77b0-4146-acb0-9216d40d2cb8

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.

Use the checkbox below for a quick retry:

• 🔍 Trigger review

✨ Finishing Touches

🧪 Generate unit tests (beta)

• Create PR with unit tests

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands and usage tips.}