FocusFlow

About

FocusFlow is a clean Pomodoro timer that blocks distracting sites while you focus. Start a session, watch the badge countdown, and stay on track with simple local stats. No accounts, no cloud, no tracking.

Key features

Custom focus length (default 25 min)
Site blocking during focus via dynamic rules
Whitelist mode (allow only listed sites)
Auto short/long breaks (configurable, optional)
Live badge countdown on the toolbar
Local stats: sessions completed, focused minutes
Options page for block/allow list and defaults
Keyboard shortcuts: Alt+Shift+S (Start), Alt+Shift+X (Stop)
Action menu items: Start Focus (default), Stop
Works offline; optional Incognito support
How it works

Uses chrome.alarms for precise timing and ticks.
Applies chrome.declarativeNetRequest rules only while a focus session is running; removes them on stop/end.
Blocks main_frame/sub_frame navigations for listed domains. Default list includes youtube.com, reddit.com, instagram.com, x.com, twitter.com.
Stores settings and stats with chrome.storage.sync (local to your browser profile; syncs only across your own Chrome profiles if enabled).
Get started

Click the toolbar icon. 2) Set minutes. 3) Start. 4) Add or edit sites in Options & Stats. Use Incognito or hard‑reload to avoid cached pages bypassing blocks.
Permissions

Alarms: drive the timer and badge updates.
Storage: save your block/allow list, defaults, and local stats.
Declarative Net Request + Site Access: block the listed sites while focusing; rules are inactive when idle or on breaks.
Notifications (optional): show a “Session completed” toast if granted.
Privacy
FocusFlow does not collect, transmit, or sell personal data. Your block/allow list, defaults, and stats are stored locally via chrome.storage.sync. No analytics and no remote servers. Privacy policy: https://github.com/ShanthanReddy571/FocusFlow/blob/main/PRIVACY.md

Support
Questions or feedback? Open Options & Stats from the popup, or contact: [email protected]