Pomodoro Timer

A browser-based Pomodoro timer as a Progressive Web App. Works offline, no tracking, no dependencies.

Features

• Customizable timer with presets
• Pomodoro mode (25/5 or 50/10 cycles, or custom durations)
• 8 themes with dark/light mode
• 3 timer animations
• Keyboard shortcuts: S (start/stop), P (pause), R (reset), D (dark mode), , (settings), ? (help)
• Touch gestures: tap to start/pause, long press to reset, swipe to change presets
• Web notifications
• Installable as a PWA

Running

python -m http.server 8000

Then open http://localhost:8000

For development, use index.nonProd.html (supports Live Server). Use index.html for production.

Privacy

All data stored in localStorage. No tracking, no network requests except service worker caching.

Architecture

ES6 modules:

• script.js - entry point
• timer-module.js - timer logic with drift compensation
• ui-manager.js - DOM manipulation
• settings-modal.js - settings UI
• pomodoro-manager.js - Pomodoro workflow
• error-recovery.js - error handling
• mobile-enhancements.js - touch gestures
• service-worker.js - PWA caching

See CLAUDE.md and TODO.md for development details.