Skip to main content

​
Overview

Meelio provides comprehensive keyboard shortcuts to help you navigate and use features without touching your mouse. All shortcuts use modifier keys (Cmd on Mac, Ctrl on Windows/Linux) combined with number or letter keys.
Press Cmd/Ctrl + / to view the shortcuts modal at any time within Meelio.

​
Viewing Shortcuts

Access the shortcuts reference panel quickly:
1

Open Shortcuts Modal

Press Cmd/Ctrl + / from anywhere in Meelio
2

Browse Categories

The modal shows shortcuts organized by feature category
3

Close Modal

Press Escape or click outside the modal to close
The shortcuts modal remains accessible even when panels are open, so you can reference it while working.

​
Dock Feature Shortcuts

Quickly open and close dock features using number keys with the modifier key.
The modifier key is Cmd on macOS and Ctrl on Windows/Linux. The shortcuts modal automatically displays the correct key for your operating system.

​
Complete Dock Shortcuts

Cmd/Ctrl + 1

Timer (Pomodoro)Open or close the Pomodoro timer panel for focused work sessions.

Cmd/Ctrl + 2

Breathing ExercisesToggle the breathing pod for quick mindfulness breaks.

Cmd/Ctrl + 3

SoundscapesAccess ambient sounds and music for concentration.

Cmd/Ctrl + 4

TasksOpen your task list to view and manage to-dos.

Cmd/Ctrl + 5

NotesQuick access to create and edit notes.

​
Implementation Details

Dock shortcuts are implemented in the use-dock-shortcuts.ts hook:
const SHORTCUT_KEY_TO_TOGGLE: Record<string, DockStoreToggleKey> = {
  "1": "toggleTimer",
  "2": "toggleBreathing",
  "3": "toggleSoundscapes",
  "4": "toggleTasks",
  "5": "toggleNotes",
  "6": "toggleSiteBlocker",
  "7": "toggleTabStash",
  "8": "toggleBookmarks",
  "9": "toggleBackgrounds",
  "0": "toggleCalendar",
};
Smart Context Detection:
  • Shortcuts are disabled when typing in input fields
  • Works with textareas and contenteditable elements
  • Prevents accidental triggers during data entry

​
Notes Shortcuts

When the Notes panel is open, additional shortcuts become available for note management.

Cmd/Ctrl + N

Create New NoteInstantly create a fresh note without using the mouse.

Cmd/Ctrl + P

Pin NotePin or unpin the current note to keep it at the top.

Backspace (⌫)

Delete NoteDelete the currently selected note.
This action may require confirmation depending on your settings.

Shift + F

Zen ModeToggle distraction-free full-screen editing mode.
Zen mode (Shift + F) is perfect for long-form writing, removing all UI distractions except your note content.

​
General Shortcuts

Universal shortcuts that work throughout Meelio.
Opens the keyboard shortcuts reference modal.Usage:
  • Available from any screen
  • Press again to toggle closed
  • Also accessible via Escape key when modal is open
// Toggles shortcuts modal
if ((e.metaKey || e.ctrlKey) && e.key === "/") {
  setIsOpen((v) => !v);
}
Closes the currently open panel or modal.Behavior:
  • Closes settings dialog
  • Closes dock feature panels
  • Dismisses shortcuts modal
  • Exits zen mode in notes
  • Does NOT require modifier key
Escape always returns you to the main view, making it easy to reset your workspace.

​
Productivity Tips

Maximize your efficiency with these shortcut-based workflows:

​
Quick Focus Session

1

Open Timer

Press Cmd/Ctrl + 1 to open the Pomodoro timer
2

Start Soundscapes

Press Cmd/Ctrl + 3 to launch ambient sounds
3

Block Distractions

Press Cmd/Ctrl + 6 to enable site blocker
4

Start Working

Begin your timer and enter flow state

​
Task Management Flow

1

Open Tasks

Cmd/Ctrl + 4 - Access your task list
2

Review & Prioritize

Review upcoming tasks and priorities
3

Quick Notes

Cmd/Ctrl + 5 - Jot down ideas in notes
4

Start Timer

Cmd/Ctrl + 1 - Begin focused work on priority task

​
Deep Work Setup

  1. Cmd/Ctrl + 6 - Block distracting sites
  2. Cmd/Ctrl + 7 - Stash current tabs for later
  3. Cmd/Ctrl + 3 - Start focus music
  4. Cmd/Ctrl + 1 - Launch Pomodoro timer
  5. Begin deep work session
  1. Cmd/Ctrl + 5 - Open notes
  2. Cmd/Ctrl + N - Create new note
  3. Shift + F - Enter zen mode
  4. Cmd/Ctrl + 3 - Optional ambient sounds
  5. Write distraction-free

​
Advanced Shortcut Techniques

​
Chaining Shortcuts

Combine shortcuts in rapid succession to set up your workspace: 
1. Cmd/Ctrl + 9  → Change to morning wallpaper
2. Cmd/Ctrl + 4  → Review daily tasks
3. Cmd/Ctrl + 0  → Check calendar
4. Cmd/Ctrl + 1  → Start first Pomodoro

​
One-Hand Navigation

Most shortcuts are designed for single-hand operation:
Use your left hand for all shortcuts on Mac:
  • Cmd (thumb) + Number keys (fingers)
  • Comfortable for right-handed mouse users
  • Quick access while mouse is in right hand

​
Customization

Custom keyboard shortcut remapping is not currently available in Meelio, but it’s on the roadmap for future releases.

​
Upcoming Features

Planned keyboard shortcut enhancements:
  • Custom shortcut remapping
  • Multiple shortcut profiles
  • Import/export shortcut configurations
  • Vim-style navigation modes
  • Search-based command palette

​
Shortcut Reference Table

Quick reference for all keyboard shortcuts:
ShortcutActionCategory
Cmd/Ctrl + 1Toggle TimerDock
Cmd/Ctrl + 2Toggle BreathingDock
Cmd/Ctrl + 3Toggle SoundscapesDock
Cmd/Ctrl + 4Toggle TasksDock
Cmd/Ctrl + 5Toggle NotesDock
Cmd/Ctrl + 6Toggle Site BlockerDock
Cmd/Ctrl + 7Toggle Tab StashDock
Cmd/Ctrl + 8Toggle BookmarksDock
Cmd/Ctrl + 9Toggle BackgroundsDock
Cmd/Ctrl + 0Toggle CalendarDock
Cmd/Ctrl + NNew NoteNotes
Cmd/Ctrl + PPin NoteNotes
BackspaceDelete NoteNotes
Shift + FZen ModeNotes
Cmd/Ctrl + /Show ShortcutsGeneral
EscapeClose PanelGeneral

​
Accessibility

Keyboard shortcuts make Meelio more accessible:
Complete all primary tasks without a mouse:
  • Full keyboard navigation of all features
  • Tab-based focus management in dialogs
  • Arrow key support in lists and menus
  • Enter/Space activation of buttons
Shortcuts work seamlessly with screen readers:
  • All shortcuts announced properly
  • Focus management maintains screen reader context
  • ARIA labels on all interactive elements
Minimize repetitive mouse movements:
  • Quick access reduces mouse travel
  • Single-hand operation possible
  • Ergonomic key combinations
  • Reduced risk of RSI

​
Learning Shortcuts

​
Progressive Learning Strategy

1

Week 1: Core Features

Master the most essential shortcuts:
  • Cmd/Ctrl + 1 - Timer
  • Cmd/Ctrl + 4 - Tasks
  • Cmd/Ctrl + / - Show shortcuts
  • Escape - Close panels
2

Week 2: Productivity Features

Add focus-enhancing shortcuts:
  • Cmd/Ctrl + 3 - Soundscapes
  • Cmd/Ctrl + 6 - Site blocker
  • Cmd/Ctrl + 5 - Notes
3

Week 3: Advanced Features

Complete your shortcut repertoire:
  • Cmd/Ctrl + 7 - Tab stash
  • Cmd/Ctrl + 2 - Breathing
  • Cmd/Ctrl + 0 - Calendar
  • Notes panel shortcuts
4

Week 4: Mastery

Build muscle memory with daily practice:
  • Use shortcuts exclusively for one week
  • Create personal shortcut workflows
  • Share productivity tips with others
Print or save the shortcuts modal screenshot as a reference until you’ve memorized your most-used shortcuts.

​
Troubleshooting

If keyboard shortcuts aren’t responding:
  1. Ensure you’re not in an input field (text box, textarea)
  2. Check that JavaScript is enabled in your browser
  3. Verify no browser extensions are intercepting key events
  4. Try refreshing the page
  5. Check browser console for errors
If the shortcuts modal shows the wrong key:
  1. The modal detects your OS automatically
  2. If incorrect, try reloading the page
  3. Check your browser’s user agent isn’t modified
Some shortcuts may conflict with browser defaults:
  • Cmd/Ctrl + N might open a new window in some browsers
  • Consider using Meelio as a browser extension for better integration
  • Check browser shortcut settings for conflicts
Most Meelio shortcuts are designed to avoid conflicts with common browser shortcuts, but some variations may occur depending on your browser and operating system.

Build docs developers (and LLMs) love

Get started for freeTalk to us