Reference · The keys
Keyboard shortcuts
If you work with a keyboard attached — a Magic Keyboard on the iPad, or MuirWave on the Mac — these are the keys. The set is the same on both platforms apart from three items that only exist on one of them, and each of those says why. Everything here is also reachable by tapping, so nothing is keyboard-only.
§02
The full set
Grouped by the menu they live in. ⌘ is Command, ⌥ is Option (Alt), ⇧ is Shift.
File
| Keys | Command | iPad | Mac | What it does |
| ⌥⌘E |
Export Report… |
✓ | ✓ |
Opens MuirWave's Export sheet, scrolled to its REPORTS section — the same flow as the Export tile in the rail. Requires MuirWave Pro for every report except Brief Sheet. |
| ⇧⌘E |
Export Data & Figures… |
✓ | ✓ |
Opens the same Export sheet, scrolled to its DATA & FIGURES section (Markdown / CSV / GeoJSON / Figure PNG) instead. If you haven't described your source in the Impact Ranges panel yet it says so rather than exporting ranges you never chose. |
| — |
Export Diagnostics… |
— | ✓ |
Mac only. Builds a diagnostics bundle and reveals it in the Finder — useful if we ask you for one while chasing a problem. There's no iPad equivalent, because on iPad the file would be written and immediately orphaned with nowhere to reveal it. |
View
| Keys | Command | iPad | Mac | What it does |
| ⌘+ |
Zoom In |
✓ | ✓ |
Halves the map's span — exactly what the + on the map's zoom stepper does. ⌘= works too, so you don't have to reach for Shift. |
| ⌘− |
Zoom Out |
✓ | ✓ |
Doubles the span. The camera keeps its centre and heading, so the pin stays where it is. |
| ⌘K |
Show / Hide Keypad |
✓ | — |
iPad only, and deliberately so: the on-screen keypad is a touch affordance that MuirWave never shows on the Mac. With a hardware keyboard attached to an iPad this is how you put it away. |
| ⇧⌘W |
Close All Panels |
✓ | ✓ |
Empties the working page's panel area in one press. On iPad and Mac this closes the dock and every floating panel at once. Shift because plain ⌘W is already spoken for — see §03. |
Data
| Keys | Command | iPad | Mac | What it does |
| ⌘R |
Refresh Live SSP |
✓ | ✓ |
Forces a fresh live sound-speed lookup at your pin. Safe to press any time — offline, on cooldown, or with live data switched off, it simply does nothing. Needs MuirWave Live. |
| ⇧⌘R |
Refresh Live Wind / Wave |
✓ | ✓ |
The same, for the surface-conditions feed. Shift is the "other one of the pair" throughout MuirWave. |
| — |
Refresh Data Pack List |
✓ | ✓ |
Re-scans for installed regional packs. Useful right after a download; no shortcut because it isn't something you do mid-flow. |
Help
| Keys | Command | iPad | Mac | What it does |
| — |
MuirWave User Guide |
✓ | ✓ |
Opens this guide in your browser. |
| — |
Report an Issue… |
✓ | ✓ |
Starts an email to support with the subject pre-filled. |
§03
Keys the system provides
These aren't MuirWave's — the operating system supplies them to every app, which is exactly why MuirWave doesn't redefine them. They're listed so the picture is complete.
| Keys | Does | iPad | Mac |
| ⌘W | Close the window | ✓ | ✓ |
| ⌘M | Minimise the window | ✓ | ✓ |
| ⌘Q | Quit MuirWave | — | ✓ |
| ⌘, | Open Settings (Preferences) | — | ✓ |
| ⌘N | New project window | — | ✓ |
| ⌘O | Open a saved project | — | ✓ |
| ⌘S | Save | — | ✓ |
| ⌘X ⌘C ⌘V | Cut / copy / paste in a text field | ✓ | ✓ |
Why iPad has no ⌘S or ⌘N. On the Mac, MuirWave is a document-based app — each project is a file you open, save and duplicate, and macOS provides that whole File menu for free. On iPad your work lives in the in-app project library instead (Load Project on the landing page, synced through iCloud), which has no file to save, so those commands would have nothing to act on.
§04
Dialogs and panels
When a dialog is up — the report-type picker, the methodology picker, the project-name prompt — the keyboard drives it.
| Keys | Does | Where |
| Return |
Fires the highlighted button — Export…, Save, whichever the dialog leads with. |
Mac. |
| ⌘. |
Cancels the dialog, same as tapping Cancel. |
iPad. |
| esc |
Cancels the dialog, same as tapping Cancel. |
Mac. |
| esc |
Closes the frontmost panel — floating cards first, then the dock. |
Mac and iPad with a hardware keyboard. |
Confirming on iPad. Tap the dialog's brass button. The Return key is a Mac affordance here — on iPad, the keys the dialog answers to are ⌘. to cancel, and a tap to go ahead.
A panel can always be closed without a keyboard — use the ✕ in its header or tap its rail tile again. The legacy floating overlay also closes from a tap on its dimmed backdrop. Nothing in MuirWave is closable only by keyboard.
§05
The slide dock & tear-off
On iPad and Mac, MuirWave docks a panel beside a wide chart or below a portrait-shaped chart, and lets you tear it free into its own floating card when you want more than one panel up at once. The chart stays usable throughout.
| What | How it works |
| Opening and switching panels | With no panel open, tap a rail tile once to expand its summary, then again to open it. Once a panel is open, one tap on a different panel tile swaps the dock straight to that panel; tap the currently docked tile to close it. In a landscape-shaped window the chart slides left and the panel docks beside it, full height. In a portrait-shaped window the panel docks below the chart instead, so the map keeps its full width. The rule follows the window's shape — including Split View, Stage Manager and Mac windows — rather than the device's orientation. Rotate or resize with a panel open and the same panel hands off between the side and bottom without closing. There's no dimmed backdrop and no tap-to-dismiss here; the map stays fully interactive. |
| Resizing the dock | Drag the grip on the panel's left edge when it is beside the chart, or the thin pill right on its top edge when it is below the chart. A brass ghost line tracks your finger while you drag; the panel re-lays once at the width or height you release it. Side width and bottom height are remembered independently. |
| Tearing a panel free | A short centred bar in a docked panel's header is the drag cue — pinned to the header's top edge when the panel sits beside a wide chart, or centred in the header (clear of the resize pill, which owns that top edge instead) when the panel is below a portrait-shaped chart. Drag anywhere across the header — not just a tap, a real drag past a small threshold — and the panel tears loose into its own floating glass card that follows your finger, freeing the dock for another panel. You can have the docked panel plus up to three floating cards up at once (four panel surfaces total); tear off a fifth and the oldest floating card gives way to make room — nothing you're actively looking at ever gets closed out from under you. |
| Moving & resizing a float | Drag a floating card by its header to move it; tap anywhere on it to bring it to the front. A grip in its bottom-right corner resizes it the same way the dock grip does — a ghost outline tracks your drag, and the card re-lays once you let go. |
| Docking a float again | Either drag it to the glowing cyan DOCK HERE strip along the chart's trailing edge in a wide window, along the bottom edge in a portrait-shaped window, press the ⇥ button in its header, or tap that floating panel's rail tile once. The rail-tile route is also a handy recovery control if a card has been left near the edge of the chart. If another panel is already docked, that panel doesn't close: it swaps out to become a floating card itself, so you never lose your place. |
| Telling docked from floating at a glance | Rail tiles use three states: cyan for the panel currently docked, brass for any panel currently floating, and the normal quiet treatment when idle. A floating panel's tile brings it back to the dock; only the tear gesture and an occupied-dock swap create a new float. |
| Closing things | Each panel's own ✕ closes it. esc on a hardware keyboard (Mac or iPad alike) closes panels front-to-back — the frontmost floating card first, then the next, and only once every float is closed does it reach the dock. View → Close All Panels (⇧⌘W) empties the whole workspace — dock and every float — in one press, and works even if you never tear a panel off. |
| Your layout comes back | Whatever you have floating — which panels, where you put them, what size you left them, which one is in front — is remembered and restored the next time you open the app, including after quitting and relaunching. Closing every float is remembered too: a clean workspace stays clean until you tear something off again. The docked panel itself is never restored this way (it always starts closed, same as today). |
| Narrow windows | Portrait by itself is no longer a reason to lose the dock: the panel uses the bottom edge and preserves the map's width. A truly small Split View or Mac window, or the Large interface-scale setting on a smaller iPad, can still leave too little usable map for either dock axis. Only then does the panel fall back to the familiar floating overlay and tear-off becomes unavailable. Widen the window (or choose a smaller interface scale) and the dock and tear-off return. |
Available in MuirWave 1.0 on iPad and Mac. iPhone keeps its compact phone-specific panel presentation.