GitHunt
CA

caballeto/podoro-app

Pomodoro Timer

A sleek and modern Pomodoro Timer application built with Next.js, React, and Tailwind CSS. This application helps you stay focused and productive using the Pomodoro Technique.

Features

  • Work/Break Timers: Automatically switch between work sessions and breaks
  • Customizable Settings: Adjust work duration, short break, long break, and interval settings
  • Visual Progress: Track your progress with a visual progress bar
  • Browser Notifications: Get notified when a session ends
  • Session Tracking: Keep track of completed sessions
  • Responsive Design: Works on desktop and mobile devices

Getting Started

First, run the development server:

npm run dev
# or
yarn dev
# or
pnpm dev
# or
bun dev

Open http://localhost:3000 with your browser to see the Pomodoro Timer.

How to Use

  1. Open the Application: Navigate to http://localhost:3000 in your browser
  2. Start the Timer: Click the play button to start the timer
  3. Pause/Resume: Click the play/pause button to pause or resume the timer
  4. Reset: Click the reset button to reset the current timer
  5. Adjust Settings: Click the settings icon to customize timer durations:
    • Work Duration: Length of work sessions (default: 25 minutes)
    • Short Break: Length of short breaks (default: 5 minutes)
    • Long Break: Length of long breaks (default: 15 minutes)
    • Long Break Interval: Number of work sessions before a long break (default: 4)

The Pomodoro Technique

The Pomodoro Technique is a time management method developed by Francesco Cirillo in the late 1980s. The technique uses a timer to break down work into intervals, traditionally 25 minutes in length, separated by short breaks. Each interval is known as a "pomodoro", from the Italian word for tomato, after the tomato-shaped kitchen timer that Cirillo used as a university student.

The basic steps are:

  1. Decide on the task to be done
  2. Set the timer (traditionally to 25 minutes)
  3. Work on the task until the timer rings
  4. Take a short break (5 minutes)
  5. After four pomodoros, take a longer break (15-30 minutes)

Technologies Used

  • Next.js - React framework
  • React - JavaScript library for building user interfaces
  • Tailwind CSS - Utility-first CSS framework
  • shadcn/ui - UI components built with Radix UI and Tailwind CSS

Contributors

Created June 23, 2025
Updated June 23, 2025