PomodoroFlow

A modern, feature-rich Pomodoro timer application built with Next.js and Tailwind CSS to help you boost productivity and manage your work sessions effectively.

Features

• Customizable Timer

  • 25-minute Pomodoro sessions (customizable)
  • 5-minute short breaks
  • 15-minute long breaks
  • Configurable intervals and durations

• Task Management

  • Add, complete, and delete tasks
  • Track Pomodoros per task
  • Mark active tasks for current session
  • Clear completed tasks

• Statistics

  • Daily and weekly Pomodoro tracking
  • Visual progress indicators
  • Session completion stats

• User Experience

  • Desktop notifications
  • Audio alerts
  • Dark/light theme support
  • Responsive design
  • Progress visualization
  • Auto-start options for breaks and sessions

Getting Started

1. Clone the repository
2. Install dependencies:

   npm install

3. Start the development server:

   npm run dev

4. Open http://localhost:3000 in your browser

Usage

Timer Controls

• Click "Start" to begin a Pomodoro session
• Use "Pause" to temporarily stop the timer
• "Reset" returns the timer to its initial state
• Switch between Pomodoro, short break, and long break modes using the tabs

Task Management

1. Add tasks using the input field
2. Click the circle icon to set a task as active
3. Check the checkbox to mark tasks as complete
4. Use the trash icon to delete tasks
5. Clear all completed tasks with the "Clear" button

Settings

Access the settings panel to customize:

• Pomodoro duration
• Short break duration
• Long break duration
• Long break interval
• Auto-start preferences
• Enable desktop notifications

Tech Stack

• Next.js
• Tailwind CSS
• shadcn/ui components
• Recharts for statistics
• Local storage for data persistence

Browser Support

The application works best in modern browsers and requires:

• Desktop notification support
• Local storage
• Modern CSS features