Skip to content

Repository files navigation

Pace logo

Pace extension

CI License: MIT

A pomodoro timer for building your working pace. A minimalist Chrome extension (Manifest V3).

Most pomodoro timers start the second you press play. Pace starts a step earlier — with a plan. Set your sessions and breaks, and before you begin it shows the clock time you'll finish. You start each run knowing when you'll be done.

Not a website blocker. Pace doesn't police your attention or block sites. It gives you a finish line, a calm backdrop, and a nudge to rest.

Features

  • Plan, then start — see your finishing time. Pace does the math across every short and long break and shows the clock time you'll be done.
  • Ambient sound — rain, forest, or cafe loops with gentle transition chimes. Or work in silence.
  • A gentle full-screen break — dims the page and pauses media when a break begins, then waits for you to move the mouse before the next session.
  • Optional cross-device reminders — no account; get a buzz on your phone when a break begins. Off by default.

Install

  • Chrome Web Store: Add to Chrome
  • From source: run the build, then load dist/ unpacked at chrome://extensionsDeveloper modeLoad unpacked.

Development

npm install
npm run build      # type-check + bundle into dist/
npm test           # unit tests (Vitest)
npm run e2e        # end-to-end smoke (Playwright; rebuilds first)
npm run lint

Built with Vite + TypeScript + vanilla HTML/CSS — no UI or CSS frameworks, no remote code. The build runs Vite twice on purpose: once for the popup/background/offscreen ES modules, once for the content script as a single IIFE (it can't be an ES module). After editing src/content/, run a full npm run build.

Privacy

No account, no analytics, no tracking — your settings and timer stay on your device. The one exception you control: cross-device reminders send a short, generic message (no personal data) to a private ntfy.sh topic. Off by default; turned off, the extension makes no network requests at all. Full details in PRIVACY.md.

License

MIT. Bundled third-party assets (the Inter font, the qrcodegen library, and CC0 ambient recordings) retain their own licenses — see NOTICE.

About

A pomodoro timer for building your working pace — minimalist MV3 Chrome extension.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages