Skip to main content

​
Installation

Meelio is available as a web application and browser extension. Choose the installation method that works best for you.

​
Web Application

The easiest way to use Meelio is through the web application:

​
Access Hosted Version

1

Visit meelio.io

Simply open meelio.io in any modern browser.No installation, account, or setup required. All data is stored locally in your browser.
2

Add to Home Screen (Optional)

For a native app-like experience, install as a Progressive Web App (PWA):On Desktop:
  • Chrome/Edge: Click the install icon in the address bar
  • Safari: File > Add to Dock
On Mobile:
  • iOS Safari: Tap Share > Add to Home Screen
  • Android Chrome: Tap menu > Install app

​
Self-Host Locally

Run Meelio on your own machine:
1

Prerequisites

Ensure you have the required tools installed:
  • Node.js 22.0.0 or higher
  • pnpm 9.15.4 (recommended package manager)
# Check versions
node --version  # Should be 22.0.0+
pnpm --version  # Should be 9.15.4+
2

Clone the repository

git clone https://github.com/zainzafar90/meelio.git
cd meelio
3

Install dependencies

pnpm install
This installs all dependencies for the monorepo including the web app and shared packages.
4

Start the development server

pnpm dev
The web app will be available at http://localhost:4000
The pnpm dev command runs both the web app and extension in development mode. To run only the web app, use pnpm dev --filter=web

​
Browser Extension

The browser extension replaces your new tab page and adds powerful productivity features.

​
Supported Browsers

Meelio extension supports:
  • Chrome (Recommended)
  • Edge
  • Firefox
  • Opera
  • Brave
  • Safari (Experimental)

​
Install from Store

1

Visit Chrome Web Store

Navigate to the Meelio extension page on the Chrome Web Store.
Store listing coming soon. For now, use the manual installation method below.
2

Click Add to Chrome

Click the Add to Chrome button and confirm the installation.
3

Grant permissions

The extension requires:
  • Required: Storage, Notifications
  • Optional: Tabs, Tab Groups, Bookmarks (for site blocker, tab stash, bookmarks features)
4

Open new tab

Open a new tab to see Meelio. Your new tab page is now replaced with the Meelio interface.

​
Manual Installation (Development)

Install the extension locally for development or testing:
1

Build the extension

From the Meelio repository root:
pnpm build:extension
# or specifically for Chrome
cd apps/extension
pnpm build:chrome
Build output will be in apps/extension/build/
2

Load the unpacked extension

  1. Open chrome://extensions (Chrome) or edge://extensions (Edge)
  2. Enable Developer mode (toggle in top right)
  3. Click Load unpacked
  4. Select apps/extension/build/chrome-mv3-prod directory
  5. The extension is now installed
3

Grant optional permissions

After installation, grant optional permissions for full functionality:
  1. Click the Meelio icon in your browser toolbar (or open a new tab)
  2. Open Settings (gear icon in the dock)
  3. Navigate to Bookmarks tab
  4. Click Grant Permission for bookmarks access
For site blocker and tab stash, permissions are requested when you first use those features.

​
System Requirements

​
Web Application

  • Browser: Any modern browser supporting ES2020+
    • Chrome 90+
    • Firefox 88+
    • Safari 14+
    • Edge 90+
  • Storage: ~10-50 MB for IndexedDB (depends on usage)
  • Internet: Required for initial load, optional after first visit (PWA caching)

​
Browser Extension

  • Browser API: Manifest V3 support required
  • Permissions: Storage (required), Notifications (required), Tabs/Bookmarks (optional)
  • Storage: ~5-10 MB for extension files + data

​
Self-Hosting Requirements

  • Node.js: 22.0.0 or higher (as specified in .node-version)
  • pnpm: 9.15.4+ (specified in package.json)
  • Disk Space: ~500 MB for dependencies (node_modules)
  • Memory: 2 GB RAM recommended for development build
{
  "packageManager": "[email protected]",
  "engines": {
    "node": ">=22.0.0"
  }
}

​
Troubleshooting

Possible causes:
  • Another extension is overriding the new tab page
  • Browser cache needs clearing
Solutions:
  1. Open chrome://extensions and ensure Meelio is enabled
  2. Disable other new tab extensions
  3. Clear browser cache (Ctrl+Shift+Delete)
  4. Reload the extension (click refresh icon on extensions page)
Possible causes:
  • Browser in incognito/private mode
  • Browser storage quota exceeded
  • Third-party cookies/storage blocked
Solutions:
  1. Ensure you’re not in incognito mode (IndexedDB not persistent there)
  2. Check browser storage settings - allow meelio.io to store data
  3. Clear old data: Settings > Data > Clear All Data
  4. Try a different browser to isolate the issue
Possible causes:
  • Wrong Node.js version
  • Network issues downloading dependencies
  • Corrupted package lock file
Solutions:
# Check Node version
node --version  # Must be 22.0.0+

# Use nvm to install correct version
nvm install 22
nvm use 22

# Clean install
rm -rf node_modules pnpm-lock.yaml
pnpm install
For bookmarks, tabs, or tab groups:
  1. Open chrome://extensions
  2. Find Meelio extension
  3. Click Details
  4. Scroll to Permissions
  5. Ensure required permissions are granted
  6. If not, remove and reinstall the extension
Removing the extension will delete all local data. Export your data first from Settings > Data > Export.
If you see esbuild platform errors:
# Install platform-specific esbuild binary
pnpm add -D @esbuild/linux-x64   # Linux
pnpm add -D @esbuild/darwin-arm64 # Mac M1/M2
pnpm add -D @esbuild/win32-x64   # Windows
The correct platform binary should be auto-detected, but manual installation may be needed in some environments.

​
Next Steps

Quickstart Guide

Start your first focus session in minutes

Extension Features

Explore site blocker, tab stash, and bookmarks

Customize Settings

Personalize Meelio to match your workflow

Development Setup

Contribute to Meelio or build your own fork
For development and contribution guidelines, see the Development Setup and Contributing guides.

Build docs developers (and LLMs) love

Get started for freeTalk to us