Dashboard
Operate Posnic with Keyboard Shortcuts
The header keyboard icon shows the shortcut map; current code adds dedicated till keys that work while the item search field is focused.
- Menu path
- Dashboard header -> keyboard icon; New Sale -> function keys
- Verified from
- Posnic demo and current POS source reviewed on 2026-09-08
Technical source evidence
frontend/modals/shortcuts.html visible shortcut reference, frontend/static/script/js/custom-shortcutkey.js ACL-safe route bindings and New Sale function keys, frontend/layouts/header.html keyboard icon, demo.posnic.io shortcut modal and New Sale behavior verified on 2026-09-04
Open the Shortcut Reference
- Select the keyboard icon in the top header.
- Find the workflow group: Sales, Receivings, Customers, Items, Suppliers, Expenses or Others.
- Close the modal with X or Close before using a shortcut.
- Use the current working-key tables below where the modal conflicts with a browser-reserved combination.
Run a Sale Without Leaving the Keyboard
- The Hold, Clear and Save controls are labelled with their function key in the button tooltip.
- Function keys are handled while an input is focused because the item search field is normally active at a till.
- F4, F8 and F9 do nothing without the required sales write permission.
- F9 does nothing while a visible dialog is open, preventing one key press from completing two stages.
| New Sale key | Action | Safety behavior |
|---|---|---|
| F2 | Focuses and selects Find item name, SKU or barcode. | Works even when another form field has focus. |
| F4 | Selects Hold sale. | Requires sales write and keeps the normal hold validation. |
| F8 | Selects Clear sale. | Requires sales write and keeps the normal confirmation. |
| F9 | Starts Complete sale/payment submission. | Ignored while a modal is open to prevent a second submission behind the payment dialog. |
| Ctrl+Enter | Submits the active New Sale through the same sale handler. | Use only after reviewing cart, customer, totals and payment state. |
Focus and Troubleshooting
- Single-letter route shortcuts are ignored while typing in normal inputs; click outside the field before using one.
- Ctrl+K is the exception and opens the command palette even from an input.
- A route shortcut never bypasses access control. Check the user's role when it does nothing.
- Laptop function keys may require the Fn key depending on keyboard firmware; test the till hardware before training staff.
- If a browser consumes a key, use the listed single-letter alternative or visible Posnic navigation.