Install¶

Pomorodo Desktop is an Electron app built on Vite + React + TypeScript. Pomorodo desktop allows users to either download through an installer or using Node.js and Git.

Download¶

Windows Installer¶

Windows (.exe)

MacOS Installer¶

macOS Apple Silicon (.dmg)

Manual Node.js and Git¶

Prerequisites¶

Node.js 18 or newer, with npm
Git

1. Clone the repository¶

git clone https://github.com/abbasjhanjhi010/pomorodo-desktop.git
cd pomorodo-desktop

2. Install dependencies¶

npm install

3. Run it¶

The web UI and the Electron shell are two separate scripts:

# Preview the UI in a regular browser tab, with hot reload
npm run dev

# Build the UI once, then launch it inside the Electron window
npm run build
npm run electron

The Electron window always loads the compiled app from dist/, so re-run npm run build after any change before re-launching npm run electron.

4. Lint (optional)¶

npm run lint

Building a distributable¶

There's no packaging script wired up yet (see the changelog for what's in progress). In the meantime, npm run build produces a dist/ folder you can load with npm run electron, or package yourself with a tool like electron-builder.

Note

This page describes the current build-from-source workflow. Once a packaged release exists, download links will be added here.