---
epic: 7
story: 7.5
title: "Global Hotkey (QuickCalc)"
status: draft
---

## Epic 7 — macOS App (Swift/SwiftUI)
**Goal:** A beautiful, native macOS app that feels like it belongs on the platform.

### Story 7.5: Global Hotkey (QuickCalc)

As a **macOS user**,
I want a configurable global hotkey that opens a floating QuickCalc panel,
So that I can type a quick calculation, copy the result, and dismiss without leaving my current workflow.

**Acceptance Criteria:**

**Given** the default configuration
**When** the user presses Option+Space from any application
**Then** a floating QuickCalc panel appears centered on screen

**Given** the QuickCalc panel is open
**When** the user types a calculation (e.g., `1920 / 3`)
**Then** the result is displayed immediately in the panel

**Given** the QuickCalc panel shows a result
**When** the user presses Cmd+C
**Then** the result value is copied to the system clipboard

**Given** the result has been copied
**When** the user presses Escape
**Then** the QuickCalc panel dismisses

**Given** the user wants to customize the hotkey
**When** the user opens CalcPad preferences and changes the QuickCalc shortcut
**Then** the new shortcut is immediately active and the old one is deregistered

**Given** another app has registered the same hotkey
**When** CalcPad attempts to register it
**Then** CalcPad notifies the user of the conflict and allows selecting an alternative

**Given** the QuickCalc panel is open
**When** the user presses Cmd+V to paste into the frontmost app
**Then** the panel dismisses first, then the paste occurs in the previously frontmost app (or the user can manually switch)
