A simple Pomodoro timer. Drag and pin the timer on your desktop anywhere you want.

You can use it now on ketchuptimer.com.

• Work & Break Phases - Default 25-minute work sessions and 5-minute breaks
• Picture-in-Picture Mode - Pin the timer anywhere on your desktop
• Customizable Settings - Adjust durations and colors to your preference
• Drift-Resistant Timer - Accurate timing even when the tab is backgrounded
• Keyboard Shortcuts - Quick access to all controls
• Local Persistence - Settings saved to localStorage
• No Login Required - Runs entirely in the browser

• Node.js 18+ and npm

# Clone the repository
git clone https://github.com/julianyaman/ketchup.git
cd ketchup

# Install dependencies
npm install

# Start development server
npm run dev

# Open http://localhost:5173 in your browser

# Build for production
npm run build

# Preview the production build
npm run preview

# Run tests
npm test

# Run tests in watch mode
npm run test:watch

npm run check

Build and run with Docker:

# Build the image
docker build -t pomodoro-timer .

# Run the container
docker run -p 3000:3000 pomodoro-timer

The app will be available at http://localhost:3000.

version: '3.8'
services:
  pomodoro:
    build: .
    ports:
      - "3000:3000"
    restart: unless-stopped

• Chrome/Edge 79+
• Firefox 69+
• Safari 13.1+

Note: Picture-in-Picture support varies by browser. The feature is automatically disabled with a tooltip message in unsupported browsers.

The Picture-in-Picture implementation using canvas-to-video streaming is inspired by Kaiido's StackOverflow answer (Retrieved 2026-02-05, License: CC BY-SA 4.0).

The icon background was generated using Nano Banana by Google.

Contributions are welcome! Please feel free to submit issues and pull requests.

1. Fork the repository
2. Create your feature branch (git checkout -b feature/amazing-feature)
3. Commit your changes (git commit -m 'Add some amazing feature')
4. Push to the branch (git push origin feature/amazing-feature)
5. Open a Pull Request

This project is licensed under the MIT License - see the LICENSE file for details.