ZenFocus Browser Extension

August 13, 2026 · View on GitHub

A distraction-free Pomodoro timer with a built-in task manager — MV3, no backend, your tasks and settings synced via the browser.

Pomodoro timer + task manager browser extension. MV3, Chrome/Edge/Firefox. No backend — everything runs locally and syncs through chrome.storage.

Links: Repo · Landing page · Latest release

⭐ If this is useful, please star the repo — it helps others find it.

Architecture

flowchart LR
    popup["Popup UI<br/>(timer + tasks)"] <-->|messages| bg["Background service worker<br/>(chrome.alarms)"]
    bg --> notif["Desktop notification<br/>on session end"]
    options["Options page"] --> store[("chrome.storage.sync<br/>tasks + settings")]
    popup <--> store
    bg <--> store

Install

From release (recommended):

Download zenfocus.zip from Latest Release
Extract the zip
Open chrome://extensions/ and enable Developer Mode
Click "Load unpacked" and select the extracted extension/ folder

From source:

git clone https://github.com/chirag127/zenfocus-bs-ext.git
# Load the extension/ folder as an unpacked extension

Features

Pomodoro timer with configurable duration (default 25 min)
Desktop notification when session ends
Task list with add/edit/delete (synced via chrome.storage.sync)
Options page to customize timer
No backend — all data stored locally

Tech stack

Manifest V3 browser extension (Chrome / Edge / Firefox)
Vanilla JavaScript, HTML, CSS — no build step, no framework
chrome.alarms for timing; chrome.storage.sync for persistence
chrome.notifications for session-end alerts

Project Structure

extension/          <- Load this folder as unpacked extension
  manifest.json
  background.js     <- Service worker (timer logic, alarms)
  icons/icon.png
  popup/            <- Main UI (timer + tasks)
  options/          <- Settings page
docs/               <- GH Pages landing

Configuration

No environment variables and no secrets — the extension has no backend. User settings and tasks live in chrome.storage.sync.

Part of the oriz family

One of ~80 oriz projects — small, sharp, open-source tools.

Contributing

PRs welcome. Conventional commits are the changelog.

Status

Stable.