/pomodoro-timer

a simple and minimalistic timer designed to help students focus and be more productive

Primary LanguageHTMLMIT LicenseMIT

Pomodoro Timer

This Pomodoro Timer project was originally developed for TechWithTim's hackathon (placed top 10 🎉) . It is my first JavaScript project, inspired by the need to rest my eyes after working for extended periods. The timer is designed to enhance productivity for students while studying.

Features

  • Customizable work and break durations
  • Audible alerts to notify session changes
  • Robust, User-friendly interface

Technologies Used

  • JavaScript
  • HTML
  • CSS

Installation

To use the Pomodoro Timer, simply clone this repository. No additional dependencies or package managers are required.

git clone https://github.com/sidsurakanti/pomodoro-timer.git

Usage

  1. Visit the website.
  2. Modify the durations for breaks and work sessions according to your preferences in the settings tab.
  3. Click the "Start" button to begin the timer.
  4. During the work session, focus on your tasks until the timer elapses.
  5. When the timer switches to the break session, take a short break and relax.
  6. Repeat the work and break sessions as necessary.

Contributing

Contributions are welcome! If you would like to improve this project or fix any issues, please follow these steps:

  1. Fork the repository.
  2. Create a new branch for your feature or bug fix.
  3. Make your changes and commit them.
  4. Push your changes to your forked repository.
  5. Submit a pull request detailing your changes.

License

This project is licensed under the MIT License. Feel free to modify and distribute the code as needed.

Acknowledgments

  • @techwithtim for hosting the hackathon that inspired this project.
  • The Pomodoro Technique for providing the time management concept.