About this project
Pomodoroz is an open-source desktop focus timer released under the MIT license and described as a fork of Pomatez (by Roldan Montilla Jr.), started on 2026-03-25. The README positions it not as a fix for flexible timing — the original already supports configurable session lengths — but as an attempt to address workflow friction: starting tasks, choosing what to do next, keeping track of time, and making breaks restorative.
Runtime and stack
According to the README's comparison table, the fork moves to a Tauri-only runtime with a dedicated src-tauri directory and no Electron runtime path, uses React 19, pnpm, and Tauri 2.11.x with explicit capabilities and pinned plugins. The development section lists Node.js v24, pnpm v11 and Rust 1.98.1 (pinned in rust-toolchain.toml), with a renderer shell under app/renderer. The frontend stack includes Vite 8, TypeScript 6, React Router 7, Redux Toolkit 2, @dnd-kit for drag-and-drop, Styled Components and i18next.
Timer
Modes cover focus, short break, long break and configurable special breaks, with start, pause, skip and reset controls and configurable session rounds. A focus extension option prompts for one short or long extension near the end of a focus block, with configurable durations and an optional native tray reminder when the app is hidden. Strict mode prevents pausing, skipping or resetting once a session has started. Focus can auto-start after a break, breaks set to zero minutes are skipped automatically, and the progress animation can be disabled. Suggested presets mentioned in the README are Just Start (5/1), Sprint (10/3), Classic (25/5) and Flow (50/10).
Tasks
Users can create lists and tasks with descriptions, reorder them by drag-and-drop, mark tasks done, skip or delete them, and flag priorities from either the list or grid view. Undo and redo are available via Ctrl+Z and Ctrl+Shift+Z. Task lists and cards can be imported and exported as JSON, with validation, ID regeneration, and merge or replace modes.
Study Rotation Grid
The app can switch between list and grid views. Cards carry a daily status colour that moves from white to green to red, and a Draw button performs random phase-based selection to suggest what to work on next. Pending priorities are surfaced first and Draw can be limited to prioritized tasks. Column count (Auto, 1, 2, 3 or 4) is a persistent preference, a grouped mode adds list separators with a Group/Ungroup toggle, and colour reset supports confirmation plus automatic daily reset. Right-clicking a card selects it as the active task and navigates to the timer.
Statistics
Report periods cover today, week (7 days), month (30 days) and all time. A period report shows focus time, break time, idle time, completed cycles, top focus areas and daily flow, with a stacked focus/break/idle chart. Long-term progress covers streak, level and XP, today's target, explicit milestones, a 30-day heatmap and last-7-day focus bars. A per-task-list breakdown gives accumulated time and completed cycles, and stored data can be cleared by week, month or all with confirmation. Idle time is tracked by period, with an optional setting to reclassify a mid-focus reset as idle.
Notifications, appearance and system integration
Notification levels are None, Normal (on every break) and Extra (60 seconds before a break, 30 seconds before it ends, and at break start). A default bell or a custom audio file can be used, and voice assistance provides audio cues about session status. Appearance options include a dark theme with follow-system-theme, a toggle between custom and OS-native titlebars, always-on-top, minimize or close to tray with a tray progress indicator, and open-at-login on macOS and Windows. Fullscreen breaks fill the screen during breaks and are described as stable across compact, minimized and hidden window states. Keyboard shortcuts include Alt+Shift+H (hide), Alt+Shift+S (show), Alt+Shift+T (toggle theme) and the task undo/redo pair. Seven interface languages are listed — Portuguese (BR), English, Spanish, Japanese, Chinese, German and French — with automatic system language detection.
Compact mode
A minimal interface is provided for small screens, including an expandable grid, an actions menu for done/skip/delete on the displayed task, and a post-break prompt to continue or open the grid.
Installation and development
Published release assets target Windows and Linux, with macOS builds currently source-based via pnpm tauri build; the in-app update channel is described as focused on Windows (NSIS) and Linux (AppImage). Local install and uninstall scripts are provided for shell and PowerShell. Documented commands include pnpm dev:app, lint, typecheck:renderer, test:run, build:renderer, tauri build variants, and cargo check.
Privacy and licensing
The README states that Pomodoroz collects no data and stores tasks, settings and statistics locally on the machine. It is licensed MIT © Carlos Duarte, with the original Pomatez work also MIT licensed. A note clarifies that it is a productivity tool and not medical advice. The README also links a changelog, an improvements roadmap, and migration documentation, and lists "coming soon" items such as cadence presets and rotating break suggestions.
Comments
0 Rating appears after 10 ratings
Sign in to join the discussion.