Pomodoro Focus Timer Desktop App using Electron

Students and developers know the pattern: sit down to study, and an hour later the phone has won. The Pomodoro Technique counters this with a simple contract — 25 minutes of single-task focus, then a 5-minute break, with a longer break every fourth session. A browser tab timer is too easy to lose among distractions; a desktop app with system notifications, an always-on-top mini timer and a fullscreen focus mode stays present without being noisy. This project builds exactly that with Electron: a polished cross-platform timer with task tracking and honest statistics, all stored locally. The scope is deliberate — it is a focus timer, not a website blocker or a cloud service — and the listing says so.

1. The user adds tasks with estimated pomodoro counts and starts a focus session from the main timer view.
2. A timer state machine runs focus → short break → focus … → long break every fourth session, with lengths from settings.
3. At each transition the app fires a native OS notification and plays the configured sound; the completed session is logged.
4. The mini timer can be pinned always-on-top; fullscreen focus mode hides everything except the current task and countdown.
5. Statistics aggregate the local session log into daily/weekly charts of sessions, focus minutes and completion rate.
6. electron-builder packages the same codebase into installers for Windows, macOS and Linux.

Tech stack:

• Electron (desktop shell: main + renderer processes)
• JavaScript, HTML5, CSS3
• Node.js runtime APIs
• SQLite (local session log and tasks)
• electron-builder (cross-platform installers)

• [Customizable Pomodoro cycles] 25/5 defaults with adjustable focus, short-break and long-break lengths, and the long break every 4 sessions — all configurable.
• [Task manager] Tasks with estimated pomodoro counts, check-off, reordering and per-task completed-session tallies.
• [Focus statistics] Daily and weekly dashboards: sessions completed, focus minutes, and completion rate, rendered as clean charts.
• [System notifications and sounds] Break reminders through native OS notifications, with optional ticking and end-of-session chimes.
• [Distraction-free modes] Always-on-top mini timer for the screen corner and a fullscreen focus mode that shows only the task and the time.
• [Automatic session log] Every session is logged with timestamps; history is browsable and exports to CSV.
• [Cross-platform installers] electron-builder produces installers for Windows, macOS and Linux from the same codebase.

• Complete source code (Electron main/renderer, timer engine, task manager, statistics)
• Installer builds for Windows, macOS and Linux
• Setup guide (Node.js, dependencies, building installers, running in dev mode)
• Project report PDF (background, Pomodoro technique, architecture, testing notes)
• PPT presentation for final review
• Viva Q&A preparation document (Electron architecture, IPC, state machines, local storage, packaging)
• Demo guidance with a scripted walkthrough

• All data stays on the machine — there is no cloud sync, so sessions do not follow the user across devices.
• It is a focus timer, not a website/app blocker; blocking distracting sites is listed as future scope, not included.
• Notification appearance and sound behavior vary by operating system.
• Timer accuracy depends on OS sleep behavior — a machine that sleeps pauses the countdown like any desktop timer.
• Auto-update is not included; new versions are installed manually.