https://github.com/parisa-singh/pomodoro-timer
A simple Pomodoro timer with start, pause, and reset functionality, built using HTML, CSS, and JavaScript.
https://github.com/parisa-singh/pomodoro-timer
Last synced: 9 months ago
JSON representation
A simple Pomodoro timer with start, pause, and reset functionality, built using HTML, CSS, and JavaScript.
- Host: GitHub
- URL: https://github.com/parisa-singh/pomodoro-timer
- Owner: parisa-singh
- License: mit
- Created: 2025-03-03T03:38:57.000Z (12 months ago)
- Default Branch: main
- Last Pushed: 2025-03-03T23:02:31.000Z (12 months ago)
- Last Synced: 2025-03-03T23:26:30.985Z (12 months ago)
- Language: JavaScript
- Homepage: https://parisa-singh.github.io/pomodoro-timer/
- Size: 498 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE.txt
Awesome Lists containing this project
README
# ⏳ Pomodoro Timer
A **modern and aesthetic Pomodoro Timer** built using **HTML, CSS, and JavaScript**. It helps users manage work and break intervals efficiently with **custom session durations, progress tracking, and dark mode**.
---
## 🎯 Features
✅ **Start, Pause, Reset Timer**\
✅ **Custom Timer Duration** (User can set work session length)\
✅ **Short (5 min) & Long (15 min) Breaks**\
✅ **Session Counter** (Tracks completed Pomodoros)\
✅ **Progress Bar** (Visual representation of time left)\
✅ **Sound Alert** (Plays alarm when session ends)\
---
## 🛠️ Technologies Used
- **HTML** → Structure
- **CSS** → Styling and animations
- **JavaScript** → Functionality and timer logic
---
## 📺 Installation
1. **Clone the repository**
```sh
git clone https://github.com/your-username/pomodoro-timer.git
```
2. **Navigate to the project folder**
```sh
cd pomodoro-timer
```
3. **Open **``** in your browser**
- Double-click the file
- OR use **Live Server** if you're using VS Code
---
## 🚀 Usage
1. **Start the timer** by clicking the `Start` button.
2. **Pause** the countdown with the `Pause` button.
3. **Reset** to restart the session.
4. Use the **Short Break (5 min)** or **Long Break (15 min)** buttons after completing a session.
5. Set a **custom time** using the input box before starting.
---
## 🤝 Contributing
Contributions are welcome! If you’d like to improve the project:
1. **Fork** the repo
2. **Create a new branch**
3. **Commit your changes**
4. **Push to your branch**
5. Open a **Pull Request**
---
## 🐜 License
This project is licensed under the **MIT License**.
---
## 📩 Contact
💬 Have questions or suggestions? Reach out via:\
📧 Email: [parisasingh@gmail.com](mailto\:parisasingh@gmail.com)\
🔗 GitHub: [@parisa-singh](https://github.com/parisa-singh)\
🔗 LinkedIn: [@parisa-singh](https://www.linkedin.com/in/parisa-singh/)
---
🚀 **Happy Productivity!** ⏳✨