A premium, zero-distraction productivity companion that helps you reclaim your time, build deep focus habits, and block digital noise.
Formerly known as FocusFlow.
Flow is a high-end web assistant designed for people who want to work smarter, not longer. It blends a state-of-the-art Pomodoro Focus Timer with Visual Site Analytics, a Smart Distraction Blocker, and a 365-Day Consistency Heatmap to create the ultimate distraction-free environment.
Whether you are studying, coding, writing, or designing, Flow keeps you in "the zone" while gently helping you build healthier screen-time habits.
🔒 Privacy first — All your data is stored locally on your device. Zero tracking, zero data collection.
| Feature | Description |
|---|---|
| ⏱️ Premium Pomodoro Timer | Fully customizable work sessions, short breaks, and long breaks with a glowing ring that fills as your session progresses. |
| 📊 Visual Time Tracking | Circular donut chart displays your top-visited websites and shows exactly where your minutes went. |
| 🚫 Smart Site Blocker | Network-level blocking with time limits, daily schedules, cool-down timers, and a custom redirect. |
| 🔒 6-Digit PIN Lock | Granular locks for Timer Stop, Rule Editing, Free-time Hours, Focus Presets, Schedules, and Danger Zone. |
| 🎯 Weekly Goals & Streaks | Set focus targets, track your progress, and earn a glowing streak badge for consecutive days. |
| 🗺️ 365-Day Heatmap | GitHub-style consistency heatmap with customizable thresholds. Green = focused. Red = wasted. |
| 📈 Study vs Distraction Trends | Color-coded trend charts with per-category toggles (Productivity, Learning, Communication, Distraction). |
| 🏷️ Site Categorization | Tag every website as Productivity, Learning, Communication, Distraction, or Uncategorized. |
| ⏰ Focus Schedules | Set recurring daily/weekly focus sessions that auto-start. |
| 🌗 Dark, Light & Cinematic Themes | Three premium themes including a glassmorphic cinematic mode with animated gradient blurs. |
| 🆕 Custom New Tab (Beta) | Replace your browser's default new tab with Flow's clock and stats. |
| Store | Status |
|---|---|
| Microsoft Edge Add-ons | ✅ Approved |
| Firefox Add-ons | ✅ Approved |
| Opera Add-ons | ⏳ Pending Moderation |
| Chrome Web Store | 🔜 Coming Soon |
- Download or clone this repository to your computer.
- Open your browser and go to the Extensions page (
chrome://extensionsoredge://extensions). - Turn on Developer mode (toggle in the top right corner).
- Click Load unpacked and select the
flow-sourcefolder. - Pin Flow to your browser toolbar for quick access!
This repository contains the original, un-minified source code for Flow.
To generate the minified code submitted to browser add-on stores:
- Ensure Python 3 is installed on your system.
- Open a terminal and navigate into the
flow-sourcedirectory. - Run:
python build.py
- The script will create a
flow-firefoxdirectory (and aflow-distdirectory for Chromium) containing the final, minified extension code.
- The
build.pyscript does not use complex bundlers like Webpack, Rollup, or Vite. - It uses basic Regular Expressions to cleanly strip whitespace, newlines, and comments.
- The code is not obfuscated.
- Flow monitors the active tab to calculate time spent on each website.
- When a site is blocked, it uses the
declarativeNetRequestAPI for network-level blocking — the site never even loads. - The blocked page shows a cinematic, motivational screen with the specific reason for the block.
- All settings and stats are saved locally using
chrome.storage, meaning your browsing data never leaves your device.
See CHANGELOG.md for a full list of changes across all versions.
There are several ways to contribute to Flow:
Describe your problem or idea in GitHub Issues.
We plan to add multi-language support in the future. If you want to help translate Flow into your native language, please start a thread in the Discussions tab!
Leave a review on Firefox or Edge. It's simple and incredibly helpful!
This project is licensed under the MIT License.
Made with 💖 by vishwa-vsr — Student and indie developer from India.