FocusGuard — Site Blocker & Focus Timer

About

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.