Plan tasks. Protect focus time. See your progress.
Website · Privacy · Report a bug · Contribute
Pomodoist is an open-source productivity app for macOS, iOS and iPadOS, Android, Linux, Windows, and the web.
- Plan your work — organize tasks across inbox, today, upcoming, projects, timeline, kanban, priority matrix, and search
- Protect focus time — run Pomodoro sessions with deep-focus tracking and configurable breaks
- Review your progress — understand weekly productivity and focus-time trends through built-in reports
Pomodoro Focus · Kanban Boards · Priority Matrix — click to expand
Mobile screenshots
Projects · Focus · Reports
Priority Matrix · Kanban
Pomodoist is the complete app client, not a stripped-down demo. To run the web app locally:
git clone https://github.com/Kabanya/Pomodoist.git
cd Pomodoist
make setup-flutter
# Fill the newly created .env.setup, then run make setup-flutter again.
make webRun the same validation used for contributions:
make checkLinux development and AppImage builds
Pomodoist pins Flutter 3.47.0 through FVM so Arch's rolling packages do not
silently change the project toolchain. Install
fvm from the AUR, then prepare and
run the native desktop app:
make setup-linux
make run-linuxTo build a local AppImage against the libraries on the current Arch system:
make linux-appimageThe AppImage and its SHA-256 sidecar are written to
build/linux/appimage/. Official cross-distribution release artifacts are
built by CI on the pinned Ubuntu 22.04 base. To instead install the raw
developer bundle for the current user (no root required):
make linux-installThis installs the app under $XDG_DATA_HOME/pomodoist (normally
~/.local/share/pomodoist), creates ~/.local/bin/pomodoist, and registers a
desktop launcher and the pomodoist:// URL scheme. Build dependencies are
checked with pacman; if any are missing, make setup-linux prints the exact
installation command.
Linux release bundles and AppImages read .env.linux, generated by
make setup-flutter from the single ignored .env.setup file:
make setup-flutter
make linux-appimageWindows development and installers
Open the latest GitHub release, download the single Pomodoist-Setup.exe
file, and run it. The installer works for the current user without
administrator access and starts Pomodoist automatically. It is unsigned, so
Microsoft Defender SmartScreen may warn that the publisher is unknown. Verify
the adjacent Pomodoist-Setup.exe.sha256 file if you want to confirm the
download.
Windows development requires Flutter 3.47.0, Visual Studio with Desktop development with C++, and Windows SDK 10.0.19041.0 or newer. Building the EXE installer also requires GNU Make and Inno Setup 6.4 or newer.
flutter pub get
powershell.exe -NoProfile -ExecutionPolicy Bypass `
-File .\tool\windows\run.ps1Run make setup-flutter once, fill the generated .env.setup, and run it
again. It creates the ignored .env.windows used by Windows builds:
make setup-flutter
make windows-installerThe command builds a clean production Release and creates
build/windows/installer/Pomodoist-Setup.exe plus its SHA-256 file.
The installer target always performs a clean build so CMake does not reuse a
generator from a previous Visual Studio installation. A vX.Y.Z tag publishes
the unsigned Windows installer and Linux AppImage in one GitHub release. Manual
Windows workflow runs remain separate pre-releases.
Both desktop build paths validate the production configuration before compiling and reject Cloudflare test keys and privileged Supabase keys.
Develop the shared client packages locally
The public account and voice packages are pinned to a release commit in
Kabanya/app-client-platform.
To develop both repositories together, create an ignored
pubspec_overrides.yaml:
dependency_overrides:
app_account:
path: ../app-client-platform/app_account
app_voice:
path: ../app-client-platform/app_voiceBug reports and focused pull requests are welcome. Open an
issue before starting a
substantial change, read the contribution guide, and run
make check before submitting a pull request.
Copyright © 2026 FinchForge LLC.
Pomodoist client source and official client binaries are licensed under the
GNU Affero General Public License v3.0 only (AGPL-3.0-only). See
the licensing model. Paid subscriptions cover hosted services
and account entitlements, not a proprietary client license. The name, logo,
and app icon follow the
trademark policy, and contributions require the
Contributor License Agreement.