{"id":48533587,"url":"https://github.com/cjdduarte/pomodoroz","last_synced_at":"2026-04-27T16:00:42.819Z","repository":{"id":349873995,"uuid":"1203905503","full_name":"cjdduarte/pomodoroz","owner":"cjdduarte","description":"Foco flexΓ­vel. Pausa inteligente. Progresso real","archived":false,"fork":false,"pushed_at":"2026-04-27T13:16:31.000Z","size":7053,"stargazers_count":4,"open_issues_count":1,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-04-27T13:17:25.636Z","etag":null,"topics":["foco","focus","gestao-de-tempo","kanban","pomodoro","productivity","produtividade","statistics","tdah","temporizador","workflow"],"latest_commit_sha":null,"homepage":"","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/cjdduarte.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":"AGENTS.md","dco":null,"cla":null}},"created_at":"2026-04-07T13:54:23.000Z","updated_at":"2026-04-27T13:16:35.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/cjdduarte/pomodoroz","commit_stats":null,"previous_names":["cjdduarte/pomodoroz"],"tags_count":31,"template":false,"template_full_name":null,"purl":"pkg:github/cjdduarte/pomodoroz","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cjdduarte%2Fpomodoroz","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cjdduarte%2Fpomodoroz/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cjdduarte%2Fpomodoroz/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cjdduarte%2Fpomodoroz/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/cjdduarte","download_url":"https://codeload.github.com/cjdduarte/pomodoroz/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cjdduarte%2Fpomodoroz/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32343571,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-26T23:26:28.701Z","status":"online","status_checked_at":"2026-04-27T02:00:06.769Z","response_time":128,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["foco","focus","gestao-de-tempo","kanban","pomodoro","productivity","produtividade","statistics","tdah","temporizador","workflow"],"created_at":"2026-04-08T01:00:38.284Z","updated_at":"2026-04-27T16:00:42.787Z","avatar_url":"https://github.com/cjdduarte.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003ch1 align=\"center\"\u003ePomodoroz\u003c/h1\u003e\n\n\u003ch3 align=\"center\"\u003eFlexible focus. Smarter breaks. Real progress.\u003c/h3\u003e\n\n\u003cp align=\"center\"\u003e\u003cem\u003eAdaptive Focus Timer β€” 25/5 is a starting point, not a rule.\u003c/em\u003e\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n \u003ca href=\"README.pt-BR.md\"\u003ePortuguese version\u003c/a\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n \u003ca href=\"https://github.com/cjdduarte/pomodoroz/releases/latest\"\u003e\u003cimg alt=\"release\" src=\"https://img.shields.io/github/v/release/cjdduarte/pomodoroz?label=release\u0026color=blue\"\u003e\u003c/a\u003e\n \u003ca href=\"https://github.com/cjdduarte/pomodoroz/releases\"\u003e\u003cimg alt=\"downloads\" src=\"https://img.shields.io/github/downloads/cjdduarte/pomodoroz/total?label=downloads\u0026color=green\"\u003e\u003c/a\u003e\n \u003ca href=\"LICENSE\"\u003e\u003cimg alt=\"license\" src=\"https://img.shields.io/github/license/cjdduarte/pomodoroz?label=license\u0026color=yellow\"\u003e\u003c/a\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n \u003cimg src=\"assets/timerA.png\" alt=\"Pomodoroz - Light Theme\" width=\"49%\"\u003e\u003cimg src=\"assets/timerB.png\" alt=\"Pomodoroz - Dark Theme\" width=\"49%\"\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n \u003cimg src=\"assets/miniA.png\" alt=\"Pomodoroz - Mini Preview A\" width=\"49%\"\u003e\u003cimg src=\"assets/miniB.png\" alt=\"Pomodoroz - Mini Preview B\" width=\"49%\"\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n \u003cimg src=\"assets/gridA.png\" alt=\"Pomodoroz - Grid Preview A\" width=\"49%\"\u003e\u003cimg src=\"assets/gridB.png\" alt=\"Pomodoroz - Grid Preview B\" width=\"49%\"\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n \u003cbr\u003e\n \u003ca href=\"#-about\"\u003eAbout\u003c/a\u003e\n .\n \u003ca href=\"#-features\"\u003eFeatures\u003c/a\u003e\n .\n \u003ca href=\"#-installation\"\u003eInstallation\u003c/a\u003e\n .\n \u003ca href=\"#-development\"\u003eDevelopment\u003c/a\u003e\n .\n \u003ca href=\"#-contributing\"\u003eContributing\u003c/a\u003e\n .\n \u003ca href=\"#-privacy\"\u003ePrivacy\u003c/a\u003e\n .\n \u003ca href=\"#-license\"\u003eLicense\u003c/a\u003e\n \u003cbr\u003e\n \u003cbr\u003e\n\u003c/p\u003e\n\n## πŸ”— About\n\n**Pomodoroz** is a fork of [Pomatez](https://github.com/zidoro/pomatez) by [Roldan Montilla Jr](https://github.com/roldanjr), started on 2026-03-25. Thanks to the original author for the solid foundation.\n\n### Why does this fork exist?\n\n**Pomatez already supports flexible session timing** (it is not locked to 25/5). \nPomodoroz is not about \"fixing flexibility\"; it focuses on adding workflow features for common friction points: starting tasks, choosing what to do next, staying aware of time, and making breaks actually restorative.\n\n### Pomatez vs Pomodoroz (quick comparison)\n\n| Area | Pomatez (original) | Pomodoroz (this fork) |\n| ---------------------------- | ----------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------- |\n| Runtime architecture | Mixed workspace (`app/electron` + `app/tauri`) with legacy Electron scripts still present | Tauri-only runtime with dedicated `src-tauri/` and no Electron runtime path |\n| Frontend base | React 16 | React 19 |\n| Package manager | Yarn (historical) | pnpm |\n| Tauri baseline | Tauri 2 (alpha) | Tauri `2.10.x` with explicit capabilities and pinned plugins |\n| Statistics | No | Yes (period filters, breakdowns, and history cleanup) |\n| Grid view | No | Yes (**Study Rotation Grid** with daily color cycle, Draw button, and right-click to Timer) |\n| Grid footer (current status) | No | Yes (total, visited, and remaining counters) |\n| Task-list import/export | No | Yes (**JSON import/export for task lists/cards** with validation and merge/replace modes) |\n| Focus extension | No | Yes (optional short/long focus extension with configurable durations and tray reminder) |\n| 0-minute breaks | No | Yes (auto-skip breaks when short/long break duration is set to zero) |\n| Idle counting | No | Yes (idle time by period + optional focus-to-idle reclassification on reset) |\n| Supported languages | 4 | 7 |\n\n\u003e Comparison date: 2026-04-27.\n\n### Quick Start (suggested presets)\n\n- **Just Start** β€” 5 min focus / 1 min break\n- **Sprint** β€” 10 min focus / 3 min break\n- **Classic** β€” 25 min focus / 5 min break\n- **Flow** β€” 50 min focus / 10 min break\n\n### What this fork adds on top of Pomatez\n\n**Task initiation paralysis**\n\n- **Study Rotation Grid** with daily card status.\n- **Draw button** to pick the next task when you get stuck on \"where do I start?\".\n\n**Time awareness**\n\n- **Progressive notifications** (60s and 30s before transitions).\n- **Voice assistance** with audio session-status cues.\n- **Focus extension** near the end of a focus block, with one short/long extension choice per session.\n\n**Break quality**\n\n- **Fullscreen breaks** to reduce distraction and encourage real rest.\n- **0-minute breaks** (auto-skip) when you want to keep momentum.\n\n**Structure on hard days**\n\n- **Strict mode** (no pause/skip/reset once started).\n- **Back may count as Idle** for honest mid-focus reset tracking.\n\n**Progress visibility**\n\n- **Statistics module** (daily chart, per-task time, focus/break/idle by period).\n- **Per-task-list breakdown** with accumulated time and completed cycles.\n\n**Quality of life**\n\n- **JSON import/export for task lists and tasks** (validation + merge/replace).\n- **Enhanced compact mode** with expandable grid and actions menu.\n- **Custom notification sounds**.\n- **Right-click task selection** integrated with Timer flow.\n\n\u003e **Note:** Pomodoroz is a productivity tool, not medical advice. If you have an ADHD diagnosis or suspect you might, seek professional support.\n\n### Evidence and history\n\n- Implemented deliveries: [CHANGELOG.md](CHANGELOG.md)\n- Pending improvements roadmap: [docs/IMPROVEMENTS.md](docs/IMPROVEMENTS.md)\n- Migration closure reference: [docs/MIGRATION_TO_TAURI.md](docs/MIGRATION_TO_TAURI.md)\n\n## ✨ Features\n\n### Timer\n\n- Modes: **Focus**, **Short break**, **Long break**, and **Special breaks** (configurable times).\n- Controls: start, pause, skip, reset.\n- Configurable session rounds.\n- **Focus extension** β€” optional `+short` / `+long` prompt near the end of focus, with configurable extension durations.\n- **Strict mode** β€” prevents pausing/skipping/resetting once started.\n- **Auto-start** focus after break ends.\n- **0-minute breaks** β€” auto-skip breaks.\n- **Progress animation** (can be disabled).\n\n### Tasks\n\n- Create lists and tasks with descriptions.\n- Drag-and-drop reordering (lists and cards).\n- Mark as done, skip, or delete.\n- **Undo/Redo** (Ctrl+Z / Ctrl+Shift+Z).\n- **Import/Export** in JSON with validation, ID regeneration, and merge or replace options.\n\n### Study Rotation Grid\n\n- Toggle between **list** and **grid** view.\n- Daily card status: white β†’ green β†’ red.\n- **Draw button** β€” random phase-based selection (whiteβ†’green, then greenβ†’red).\n- **Columns**: Auto / 1 / 2 / 3 (persistent preference).\n- **Grouped mode** β€” list separators with Group/Ungroup toggle.\n- **Color reset** with confirmation and automatic daily reset.\n- Right-click selects the active task and navigates to Timer.\n\n### Statistics\n\n- **Periods**: Today, Week (7d), Month (30d), All.\n- Summary cards: focus time, break time, idle time, and completed cycles.\n- **Daily flow chart** (stacked focus/break/idle).\n- **Per-task-list breakdown** with time and cycles.\n- Data clearing with confirmation (week, month, or all).\n\n### Compact Mode\n\n- Minimal UI for small screens.\n- **Expandable grid** within compact mode.\n- Actions menu (done/skip/delete) on task display.\n- Post-break prompt to continue or open the grid.\n\n### Notifications\n\n- **None** β€” no notifications.\n- **Normal** β€” notifies on every break.\n- **Extra** β€” notifies 60s before break, 30s before break ends, and on break start.\n- **Focus extension reminder** β€” when the app is hidden or in the tray, the extension window can trigger one native reminder.\n- **Custom sound** β€” default bell or custom audio file.\n- **Voice assistance** β€” audio cue about session status.\n\n### Appearance \u0026 System\n\n- **Dark theme** with follow-system-theme option.\n- **Native titlebar** β€” toggle between custom and OS-native.\n- **Always on top** β€” keeps the window above others.\n- **Minimize/Close to tray** with progress indicator on tray icon.\n- **Open at login** (macOS/Windows).\n\n### Keyboard Shortcuts\n\n- `Alt+Shift+H` β€” Hide app.\n- `Alt+Shift+S` β€” Show app.\n- `Alt+Shift+T` β€” Toggle theme.\n- `Ctrl+Z` / `Ctrl+Shift+Z` β€” Undo/Redo in Tasks.\n\n### Languages\n\n- Portuguese (BR), English, Spanish, Japanese, Chinese, German, and French.\n- Automatic system language detection.\n\n### Fullscreen Breaks\n\n- Fills the entire screen during breaks to encourage rest.\n- Stable across compact/minimized/hidden window states.\n\n## 🚧 Coming Soon\n\nImprovements informed by real feedback from users who deal with focus difficulties and ADHD. See details at [docs/IMPROVEMENTS.md](docs/IMPROVEMENTS.md).\n\n- **Cadence presets** β€” Just Start (5/1), Sprint (10/3), Classic (25/5), Flow (50/10).\n- **Break suggestions** β€” rotating tips (drink water, stretch, breathe) to avoid doomscrolling.\n\n## πŸ’» Installation\n\nPublished release assets currently target Windows and Linux.\nmacOS builds are currently source-based (`pnpm tauri build`).\n\nDownload the latest version from the [Releases page](https://github.com/cjdduarte/pomodoroz/releases/latest).\n\n\u003e **In-app update note:** the automatic in-app channel is currently focused on Windows (NSIS) and Linux (AppImage).\n\n### Local Install Scripts\n\n```sh\n./scripts/install.sh\n./scripts/install.ps1\n./scripts/uninstall.sh\n./scripts/uninstall.ps1\n```\n\n### Build From Source\n\n```sh\npnpm install\npnpm build:renderer\npnpm tauri build --no-bundle\npnpm tauri build --bundles appimage,deb,rpm\npnpm tauri build --bundles nsis\n```\n\n## πŸ› οΈ Development\n\n### Requirements\n\n- Node.js v24\n- pnpm v10\n\n### Commands\n\n```sh\npnpm dev:app # Tauri + Vite renderer\npnpm lint # Lint (renderer)\npnpm typecheck:renderer\npnpm tauri build --no-bundle\n```\n\n### Stack\n\n- Tauri 2\n- React 19 + Vite 8 + TypeScript 6\n- React Router 7 + Redux Toolkit 2\n- @dnd-kit (drag-and-drop)\n- Styled Components\n- i18next\n- Root-driven pnpm scripts with renderer shell under `app/renderer` and native backend under `src-tauri`\n\n## 🀝 Contributing\n\nSee [CONTRIBUTING.md](CONTRIBUTING.md) for details.\n\n## πŸ”’ Privacy\n\nPomodoroz **does not collect any data**. All information (tasks, settings, statistics) is stored locally on your machine.\n\n## πŸ“„ License\n\nMIT Β© [Carlos Duarte](https://github.com/cjdduarte)\n\nOriginal work: MIT Β© [Roldan Montilla Jr](https://github.com/roldanjr) β€” [Pomatez](https://github.com/zidoro/pomatez)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcjdduarte%2Fpomodoroz","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcjdduarte%2Fpomodoroz","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcjdduarte%2Fpomodoroz/lists"}