FocusGuard — Site Blocker & Focus Timer

FocusGuard turns Chrome into a focus tool. Native MV3 blocking, schedule-based automation, Pomodoro timer, strict mode, whitelist mode, custom block page, optional AI motivation — all running locally on your device. 🛡 NATIVE BLOCKING (MV3 declarativeNetRequest) Chrome enforces the block rules natively. FocusGuard never observes which URLs you visit — there's nothing to leak and no list of visited sites stored anywhere. Faster and safer than legacy webRequest-based blockers. 🗂 CATEGORY-BASED BLOCKING Six pre-built categories cover the most common sources of distraction: • Social media • News sites • Video streaming • Online gaming • Online shopping • Custom (add your own domains) Each category is toggled independently. Every category comes pre-populated with a common starter list; you can add or remove domains for any category from the options page. Nothing is hardcoded — every entry is yours to edit. 📅 SCHEDULE-BASED BLOCKING Define a daily time window (for example, weekdays 9 AM to 5 PM). Blocking enables automatically when the window opens and disables when it closes. A background tick evaluates the schedule every minute, so the state is always correct without you touching anything. 🍅 POMODORO MODE Start a deep-work session from the popup. During the work phase your chosen categories are blocked; during breaks they unlock automatically. Default 25 / 5 / 15 minute cycle, fully configurable. Completed sessions are tracked in the stats view. 🔒 STRICT MODE (NO PANIC BUTTON) For the moments you know you'll try to talk yourself out of it. Lock the current blocking configuration for a chosen duration. While strict mode is active, disabling categories, flipping the master switch, or restarting Chrome will not unlock it. The lock only ends when its timer expires. ✅ WHITELIST MODE (ULTRA FOCUS) The inverse of category blocking: block everything except the domains you explicitly add to the allow list. Useful when even one wrong click breaks your flow. 🛡 CUSTOM BLOCK PAGE The page shown when a site is blocked is fully editable: • Your own motivation text • Your current daily goal, printed on every block • Today's stats: blocks counted, estimated time saved, current streak • Best-ever streak counter • Eight accent color choices • Optional AI-generated motivation (BYOK — see below) ✨ AI MOTIVATION (BRING YOUR OWN KEY) Optional feature. If you supply an API key for a supported provider (Anthropic Claude, OpenAI, or Groq), each block page can include a short personalized motivation referencing your current goal and the site you tried to open. The request goes directly from your browser to your chosen provider; FocusGuard runs no servers and has no API endpoint. 🔥 STREAK TRACKING Every day you successfully block at least one distraction counts toward a streak. Miss a day and the streak resets, but the best streak is preserved forever. Streak is shown on the block page, in the popup, and in the stats dashboard. 📊 30-DAY STATS DASHBOARD A bar chart of daily blocks, total estimated time saved, and your top ten most-blocked domains across the last 30 days. All data lives in IndexedDB on your device — nothing leaves the browser. ⌨ KEYBOARD SHORTCUTS • Alt+Shift+F — toggle blocking on or off • A separate shortcut for starting a Pomodoro session (configurable in chrome://extensions/shortcuts) 🌍 LOCALIZED INTERFACE The UI auto-detects your browser language and ships translations for: English, Türkçe, Español, Deutsch, Français, Português, Italiano, 日本語. 🔒 PRIVACY-FIRST DESIGN • No analytics, telemetry, ad networks, or remote logging • No outbound network code targeting any infrastructure operated by us • Chrome itself enforces blocking — the extension never sees individual requests • Permissions are kept tight: no bookmarks, no history, no cookies, no content scripts, no <all_urls> read access • Settings sync through your own Chrome account via chrome.storage.sync • Block events and statistics live in IndexedDB on your device only ═══════════════════════════════ WHY ANOTHER SITE BLOCKER? FocusGuard uses Chrome's modern Manifest V3 declarativeNetRequest API. That means Chrome itself enforces the rules without the extension watching your traffic — faster, more reliable, and structurally privacy-preserving. The extension's job is just to manage the rule set and the UI around it. ═══════════════════════════════ CHANGELOG 1.0.0 — Initial release: category blocking, scheduling, Pomodoro, strict mode, whitelist mode, custom block page, streak tracking, optional AI motivation, 30-day statistics, eight UI languages. ═══════════════════════════════ CREDITS • React + React DOM (MIT) — UI framework • Dexie (Apache 2.0) — IndexedDB wrapper • Anthropic, OpenAI, and Groq — optional, user-supplied AI endpoints If you find a bug, please open an issue on the project's repository.