Files
calctext/_bmad-output/implementation-artifacts/7-5-global-hotkey-quickcalc.md
2026-03-16 19:54:53 -04:00

1.6 KiB

epic, story, title, status
epic story title status
7 7.5 Global Hotkey (QuickCalc) 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)