A beautiful, minimalist floating macOS widget for Pomodoro productivity. This app stays on top of your windows, allowing you to track your focus sessions without losing screen real estate.
- Floating Widget: Always stays on top of other applications, even in full-screen mode.
- Draggable & Resizable: Move it anywhere on your screen and drag the edges to scale the UI perfectly using responsive design.
- 4 Customizable Slots: Switch between four different timer presets.
- Edit Names & Times: Click on the title to rename a slot, or click on the timer to change its duration.
- Session Persistence: Your presets, custom names, active slot, and remaining time are saved automatically in local storage.
- Audio Alerts & Mute: Plays a double-beep notification when a timer completes, with a togglable mute option in the top-left corner.
- Enhanced UI: Features a clean design with large interactive play/pause and close buttons, optimized for readability and ease of use.
- Framework: Electron
- Frontend: React with TypeScript
- Build Tool: Vite
- Styling: Vanilla CSS with responsive
vminunits to support window resizing.
To run the application in development mode:
# Install dependencies (Node 20+ recommended)
npm install
# Run in development
npm run devTo package the application into a macOS .dmg file:
npm run buildThe output will be located in the dist/ directory.
- Download the latest
pomodoro-timer-x.x.x-arm64.dmgfrom the releases or build it yourself. - Open the DMG and drag the Pomodoro Timer to your Applications folder.
- Launch the app. (Note: Since this is self-signed, you may need to right-click and select "Open" for the first launch).
This project is open-source under the MIT License. Feel free to download and customize it!
- Themes: Change colors and layout in
src/App.css. - Icon: Replace
build/icon.pngandsrc/assets/pomodoro-icon.pngwith your own design.
MIT