Skip to content

j46-txt/pomodorocycle

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

PomodoroCycle ⏱️🍅

PomodoroCycle is a free, ad-free, and open-source Pomodoro timer that works offline after the initial load. It’s designed for focused work, study, and productivity, with simplicity and usability in mind.

I originally built it for personal use, since I couldn’t find a free timer with the exact features I wanted. As the project grew, I added translations and decided to share it as a web app, in case it’s helpful to others too.

🧩 You can try it here: https://pomodorocycle.app


💡 Features

  • ⏱️ Customizable Pomodoro Cycles
    Configure focus, short break, and long break durations.

  • 📈 Statistics Dashboard
    Track your time focused, sessions completed, cycles done and daily streak.

  • 🎯 Daily Goals
    Set a daily goal and monitor your progress.

  • 🏆 Achievements System
    Unlock achievements as you accumulate time and hit daily goals.

  • 🌍 Available in 12 Languages
    English, Português (BR), Español, Français, Deutsch, Italiano, Русский, العربية, हिन्दी, 中文, 한국어, 日本語

  • 🔄 Data Export/Import
    Save your progress to a file and restore it on another device, all locally.

  • 🔔 Sound Notifications
    Toggle audio cues for session transitions.

  • 🍃 No Ads. No Accounts. No Cloud.
    100% local-first app. Your data stays in your browser.


🛠️ How It Works

The timer runs through a standard Pomodoro cycle automatically:

  1. Focus (25 min)
  2. Short break (5 min)
  3. Repeat 4x → Long break (15 min)
  4. New cycle starts manually

There’s a tracker that shows which focus session you’re in within the cycle. Each session and cycle is tracked and stored locally using your browser’s storage. No internet connection is required after the initial load.


📦 Tech Stack

  • HTML + Tailwind CSS
  • Vanilla JavaScript
  • Chart.js (Statistics)
  • Tone.js (Sound)
  • No framework or backend

🤝 Support & Contribute

Found a bug or have an idea? Feel free to open an issue or submit a pull request!

If you like this project, consider buying me a coffee ☕


Made with all my hate for studying.