Overview#
An analyst switching between a surveillance feed, a live case, and an entity graph during an active operation does not have time to navigate menus. Every second spent reaching for the mouse is a second not spent on analysis. The platform's keyboard shortcut system is designed for exactly this kind of high-tempo work: a unified architecture that registers shortcuts across the shell, application, and page levels, resolves conflicts predictably, and surfaces every available shortcut via a built-in help modal so operators can learn as they work.
The system replaces per-application shortcut handling with a coordinated architecture that prevents double-handling, supports dynamic registration and cleanup, and provides discoverability through a built-in reference modal. All UI components meet WCAG 2.2 AAA standards, including full keyboard navigation support throughout.
Key Features#
-
Priority-Based Resolution: Four priority tiers determine which handler wins when multiple registrations match the same key combination. Shell sits at priority 100, application at 200, page at 300, and override at 400. Higher priority registrations take precedence, enabling modal-level shortcuts to override everything below them.
-
Combination and Sequence Shortcuts: Support for standard key combinations such as Ctrl+K and Ctrl+Shift+P alongside key sequences where pressing one key followed by another triggers an action. G then D navigates to the dashboard, G then M to the map. Sequence detection resets automatically after a configurable timeout.
-
Scope System: Shortcuts are registered with one of three scopes: shell for platform-wide navigation, app for application-level actions within a specific module, and page for context-specific actions on the current view. Scope determines placement in the help modal and interaction with other registrations.
-
Editable Target Detection: The system automatically suppresses shortcut handling when the user is typing in form fields, text areas, content-editable elements, or other input contexts. This prevents shortcuts from firing during data entry without requiring per-registration configuration.
-
Help Modal: A built-in keyboard shortcut reference modal activated with Shift+? displays all registered shortcuts grouped by category, with human-readable key labels and descriptions. The modal deduplicates entries and filters by scope.
-
Command Palette Integration: The shortcut system integrates with the command palette, providing keyboard access via Ctrl+K and Ctrl+Shift+P at the shell level, and generating palette entries from registered shortcuts for searchable access.
-
Dynamic Registration and Cleanup: Shortcuts register and unregister as components mount and unmount, preventing stale handlers from persisting after navigation. Each registration returns a cleanup function called automatically on component teardown.
Use Cases#
- Platform Navigation: Move between major sections using key sequences without touching the mouse: G+D for dashboard, G+M for map, G+I for investigations, G+A for admin, G+G for graph.
- Application-Specific Actions: Each module registers its own shortcuts for common actions at the appropriate priority level, ensuring they work within that module without conflicting with shell-level navigation.
- War Room and Collaboration: Override-priority shortcuts in the collaboration war room provide instant access to call controls: mute, camera, screen share, recording, hand raise, leave call.
- Surveillance Navigation: Sequence shortcuts in the surveillance module enable rapid camera switching, view toggling, and alert acknowledgment through keyboard-only workflows.
- Discoverability: New users press Shift+? to see all available shortcuts for their current context, reducing the learning curve for keyboard-driven efficiency.
Integration#
The keyboard shortcuts system is provided by the application shell and available to all platform modules. Individual applications register shortcuts through React hooks that manage lifecycle cleanup automatically. The system connects to the command palette for searchable shortcut access and to global navigation for platform-wide key sequences.
Open Standards#
- W3C WCAG 2.2 (Web Content Accessibility Guidelines): The entire shortcut system is built to Level AAA compliance, implementing specific success criteria including 2.1.1 Keyboard, 2.1.2 No Keyboard Trap, 2.1.4 Character Key Shortcuts, 2.4.1 Bypass Blocks, 2.4.7 Focus Visible, 2.4.11, 2.4.13 Focus Not Obscured and Focus Appearance, 2.5.5/2.5.8 Target Size, 4.1.3 Status Messages, and 3.2.6 Consistent Help.
- WAI-ARIA 1.2 (W3C Accessible Rich Internet Applications): All interactive UI elements in the shortcut help modal use ARIA semantics:
role="dialog",aria-modal,aria-labelledby,aria-describedby,aria-live="polite",aria-atomic, androle="status"live regions for screen-reader announcements of search results and action confirmations. - W3C UI Events Specification (KeyboardEvent interface): Shortcut detection is built entirely on the standard
KeyboardEventproperties (key,code,ctrlKey,shiftKey,altKey,metaKey) defined in the W3C UI Events specification, enabling consistent cross-browser behaviour for all registered key combinations and sequences. - BCP 47 (IETF language tags, RFC 5646): Shortcut descriptions, category names, ARIA labels, and key display strings are fully localised using BCP 47 locale identifiers (en, es, fr, de, nl) served through the next-intl internationalisation layer, including platform-aware modifier labels per locale.
- Unicode: Modifier key symbols (⌘ for Command, ⇧ for Shift, ⌥ for Option) are rendered as Unicode characters in the help modal when a macOS platform is detected, following standard computing symbol conventions for cross-platform key label display.
Last Reviewed: 2026-04-02 Last Updated: 2026-04-14