TomatoTask

Cross-platform Pomodoro timer and task manager Built with Svelte, TypeScript, Tauri, Rust, and SQLite.

Download · Usage · Contributing · Security

Overview

TomatoTask is a local-first desktop productivity app that combines Pomodoro sessions, task management, project organization, statistics, themes, keyboard shortcuts, and native notifications.

This repository is maintained as a quality-focused desktop application project: clear documentation, structured contribution guidelines, security policy, automated checks, and release packaging.

Screenshots

Main timer interface	Task management and projects
Statistics and productivity	Settings and customization

Features

• Custom work, short break, and long break durations
• Visual timer progress and dynamic window title
• Task creation, filtering, completion tracking, and project organization
• Daily and weekly productivity statistics
• Data export for backup and recovery
• Light and dark themes
• Multilingual interface: English, French, Spanish, Italian, and German
• Keyboard shortcuts for common actions
• Native desktop notifications
• Windows and Linux packaging through Tauri

Technology Stack

• Svelte 5 and TypeScript for the user interface
• Tauri and Rust for the desktop shell
• SQLite for local persistence
• Tailwind CSS for styling
• Vite for the build pipeline
• Vitest and Playwright for testing
• ESLint and Prettier for code quality

Quality Signals

This project includes:

• npm run check for Svelte and TypeScript validation
• npm run lint for formatting and lint checks
• npm run test:unit for unit tests
• npm run test:e2e for end-to-end tests
• GitHub Actions workflows for checks, builds, releases, and security
• CHANGELOG.md, CONTRIBUTING.md, SECURITY.md, and CODE_OF_CONDUCT.md

Installation

Download the latest release:

TomatoTask releases

Windows

Download and run the x64 installer from the latest release.

Linux

Download the AppImage, make it executable, and run it:

chmod +x TomatoTask_*_amd64.AppImage
./TomatoTask_*_amd64.AppImage

Development

Install dependencies:

npm install

Run the development server:

npm run dev

Run quality checks:

npm run check
npm run lint
npm run test:unit

Run the Tauri app:

npm run tauri dev

Usage

1. Launch TomatoTask.
2. Configure timer durations and preferences.
3. Create a task or project.
4. Start a focus session.
5. Track completed sessions and productivity statistics.

License

This project is licensed under the MIT License. See LICENSE for details.