Skip to main content

​
Quickstart Guide

Get up and running with Meelio in just a few minutes. This guide will walk you through your first focus session.

​
Choose Your Platform

The fastest way to try Meelio is through the web application:
  1. Visit meelio.io
  2. The app loads instantly - no account required
  3. All data is stored locally in your browser
The web app works on any modern browser (Chrome, Firefox, Safari, Edge)

​
Your First Focus Session

Let’s set up your first Pomodoro focus session:
1

Set your timer

The timer is prominently displayed in the center of the screen.
  • Default: 25-minute focus session
  • Click the settings icon to customize durations
  • Choose between 1-1440 minutes for focus and break times
// Default Pomodoro settings
focusDuration: 25 minutes
shortBreakDuration: 5 minutes
longBreakDuration: 15 minutes
2

Add ambient sound (optional)

Create your perfect focus environment:
  1. Click the Soundscapes icon in the dock
  2. Browse available sounds (rain, coffee shop, forest, etc.)
  3. Click sounds to activate them
  4. Adjust individual volumes or use the global volume slider
You can mix multiple sounds together. Try combining rain + coffee shop for a cozy atmosphere.
3

Create a task

Track what you’re working on:
  1. Click the Tasks icon in the dock
  2. Type your task in the input field
  3. Press Enter to create
  4. Pin a task to show it during your focus session
Tasks are automatically saved to your browser’s IndexedDB.
4

Start your session

Ready to focus?
  1. Click the Start button on the timer
  2. The timer begins counting down
  3. Soundscapes continue playing (if enabled)
  4. A notification appears when the session completes
The timer continues running even if you switch tabs or minimize the browser (web app) or close the tab (extension runs in background).

​
Essential Features

Now that you’ve completed your first session, explore these key features:

Quick Notes

Capture ideas without leaving your focus space. Click the Notes icon in the dock.

Calendar Integration

See your next meeting or event. Add your ICS calendar URL in settings.

Custom Backgrounds

Personalize your workspace with beautiful wallpapers or upload your own.

Site Blocker

Block distracting sites during focus sessions (extension only).

​
Keyboard Shortcuts

Speed up your workflow with keyboard shortcuts:
ShortcutAction
Cmd/Ctrl + 1Open Timer
Cmd/Ctrl + 2Open Tasks
Cmd/Ctrl + 3Open Notes
Cmd/Ctrl + 4Open Soundscapes
Cmd/Ctrl + /View all shortcuts
EscapeClose current panel
See the complete shortcuts reference for all available keyboard commands.

​
Customization

Make Meelio yours:
1

Choose your theme

Click the theme toggle in the dock to switch between light, dark, or system theme.
2

Adjust timer settings

Open Settings (gear icon) > Timer to customize:
  • Focus and break durations
  • Notification sounds
  • Auto-start breaks
  • Default soundscape
3

Customize the dock

Open Settings > Dock to:
  • Show/hide specific features
  • Toggle icon labels
  • Organize your workspace

​
Daily Workflow Example

Here’s a typical productive day with Meelio:
  1. Morning: Open Meelio, check calendar for today’s meetings
  2. Plan: Add tasks for the day, organize by priority
  3. Focus: Start 25-minute Pomodoro with rain soundscape
  4. Track: Pin current task to stay focused on one thing
  5. Break: 5-minute break with breathing exercises
  6. Repeat: Continue focus sessions throughout the day
  7. Review: Check completed tasks and statistics at day’s end

​
Next Steps

Explore Features

Deep dive into timer, tasks, notes, and more

Install Extension

Get the full experience with browser extension features

Customize Settings

Personalize Meelio to match your workflow

Learn Shortcuts

Master keyboard shortcuts for maximum productivity

​
Tips for Success

The classic Pomodoro technique uses 25-minute focus sessions with 5-minute breaks. However, you can adjust this based on your work:
  • Deep work: 45-60 minute sessions
  • Creative work: 25-30 minute sessions
  • Quick tasks: 15-20 minute sessions
Experiment to find what works best for you.
Ambient soundscapes can help:
  • Block out distracting environmental noise
  • Create consistent focus environment
  • Signal your brain it’s time to work
Try different sounds and combinations. Some people focus better in silence - that’s okay too!
Meelio automatically tracks:
  • Daily focus time in the timer statistics
  • Completed tasks (with confetti celebration!)
  • Focus session history in IndexedDB
Check your stats by opening the Timer and scrolling down to see daily totals.
Need help? Check out the complete documentation or visit the GitHub repository to ask questions.

Build docs developers (and LLMs) love

Get started for freeTalk to us