Pomodoro Timer - Focus Toolbar

About

# Pomodoro Timer - Chrome Extension

Simple, privacy-focused Pomodoro timer for Chrome with 25/5 work/break cycles.

## Features

- ⏱️ 25-minute work sessions / 5-minute breaks
- 🔔 Chrome notifications when sessions complete
- 📊 Daily stats tracking (sessions completed, total focus time)
- ⚙️ Customizable durations and preferences
- 🔒 All data stored locally (no tracking, no analytics)
- 🎨 Clean, minimal interface

## Installation

### Development

1. Clone or download this repository
2. Open Chrome and go to `chrome://extensions/`
3. Enable "Developer mode" (toggle in top right)
4. Click "Load unpacked"
5. Select this directory

### Chrome Web Store (coming soon)

## Usage

1. Click the Pomodoro icon in your toolbar
2. Click "Start" to begin a 25-minute work session
3. The badge shows remaining minutes
4. When complete, you'll get a notification
5. Break time starts automatically (if enabled)
6. Track your daily stats in Settings

## Permissions

- **storage**: Save settings, stats, and timer state locally
- **alarms**: Timer ticks (required for Manifest V3)
- **notifications**: Session completion alerts

## Privacy

This extension:
- ✅ Stores all data locally on your device
- ✅ No analytics or tracking
- ✅ No network requests (except Chrome updates)
- ✅ No personal data collection

## Development

Built with:
- Vanilla JavaScript (no frameworks)
- Chrome Extension Manifest V3
- chrome.alarms API for timer
- chrome.storage.local for data persistence