FlowState — Digital Wellness Time Tracker

Privacy-first browser extension that tracks time spent on websites and nudges you toward mindful browsing. Manifest V3, zero telemetry, all data local.

Live page: https://FlowState-Digital-Wellness-Time-Tracker-Browser-Extension.oriz.in

Features

• Floating timer — shows time spent on the current site, live.
• Mindful nudges — gentle prompts after configurable thresholds.
• Pomodoro — built-in focus/break cycles with settings.
• Analytics — per-site time breakdown.
• Accessibility page — high-contrast / a11y controls.
• Sync — optional cross-device sync via chrome.storage.sync.
• Privacy-first — zero telemetry; all data stays in local/sync storage.

Tech

Vanilla JavaScript + HTML/CSS. Chrome Manifest V3 (service worker, content scripts, chrome.storage, alarms, notifications). No build step for the extension itself. Icon generation uses sharp.

Install (load unpacked)

1. Clone:

   git clone https://github.com/chirag127/FlowState-Digital-Wellness-Time-Tracker-Browser-Extension.git

2. Open chrome://extensions (or edge://extensions).
3. Enable Developer mode.
4. Click Load unpacked and select the extension/ folder.

Icon generation

npm install
npm run generate-icons   # svg-to-png.js -> assets/icon{16,48,128}.png

Project layout

extension/
├── manifest.json
├── background/       service worker (tracking, nudges, alarms)
├── content/          floating timer UI injected per page
├── popup/            toolbar popup
├── options/          settings page
├── pomodoro/         pomodoro timer + settings
├── analytics/        per-site time breakdown
├── accessibility/    a11y controls
├── feedback/         feedback form
├── sync/             cross-device sync
├── utils/            constants, timer, storage helpers
└── _locales/en       i18n messages

License

MIT — see LICENSE.