A personal StayFocusd-style web blocker for Chrome/Edge (Manifest V3). No auth, no backend, fully local.
- Open Chrome/Edge →
chrome://extensions(oredge://extensions) - Enable Developer mode (top-right toggle)
- Click Load unpacked
- Select the
A blockerfolder - The FocusLock icon appears in your toolbar — click it to open the popup
| Feature | Description |
|---|---|
| Time Budget Groups | Create groups (Social Media, News, etc.) with daily time limits |
| Blocked Sites | Add domains per group — blocked after budget exhausted |
| Allowed Sites | Always-accessible whitelist that overrides group blocks |
| Nuclear Option | Hard irreversible lock for a set duration |
| Dashboard | Usage chart + progress bars for all groups |
| Notifications | Up to 5 warning thresholds before time runs out |
| Allowlist Mode | Block everything except your allowlist |
- Uses MV3
declarativeNetRequest— fastest native blocking, no webRequest overhead - Redirects blocked sites to
blocked.htmlwith reason + time remaining - Nuclear mode persists across extension reloads (stored in
chrome.storage.local) - Daily reset via
chrome.alarms(configurable time, default midnight) - Idle detection pauses time tracking when browser is idle
A blocker/
├── manifest.json # MV3 manifest
├── background.js # Service worker — all logic
├── popup.html/css/js # Toolbar popup
├── options.html/css/js # Full settings page (6 tabs)
├── blocked.html/css/js # Redirect page
├── rules.json # Static ruleset (empty — dynamic rules used)
└── icons/ # 16/48/128px icons